ontheia

mcp
Security Audit
Warn
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.

SUMMARY

Self-hosted AI agent platform — multi-provider, MCP-native, GDPR by Design.

README.md

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

License: AGPL v3
License: Commercial
Self-hosted
Docker
TypeScript
PostgreSQL


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
Chat MCP
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.

  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


© 2026 Ontheia. All rights reserved.

Reviews (0)

No results found