Quickstart

Deploy your first AI agent in under 5 minutes.

# 1. Install the CLI

▓ shell

npm install -g @parel/cli

# 2. Configure

Set your API server and key. Get your key from the Console.

▓ shell

parel config set --server https://api.parel.sh --key pk_your_api_key

# 3. Create agent.yaml

This is the only file you need. It declares your agent's model, tools, memory, and budget.

▓ agent.yaml

version: "1"
agent:
  name: my-first-agent
  model: "anthropic:claude-sonnet-4-20250514"
  system: "You are a helpful research assistant."
plugins:
  - sandbox-e2b
  - memory-rolling-summary
  - budget-cap:
      daily: 10
runtime:
  maxSteps: 100

# 4. Deploy

▓ shell

parel deploy agent.yaml
# ✓ Deployed: my-first-agent (agent_a1b2c3d4)
#   https://api.parel.sh/agents/agent_a1b2c3d4

# 5. Chat

▓ shell

# Create a session
parel sessions create agent_a1b2c3d4
# ✓ Session: abc123def456 (running)

# Send a message
parel chat --session abc123def456 "What's trending on Hacker News?"

# View logs
parel logs abc123def456

# 6. Monitor

Open parel.sh/console to see your agent's sessions, costs, and live traces.

Next: Read Concepts to understand how the kernel, plugins, and sessions work together.