Getting Started

Quickstart

Get an agent running in under five minutes.

1. Initialize a project

vesper init

2. Write a manifest

Create an agent.yml file:

apiVersion: vesper/v1
kind: Agent

name: researcher
model: gpt-4o-mini
entryPoint: examples/agent.py

tools:
  - web_search
  - get_stock_price

memory:
  scope: project
  retentionDays: 30

budget:
  maxCostPerRun: 0.05
  alertAt: 0.04

3. Apply the manifest

vesper apply -f agent.yml
# researcher v1 applied

4. Run the agent

vesper run researcher --input "What is the price of AAPL?"
# AAPL is trading at $187.42.
# cost $0.000041 · 146 in / 32 out · session sess_a91f...

That's your first agent, applied and running. Next, see the Manifest reference for every field, or the SDK reference to run it from Python.