ontheia
Health Warn
- License — License: AGPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Self-hosted AI agent platform — multi-provider, MCP-native, GDPR by Design.
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
- Automation — time-based and agent-driven scheduling; one-time and recurring jobs with chat continuation
- Agent Skills — reusable capability modules compatible with the open agentskills.io standard (Claude Code, Cursor, GitHub Copilot, and more), including a built-in skill-creator that builds and tests new skills directly in chat
Screenshots
| Chat & Agents | MCP Tools in Action |
|---|---|
![]() |
![]() |
| What can I use Ontheia for? | Exa search → PDF summary → email — in one step. |
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) — one command, configures everything interactively:
curl -fsSL https://raw.githubusercontent.com/Ontheia/ontheia/main/scripts/install.sh | bash
This downloads Ontheia to ~/ontheia and runs the installer, which handles .env creation, secret generation, Docker builds, database migrations, and bootstraps the first admin account.
Prefer to inspect the script first? Clone and run it from the repository:
git clone https://github.com/Ontheia/ontheia.git
cd ontheia
bash scripts/install.sh
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
Open Ontheia
Visit http://localhost:5173 in your browser.
Full installation guide: docs.ontheia.ai/en/getting-started/02_installation
Documentation
Full documentation at docs.ontheia.ai
| Topic | EN | DE |
|---|---|---|
| Introduction | EN | DE |
| Installation | EN | DE |
| Environment variables | EN | DE |
| Agents | EN | DE |
| Agent Skills | EN | DE |
| Chain Engine | EN | DE |
| Memory / RAG | EN | DE |
| Security | EN | DE |
| Automation | 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.
- Fork the repository
- Create a feature branch
- Submit a pull request
Please read CONTRIBUTING.md before opening a pull request.
License
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.
Contact
- Website: ontheia.ai
- GitHub Discussions: github.com/Ontheia/ontheia/discussions
© 2026 Ontheia. All rights reserved.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found

