Common questions.

Straight answers about Odigos -- what it is, how it works, what it costs, and how to install it.

What is Odigos?

A self-hosted personal AI agent with persistent memory, self-improving behavior, and autonomous sub-agents. You deploy it on your own hardware (Docker or bare-metal Python 3.12+) and connect any OpenAI-compatible LLM provider. Your data stays on your machine -- no cloud dependency, no shared backend.

How is it different from other AI assistants?

  • Your data, your hardware. Single SQLite file, no cloud sync.
  • Real memory. Nine memory types, an entity graph with multi-hop traversal, and compiled "brain" pages in plain markdown you can browse in Obsidian.
  • Sub-agents. The main agent dispatches researcher, coder, editor, analyst, presenter, and brain-compiler personas for heavy work. Async -- the main agent responds immediately while results deliver via notification.
  • Self-improves. An evolution engine runs classification, trials, and prompt/skill updates over time. Your corrections become behavioral rules.
  • BYOK multi-provider routing. Dashboard UI to add providers (OpenRouter, OpenAI, Groq, Anthropic, Ollama, LM Studio). Intelligence tiers auto-route by query complexity.
  • 50+ tools. Web search, code execution, file I/O, image and music generation, slide rendering, email/calendar (BYO IMAP/CalDAV), kanban, notebooks, MCP bridge, Telegram.

How much does it cost?

Self-hosted is always free -- MIT license, one bash install.sh away.

Managed hosting is $15/month: LLM included, all features enabled, isolated container, zero setup. See full pricing.

Additional tiers -- Pro and BYOK -- are in development.

What's it built on?

Python 3.12 with FastAPI and aiosqlite on the backend; React 19 + Vite + Tailwind + shadcn/ui on the frontend. sqlite-vec for vector search, FTS5 for keyword search, cross-encoder reranking on top. One process, one SQLite database, no microservices.

How do I install it?

Two paths:

  • Docker (recommended): git clone https://github.com/tamler/odigos && cd odigos && bash install.sh
  • Bare-metal (systemd or macOS, no Docker): bash install-bare.sh

Sanity-check the install with bash tests/e2e/test-cards-e2e.sh. Typical hardware: 1 CPU and 1 GB RAM per agent -- a $40/month VPS comfortably hosts 30 to 50 agents side-by-side.

Is my data private?

Yes. Self-hosted users have full control -- your agent's memory, database, and API traffic never leave your hardware. On managed hosting, each agent runs in its own isolated container with its own database. See the Privacy Policy for details.

What happens if I cancel managed hosting?

Your data is yours. Export your knowledge graph anytime. Your agent stops running at the end of the billing period; data is retained for 30 days for recovery, then deleted.

Can I switch from self-hosted to managed (or back)?

Yes. Bring your data with you in either direction.

I have a specific question -- billing, account, security, or a feature request.

For billing or account issues, reach us via the contact form. For code-related questions, feature requests, or bug reports, open an issue on the GitHub repository.