Ontheia

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

---

Why Ontheia?

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

---

Screenshots

Chat & Agents	MCP Tools in Action

---

Requirements

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.

---

Quick Start

Guided setup (recommended) — configures everything interactively:

git clone https://github.com/Ontheia/ontheia.git
cd ontheia
bash scripts/install.sh

The 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 -d

Full installation guide: docs.ontheia.ai/en/getting-started/installation

---

Documentation

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

---

Stack

• 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)

---

Roadmap

See ROADMAP.md for planned features across all horizons.

Community input is welcome — open an issue or start a discussion.

---

Contributing

Contributions are welcome.

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

Please read CONTRIBUTING.md before opening a pull request.

---

License

Ontheia is dual-licensed:

1. Open Source: GNU Affero General Public License v3.0 — free for personal use, self-hosted deployments, and open-source projects.
2. 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.

---

Contact

• Website: ontheia.ai
• GitHub Discussions: github.com/Ontheia/ontheia/discussions

---

© 2026 Ontheia. All rights reserved.