Your Data. Your AI. Your Rules.
Ontheia is a self-hosted, open-source AI agent platform. Run AI agents, automate workflows, and connect AI models to any tool — entirely on your own infrastructure, without sending data to external cloud services.
→ ontheia.ai · Documentation · Blog
Every time you send a company document to a cloud AI, your data leaves your building. Ontheia keeps AI powerful — and keeps your data yours.
- GDPR-compliant by architecture — data never leaves your servers
- Vendor-agnostic — Claude, ChatGPT, Gemini, Grok, Ollama, or any OpenAI-compatible model
- MCP-native — connect agents to any external tool or service via open standard
- Multi-user — role-based access control, Row Level Security enforced at the database level
- Chain Engine — visual workflow automation, no code required
- Long-term Memory — built-in RAG with pgvector, isolated per user and namespace
- Agent-to-Agent — complex tasks coordinated across specialized sub-agents
- Cron Automation — schedule agent runs and chain executions on a time-based trigger
| Chat & Agents | MCP Tools in Action |
|---|---|
 |
 |
| Requirement | Minimum | Notes |
|---|---|---|
| OS | Linux / macOS | Windows via WSL2 |
| Docker | 24+ | Rootless mode recommended |
| Docker Compose | v2 (plugin) | docker compose (not docker-compose) |
| RAM | 2 GB | 4 GB recommended |
| Disk | 5 GB free | 10 GB recommended |
| Ports | 8080, 5173 | Configurable during setup |
| openssl | any | For secret generation (apt install openssl) |
| curl | any | For health checks |
| jq | any | For JSON parsing (apt install jq) |
At least one AI provider API key is required to chat (e.g. Anthropic, OpenAI, or a local Ollama instance). Memory/RAG features additionally require an embedding-capable provider.
Guided setup (recommended) — configures everything interactively:
git clone https://github.com/Ontheia/ontheia.git
cd ontheia
bash scripts/install.shThe install script handles .env creation, secret generation, Docker builds, database migrations, and bootstraps the first admin account.
Manual setup:
git clone https://github.com/Ontheia/ontheia.git
cd ontheia
cp .env.example .env
# Edit .env — set FLYWAY_PASSWORD, ONTHEIA_APP_PASSWORD, SESSION_SECRET, ADMIN_EMAIL
docker compose up -dFull installation guide: docs.ontheia.ai/en/getting-started/installation
Full documentation at docs.ontheia.ai
| Topic | EN | DE |
|---|---|---|
| Introduction | EN | DE |
| Installation | EN | DE |
| Environment variables | EN | DE |
| Agents | EN | DE |
| Chain Engine | EN | DE |
| Memory / RAG | EN | DE |
| Security | EN | DE |
| API Reference | EN | DE |
- Backend: Node.js / TypeScript (Fastify)
- Frontend: React, shadcn/ui, Tailwind CSS
- Database: PostgreSQL with pgvector extension
- Containerization: Docker, Docker Compose (rootless)
- AI Protocols: Anthropic Messages API, OpenAI-compatible API, MCP (Model Context Protocol)
See ROADMAP.md for planned features across all horizons.
Community input is welcome — open an issue or start a discussion.
Contributions are welcome.
- Fork the repository
- Create a feature branch
- Submit a pull request
Please read CONTRIBUTING.md before opening a pull request.
Ontheia is dual-licensed:
- Open Source: GNU Affero General Public License v3.0 — free for personal use, self-hosted deployments, and open-source projects.
- Commercial: Commercial License — for organizations that need to use Ontheia without AGPL obligations (e.g. as part of a proprietary product or managed service). Contact us via ontheia.ai for inquiries.
- Website: ontheia.ai
- GitHub Discussions: github.com/Ontheia/ontheia/discussions
© 2026 Ontheia. All rights reserved.
