Skip to content
Wheelhouse Wheelhouse

Deploy your first agent

This guide walks through deploying a complete agent setup with a Telegram surface.

Prerequisites

Section titled “Prerequisites”
  • Wheelhouse installed (Installation)
  • Podman running
  • Claude API key
  • Telegram bot token

Step 1 — Initialize secrets

Section titled “Step 1 — Initialize secrets”
Terminal window
wh secrets init

Follow the prompts to store your Claude API key and Telegram bot token securely.

Step 2 — Create your topology

Section titled “Step 2 — Create your topology”

my-first-agent.wh:

api_version: wheelhouse.dev/v1
name: my-first-agent


streams:
  - name: main
    retention: "30d"


agents:
  - name: donna
    image: ghcr.io/wheelhouse-paris/agent-claude:latest
    streams: [main]


guardrails:
  max_replicas: 2

Step 3 — Plan and apply

Section titled “Step 3 — Plan and apply”
Terminal window
wh deploy plan my-first-agent.wh

Review the plan, then apply:

Terminal window
wh deploy apply my-first-agent.wh

Step 4 — Verify

Section titled “Step 4 — Verify”
Terminal window
wh ps
NAME    STATUS   PROVIDER   STREAM   REPLICAS   LAST_COMMIT
donna   running  podman     main     1/1        init

Send a message to your Telegram bot. Your agent responds.

Step 5 — Watch the stream

Section titled “Step 5 — Watch the stream”
Terminal window
wh stream tail main

You’ll see the objects flowing in real time as you interact with the agent.