Skip to content
View Ontheia's full-sized avatar

Block or report Ontheia

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ontheia/README.md

Ontheia

Your Data. Your AI. Your Rules.

Every time AI work runs on someone else's infrastructure, you give up more than privacy. You give up control over data, tools, workflows, and the rules that govern how work gets done.

Ontheia is a self-hosted, open-source AI agent platform for work that stays under your control. It keeps AI capable and connected — within boundaries you set.

Most AI setups stay fragmented: separate chats, tools, scripts, and automations with no shared memory, no continuity, and no operational boundaries. Ontheia brings specialized agents, tools, memory, scheduling, and delegation into one governed work context — on your own infrastructure.

ontheia.ai · Documentation · Blog

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


More than the sum of its parts

No single feature is the point. The shift comes from combining them.

An agent in Ontheia can break a request into subtasks and hand them to other specialized agents — each with its own tools, memory, and skills. They coordinate, remember across sessions, and act on their own schedule. A fresh install ships with two agents to start from: the Ontheia Guide walks you through setup, and a Personal Assistant is ready to work.

This isn't a chat UI with plugins, prompt-based automation, or a bare agent runtime — it's an operational layer for sovereign AI work: agents that use your tools, retain context, coordinate capabilities, and operate over time, all inside one system you control.


What's inside

  • Specialized capabilities — use agents and Agent Skills instead of one generic assistant. Skills are reusable modules based on the open Agent Skills standard, and the built-in skill-creator can build and test new ones directly in chat.
  • Delegation & coordination — hand work off across specialists with the delegate-to-agent tool, either autonomously or as declarative Chain steps.
  • Tools & external systems — Ontheia is MCP-native, so agents can connect to tools and services over an open standard instead of proprietary integrations.
  • Persistent memory — built-in RAG with pgvector, isolated by user and namespace, so agents can remember and reuse knowledge over time.
  • Workflows — the visual Chain Engine turns multi-step logic into no-code pipelines.
  • Scheduling — run recurring or one-time jobs automatically, including jobs that resume an existing chat where it left off.
  • Vendor-agnostic — Claude, ChatGPT, Gemini, Grok, Ollama, or any OpenAI-compatible model. Switch providers without rewriting agents.
  • Governance & control — self-hosted and GDPR-compliant by architecture — data never leaves your servers. Role-based access enforced with PostgreSQL Row Level Security; you decide per agent which model can access which data.

How it works

flowchart TB
    subgraph infra["🔒 Your Infrastructure"]
        UI[WebUI / Chat] --> A1[Agent]
        A1 --- SK[Skills]
        A1 --- MEM[Memory / RAG]
        MEM --- DB[(PostgreSQL + pgvector)]
        A1 -->|delegate-to-agent| A2[Sub-Agent]
        A1 --> CE[Chain Engine]
        A1 --> SCH[Scheduler]
        A1 --> TOOLS[MCP Tools / External Systems]
        A1 --> OLLAMA[Ollama<br/>local models]
    end
    A1 -.-> PROV[Cloud AI Providers<br/>Claude · GPT · Gemini · Grok]

    classDef external fill:#fff3cd,stroke:#d4a017,stroke-width:1px,color:#5c4400,font-weight:bold;
    class PROV external;
Loading

Everything that matters — chat history, memory, skills, workflows, schedules, tool connections — stays inside your infrastructure. Only the model inference call crosses the boundary, and you choose which provider gets it.


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://get.ontheia.ai | 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.

If Ontheia resonates with you, a ⭐ helps others find it — and helps us build a community around sovereign AI.


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 · Open source under AGPL-3.0.

Popular repositories Loading

  1. ontheia ontheia Public

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

    TypeScript 6

  2. awesome-mcp-clients awesome-mcp-clients Public

    Forked from punkpeye/awesome-mcp-clients

    A collection of MCP clients.

  3. Awesome-MCP-Servers Awesome-MCP-Servers Public

    Forked from YuzeHao2023/Awesome-MCP-Servers

    A curated list of Model Context Protocol (MCP) servers

  4. awesome-ai-agents-2026 awesome-ai-agents-2026 Public

    Forked from caramaschiHG/awesome-ai-agents-2026

    🤖 The most comprehensive list of AI agents, frameworks & tools in 2026. 300+ resources · 20+ categories · Updated monthly.

  5. awesome-ai-agents-2 awesome-ai-agents-2 Public

    Forked from e2b-dev/awesome-ai-agents

    A list of AI autonomous agents

  6. awesome-local-ai awesome-local-ai Public

    Forked from janhq/awesome-local-ai

    An awesome repository of local AI tools