Ontheia (MCP-Client)

Ontheia — a plataforma de agentes de IA auto-hospedada

Seus Dados. Sua IA. Suas Regras.

Toda vez que o trabalho de IA é executado na infraestrutura de outra pessoa, você abre mão de mais do que privacidade. Você abre mão do controle sobre dados, ferramentas, fluxos de trabalho e as regras que governam como o trabalho é feito.

Ontheia devolve tudo isso. É open source e mantém a IA capaz e conectada — dentro dos limites que você define.

A maioria das configurações de IA permanece fragmentada: chats, ferramentas, scripts e automações separados, sem memória compartilhada, sem continuidade e sem limites operacionais. A Ontheia reúne agentes especializados, ferramentas, memória, agendamento e delegação em um único contexto de trabalho governado — na sua própria infraestrutura.

→ ontheia.ai · Documentação · Blog

---

Mais do que a soma das partes

Nenhum recurso isolado é o ponto central. A mudança vem da combinação deles.

Um agente na Ontheia pode dividir uma solicitação em subtarefas e entregá-las a outros agentes especializados — cada um com suas próprias ferramentas, memória e habilidades. Eles coordenam, lembram entre sessões e agem em sua própria programação. Uma instalação nova já vem com dois agentes para começar: o Ontheia Guide orienta você na configuração, e um Personal Assistant está pronto para trabalhar.

Isso não é uma interface de chat com plugins, automação baseada em prompts ou um runtime de agente básico — é uma camada operacional para trabalho de IA soberano: agentes que usam suas ferramentas, retêm contexto, coordenam capacidades e operam ao longo do tempo, tudo dentro de um sistema que você controla.

---

O que está incluído

• Capacidades especializadas — use agentes e Agent Skills em vez de um assistente genérico. Skills são módulos reutilizáveis baseados no padrão aberto Agent Skills, e o skill-creator integrado pode criar e testar novas skills diretamente no chat.
• Delegação e coordenação — repasse o trabalho entre especialistas com a ferramenta delegate-to-agent, de forma autônoma ou como etapas declarativas de Chain.
• Ferramentas e sistemas externos — a Ontheia é nativa em MCP, então os agentes podem se conectar a ferramentas e serviços por um padrão aberto, em vez de integrações proprietárias.
• Memória persistente que você pode governar — RAG integrado com pgvector, isolado por usuário e namespace. As entradas são classificadas pelo tipo de memória: episódica, semântica, procedural, de trabalho, documento. É isso que torna a memória governável, e não apenas pesquisável.
• Fluxos de trabalho — o Chain Engine visual transforma lógica de múltiplas etapas em pipelines sem código.
• Diagramas no chat — o agente escreve Mermaid, e o chat renderiza ao vivo: fluxogramas, sequência, classes, ER, Gantt, estado, mapas mentais e mais (12+ tipos). Sem servidor de renderização, sem desvio de exportação — uma skill integrada mantém a sintaxe e o layout limpos.
• Arquivos como artefatos, não paredes de texto — quando um agente lê ou escreve um arquivo, um card aparece; um clique o abre em um painel lateral com edição/visualização, salvamento seguro contra conflitos e um visualizador de PDF integrado. Todo bloco de código em uma resposta traz um lápis: revise-o no painel e salve como arquivo. O agente para de repetir o conteúdo dos arquivos nas respostas e cita apenas o que discute — o que também economiza uma quantidade significativa de tokens.
• Agendamento — execute trabalhos recorrentes ou únicos automaticamente, incluindo trabalhos que retomam um chat existente de onde parou.
• Independente de fornecedor — Claude, ChatGPT, Gemini, Grok, Ollama ou qualquer modelo compatível com OpenAI. Troque de provedor sem reescrever agentes.
• Modelos de raciocínio, tornados visíveis — a Ontheia fala ambos os caminhos de raciocínio: a API Responses da OpenAI, para que raciocínio e ferramentas funcionem juntos onde chat completions não permite mais, e o extended thinking da Anthropic. O esforço é configurável por modelo, o pensamento sobrevive às iterações de ferramentas, e uma aba Reasoning dedicada no painel de rastreamento mostra o que o modelo realmente pensou — não apenas o que respondeu.
• Manipulação segura de arquivos — uma skill integrada files permite que agentes pesquisem, leiam, escrevam, editem e movam arquivos com garantias que tornam erros impossíveis, não apenas desencorajados: gravações nunca sobrescrevem (lixeira recuperável), edições exigem correspondência exata e alterações concorrentes são detectadas por hash de conteúdo. Sem configuração necessária.
• Governança e controle — auto-hospedado e em conformidade com a LGPD por arquitetura — os dados nunca saem dos seus servidores. Controle de acesso baseado em papéis aplicado com Row Level Security do PostgreSQL; você decide por agente qual modelo pode acessar quais dados. Em configurações multiusuário, o acesso a arquivos por usuário é aplicado no servidor — os agentes de um usuário não podem acessar os arquivos de outro.

---

Como funciona

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;

Tudo o que importa — histórico de chat, memória, skills, fluxos de trabalho, agendamentos, conexões de ferramentas — permanece dentro da sua infraestrutura. Apenas a chamada de inferência do modelo cruza a fronteira, e você escolhe qual provedor a recebe.

---

Capturas de tela

Para que posso usar a Ontheia?	Pesquisa Exa → resumo em PDF → e-mail — em uma única etapa.
Descreva um processo — a Ontheia o renderiza como fluxograma.	Transforme um briefing de projeto em um mapa mental estruturado.

---

Requisitos

Requisito	Mínimo	Observações
SO	Linux / macOS	Windows via WSL2
Docker	24+	Modo rootless recomendado
Docker Compose	v2 (plugin)	docker compose (não docker-compose)
RAM	2 GB	4 GB recomendado
Disco	5 GB livres	10 GB recomendado
Portas	8080, 5173	Configuráveis durante a instalação
openssl	qualquer	Para geração de segredos (apt install openssl)
curl	qualquer	Para verificações de saúde
jq	qualquer	Para análise de JSON (apt install jq)

É necessária pelo menos uma chave de API de provedor de IA para conversar (por exemplo, Anthropic, OpenAI ou uma instância local de Ollama). Os recursos de memória/RAG exigem adicionalmente um provedor com capacidade de embeddings.

---

Início rápido

Configuração guiada (recomendada) — um comando, configura tudo interativamente:

curl -fsSL https://get.ontheia.ai | bash

Isso baixa a Ontheia para ~/ontheia e executa o instalador, que cuida da criação de .env, geração de segredos, builds Docker, migrações de banco de dados e inicializa a primeira conta de administrador.

Prefere inspecionar o script primeiro? Clone e execute-o a partir do repositório:

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

Configuração manual:

git clone https://github.com/Ontheia/ontheia.git
cd ontheia
cp .env.example .env
# Edit .env — set FLYWAY_PASSWORD, ONTHEIA_APP_PASSWORD, ADMIN_EMAIL
docker compose up -d

Abra a Ontheia

Visite http://localhost:5173 no seu navegador.

Guia de instalação completo: docs.ontheia.ai/en/getting-started/02_installation

---

Documentação

Documentação completa em docs.ontheia.ai

Tópico	EN	DE
Introdução	EN	DE
Instalação	EN	DE
Variáveis de ambiente	EN	DE
Agentes	EN	DE
Agent Skills	EN	DE
Chain Engine	EN	DE
Memória / RAG	EN	DE
Segurança	EN	DE
Automação	EN	DE
Referência da API	EN	DE

---

Stack

• Backend: Node.js / TypeScript (Fastify)
• Frontend: React, shadcn/ui, Tailwind CSS
• Banco de dados: PostgreSQL com extensão pgvector
• Contêineres: Docker, Docker Compose (rootless)
• Protocolos de IA: Anthropic Messages API, API compatível com OpenAI, MCP (Model Context Protocol)

---

Roadmap

Consulte ROADMAP.md para ver os recursos planejados em todos os horizontes.

A contribuição da comunidade é bem-vinda — abra uma issue ou inicie uma discussão.

---

Contribuindo

Contribuições são bem-vindas.

1. Faça um fork do repositório
2. Crie um branch de funcionalidade
3. Envie um pull request

Leia CONTRIBUTING.md antes de abrir um pull request.

Se a Ontheia ressoa com você, uma ⭐ ajuda outras pessoas a encontrá-la — e nos ajuda a construir uma comunidade em torno de IA soberana.

---

Licença

A Ontheia tem licença dupla:

1. Open Source: GNU Affero General Public License v3.0 — gratuita para uso pessoal, implantações auto-hospedadas e projetos open source.
2. Comercial: Licença Comercial — para organizações que precisam usar a Ontheia sem as obrigações da AGPL (por exemplo, como parte de um produto proprietário ou serviço gerenciado). Entre em contato via ontheia.ai para consultas.

---

Contato

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

---

© 2026 Ontheia · Open source sob AGPL-3.0.