# Krohnos · Orquestrador multiagente de IA self-hosted

> O Krohnos é um orquestrador multiagente de IA self-hosted que integra projetos, SEO e conhecimento para entregar resultados revisados e comprovados, com gestão pelo WhatsApp ou painel.



## O que tem dentro

**Orquestração e execução paralela** O orquestrador planeja e distribui as tarefas pela fila do Linear. Contas Claude Code e Codex atuam nas faixas de construção, operação e revisão, com transferência automática para outra conta disponível quando a cota se esgota. A execução paralela reduz o tempo de espera entre demandas.

**Revisão e portão de Done** A revisão por outro modelo, como o Codex, integra o fluxo de CI, merge e deploy. O portão de Done exige evidências de integração, publicação e checagens aprovadas e reabre tarefas encerradas sem entrega. Cada conclusão representa um resultado verificável.

**Segundo cérebro e biblioteca de receitas** O grafo de conhecimento, a wiki compilada e o mapa visual preservam decisões e conectam aprendizados. A biblioteca injeta receitas relevantes no despacho das tarefas para reduzir retrabalho e manter a continuidade entre projetos.

**Gestão de múltiplos projetos** Um painel reúne os sites e negócios, com BI por projeto e integrações com Google Search Console, GA4, Clarity, Meta e CRM. A disponibilidade de cada integração acompanha a configuração do negócio, oferecendo uma visão consolidada para a tomada de decisão.

**SEO e desempenho em campo** A auditoria SEOmator mantém cobertura semanal por seção, enquanto Clarity e RUM acompanham a experiência real de navegação. O sistema monitora ranking e visibilidade em ChatGPT, Claude, Gemini e Perplexity e encaminha falhas elegíveis para correção automática, com revisão e comprovação.

**Monitoramento e eficiência operacional** Vigia e debugger identificam falhas e encaminham consertos. A escolha do modelo considera a tarefa, e as esperas de CI, revisão e deploy podem ser retomadas sem nova chamada de IA, reduzindo consumo operacional.

## Operação em produção

**Seis negócios em operação** O Krohnos opera seis negócios há pelo menos uma semana, com histórico de execução desde 08/10/2026 e cadastro verificado em 17/10/2026.

**1.038 execuções bem-sucedidas** Em 16/10/2026, o registro de uso contabilizou 1.038 execuções de agentes e rotinas concluídas com sucesso e sem interrupção. [Fonte e metodologia de medição](https://github.com/BRK13/krohnos/blob/main/site/EVIDENCE.md).

## Instalar

**Requisitos** Linux com Docker 24+ e Docker Compose v2, 2 GB de RAM livres e uns 4 GB de disco. Os segredos ficam em volumes do Docker, nunca na imagem.

```bash
# 1. Baixe o código
git clone https://github.com/BRK13/krohnos.git krohnos && cd krohnos
# 2. Construa a imagem (uma só serve os 4 serviços)
docker compose build painel
# 3. Configure: cria o krohnos.toml, a chave mestra, o cofre e o seu usuário de dono
docker compose run --rm --no-deps --entrypoint krohnos painel init
# 4. Suba os 4 serviços (painel, agenda, webhook, mcp)
docker compose up -d
# 5. Confira: deve responder ok
curl -fsS http://127.0.0.1:8787/saude
```

Depois abra o painel, entre com o e-mail e a senha do dono e siga o assistente do painel. Guia completo: [docs/INSTALAR.md](https://github.com/BRK13/krohnos/blob/main/docs/INSTALAR.md).

## Requisitos

**Servidor** Uma máquina Linux (VPS ou PC) com Docker 24+ e o plugin Docker Compose v2, 2 GB de RAM livres e uns 4 GB de disco. Um domínio apontado para o servidor é opcional, só para abrir o painel pela internet com TLS.

**Confira** Os dois comandos devem responder com uma versão. Segredo nunca entra na imagem: fica em volumes do Docker.

```bash
docker --version
docker compose version
```

## Configuração

**krohnos.toml** O `krohnos init` cria o arquivo no volume `config` (`/etc/krohnos/krohnos.toml` dentro dos contêineres). Qualquer chave pode ser sobrescrita por `KROHNOS_<SECAO>_<CHAVE>`. A porta, por exemplo, muda assim:

```bash
KROHNOS_PAINEL_PORTA=9000 docker compose up -d
```

```toml
[painel]
dominio = "krohnos.example.test"
porta = 8787

[agentes]
contas = ["1", "2"]
```

**Segredos** Senha, token e chave de API nunca vão no `krohnos.toml`: chave com esses nomes é recusada. Ficam no cofre (volume `cofre`). A senha do dono é gerada uma vez pelo `init`, ou lida de uma variável de ambiente, nunca pela linha de comando:

```bash
docker compose run --rm --no-deps --entrypoint krohnos painel init --dono-senha-env NOME_DA_VARIAVEL
```

## Conectar contas de agente

**Um login por conta** Cada conta de agente (Claude Code, Codex) tem o seu login, guardado no volume `home`, que sobrevive a recriar os contêineres. Liste as contas em `[agentes]` no `krohnos.toml` e entre em cada uma uma vez. Troque `N` pelo número da conta.

```bash
docker compose exec painel sh -c 'CLAUDE_CONFIG_DIR="$HOME/.claude-N" claude login'
```

O painel também faz isso na tela Agentes. Conta sem login fica parada até você entrar.

## Atualizar

**Baixar, reconstruir, reiniciar** Dados, cofre e logins ficam em volumes, então a atualização os mantém. Leia as notas da versão antes.

```bash
git pull
docker compose build painel
docker compose up -d
curl -fsS http://127.0.0.1:8787/saude
```

## Desinstalar

**Parar** Para os quatro serviços e mantém dados, cofre e logins.

```bash
docker compose down
```

**Remover tudo** Apaga também os volumes: dados, cofre, chave mestra e logins do painel. Não tem volta. Guarde a chave mestra antes.

```bash
docker compose down -v
```