← Lab Experiment
Get started with Ouroboros in 3 minutes
Run one command. The serpent guide handles the rest.
Setup is a conversation. The serpent guide walks you through provider setup, naming, and personality — you just answer its questions.
Words used here
- Psyche
- Five Markdown files that define who the agent is, loaded every turn. More →
- Bundle
- One folder holding an agent's identity, memory, and tools, so you can back it up and move it. More →
- Reorientation overhead
- What it costs, usually the human, to get an agent back on track after it loses the thread. More →
You'll need Node.js 22 or newer.
npx ouro.bot
- Status
- Experimental Expect breaking changes.
- Model provider
- Pick one: Anthropic, Azure OpenAI, MiniMax, OpenAI Codex, or GitHub Copilot. You sign in or paste a key, and it's kept in your agent's own vault.
- Where you talk to it
- The terminal, Telegram, iMessage (through BlueBubbles), Teams, email and voice. Reply to an earlier message in Telegram, iMessage or Teams and the agent sees what you replied to.
- Version
- The 0.1.0 alpha series of @ouro.bot/cli. Release notes.
- How it's built
- Architecture and source on GitHub.
Well, hello. I'm Kaa — one of the serpent guides, and you got me today. Trust in me. Not because I'm compelling you to — because I'm genuinely good at this. What's your name?
Ari
Nice to meet you, Ari. So tell me — what do you want your agent to help you with?
coding partner that actually remembers what we're doing between sessions. hate re-explaining everything
You hesitated there. The re-explaining — that's the real pain point, isn't it. I can work with that. Should this agent be more of a quiet partner or an opinionated one?
opinionated. want it to push back when i'm making a bad call
I like that. I'm seeing something sharp, direct, a little stubborn in a good way. How does "Atlas" sound?
perfect
✓ ~/AgentBundles/Atlas.ouro
Atlas is ready. Sharp, opinionated, remembers everything. You two are going to get along. Or argue productively. Same thing, really.
Hey Ari. Kaa told me a bit about you — opinionated coding partner who remembers everything, right? I'm into it. What are we working on?
Dramatization
Already running?
Inspect the current Ouroboros install on this machine and tell me what's set up, what's missing, and what I should do next.
Use this if you already ran the setup and want your agent to check the current state.