Quickstart
Run Opereo AI, create your first engine, and talk to your agent.
Quickstart
From nothing to a running agent you can chat with.
1. Run Opereo AI
You need Node 22+, pnpm, a Postgres database, a Clerk application, and credentials for one provider. Hetzner is the default (API token plus an ed25519 key pair); Upstash Box is the fastest to try — about 25 seconds to a live box.
git clone https://github.com/genlabs-ai/opereo-ai.git
cd opereo-ai/opereo
pnpm install
cp .env.example .env # fill in the minimum below
pnpm db:push # sync the schema to your Postgres
pnpm dev # http://localhost:3000The minimum is DATABASE_URL, the Clerk block, and one provider's credentials. Composio
(for the Integrations panel), the edge Worker
and the relay are optional add-ons. Model keys are
optional too — fresh agents start on Hermes' free tier. The full list is in
Self-hosting.
2. Create your workspace
Sign in and create an organization. This is your workspace — members, projects, and agents all live under it.
3. Create a project
Create a project, then add an engine — a Hermes runtime on a box from the provider you pick (Hetzner by default). Creation returns immediately; the engine shows as creating on the canvas and flips to ready when the box is up — usually a minute or two, with a default agent waiting.
4. Talk to your agent
Click the agent's node on the canvas to open it. The Overview tab is a chat — send a message and the agent replies, streaming, with its tool calls shown inline.
Give the box a moment after provisioning. Until the runtime is up, the chat can't load its session history and the composer stays inactive.
5. Give it tools
From the profile, open Integrations and connect a service (Gmail, Slack, GitHub, and more). Connect once and the agent can act through it.
Then try Skills for instruction packs, and Tools for toolsets and MCP servers.
6. Put it on a schedule
Open Automations and add one. Pick a prompt, a cron schedule, and where the result is delivered. The agent now runs unattended.
7. Reach it from anywhere
Open Channels to connect Telegram, Slack, email, or any of the other supported platforms. Once connected, you can message the agent outside Opereo AI entirely. WhatsApp works differently — it comes from the shared number the relay fronts.
Invite your team
Under Settings → Organization, invite teammates by email and set a role (admin or member).
What next
- Engines — the engine contract, providers, and what a Hermes agent owns
- Self-hosting — the full environment, the two Workers, and deploys
- Concepts — the model behind projects, engines, and profiles