Mozg

Cérebros de conhecimento avaliados por exames para agentes de codificação. Cole uma URL de docs → cérebro pesquisável via MCP, com pontuação medida e lacunas conhecidas.

Documentação

mozg — a brain assembled from notes, stamped with a passing grade

mozg.

Conhecimento com dono, pontuação e medidor. Cérebros que seus agentes de IA consultam via MCP — medidos por um exame que eles não escreveram, honestos sobre suas lacunas e pagando a quem os preencheu.

License: AGPL-3.0 CI Cloud Gallery Learn MCP

Manifesto · Comece aqui · Catálogo · Status · Auto-hospedagem · Roteiro


Estamos construindo uma memória para toda a espécie. Tudo o que qualquer um escreveu entra; o que sai é fluente, instantâneo e desligado de cada pessoa de quem veio. Três coisas decorrem dessa forma, e nenhuma delas é um bug:

  • dissolve o autor — pode trabalhar do seu jeito e não consegue dizer seu nome;
  • não conhece o seu mundo particular — nem a decisão que sua equipe tomou em março;
  • não consegue dizer onde termina — o que aprendeu e o que está inventando soam idênticos.

Sabe o que sabemos. Não consegue dizer quem o ensinou.

mozg é a arquitetura oposta: não uma memória que engole tudo, mas muitas, cada uma ainda pertencente a alguém — examinada, honesta sobre seus limites e medida. Um mecanismo as mantém unidas:

O conhecimento deve ser medido.

Terminal: connecting mozg to Claude Code, then an agent answering an Expo question from the brain with a cited source and exam score

O ciclo

flowchart LR
    A[one docs URL] --> B[crawler<br/>github tree · llms.txt · sitemap]
    B --> C[atomic notes<br/>+ embeddings]
    C --> D{{the exam<br/>~30 questions from the goal}}
    D -->|score + failed questions| E[focused re-read<br/>chases the gaps]
    E --> C
    F[agents querying over MCP] -->|zero-hit searches| D
    F -->|corrections| G[owner review] --> C
    F -->|proposals from readers| G
  • O exame é o produto. O objetivo do cérebro se torna perguntas de controle, refeitas após cada ingestão. Treinado 92% é um fato, não uma afirmação — e as falhas são listadas publicamente, para que os agentes sejam informados das lacunas antes de pesquisar. Perguntas anti-blefe verificam que ele recusa o que não sabe.
  • Busca sem contexto. A recuperação é no servidor (híbrida + reranker). Um cérebro pode conter 3.000 notas; uma resposta custa as três de que precisou.
  • Leitores contribuem e não podem corromper. Um agente que descobre algo em um cérebro que apenas lê pode devolvê-lo — chega como uma proposta: pendente, atribuída, invisível para a busca e ausente do exame até o dono aceitá-la. Contribuição sem o poder de quebrar nada. Buscas sem resultados viram perguntas de exame por conta própria.
  • O bastão entre sessões. brain_handoff carrega o estado de trabalho para a próxima sessão — este agente amanhã, ou uma ferramenta completamente diferente. Um hook PreCompact lembra um agente de deixar um no momento em que o contexto está prestes a ser perdido.
  • learn. Qualquer cérebro funciona também como um curso de repetição espaçada para humanos em learn.mozg.sh — ler → recordar → quiz, sequências, um certificado a 80% e um placar contra seu próprio agente.
  • Resistente a injeção. As notas são verificadas quanto a vazamentos de credenciais, PII e linguagem de injeção de prompt; propostas de estranhos são verificadas novamente na porta por onde chegam; notas de terceiros chegam aos agentes como dados, não instruções; rastreadores de treinamento de IA são recusados no robots.txt.

Estilos: o outro tipo de cérebro

Um cérebro pode conter fatos — ou um modo de trabalhar. Um cérebro de estilo é lido por um extrator totalmente diferente: não "o que está representado", mas "o que eu teria que fazer para desenhar o próximo", e ele insiste em medições. Valores hex e qual deles domina. Peso do contorno e se varia ao longo de um traço. Como o sombreamento é feito e em que densidade. Os "nunca" — porque qualquer um pode copiar uma paleta, e o que denuncia uma imitação é o gradiente que o original nunca usaria.

Typing a prompt into a style's page on gallery.mozg.sh and getting an illustration back in that artist's style

Essa é a resposta ao roubo de estilo que paga o artista. Ferramentas de ocultação prometeram tornar estilos intreináveis e cada uma foi quebrada em meses. O outro caminho: o estilo se torna um produto licenciado e avaliado por exame. Os próprios agentes do comprador leem as regras via MCP, ou geram direto em gallery.mozg.sh — 25¢ por imagem, 10¢ para o artista, toda vez. Diferente de um fine-tune no disco de alguém, o acesso é revogável: um LoRA solto é para sempre, uma licença não é.

Rode o seu, em um comando

git clone https://github.com/egorfedorov/mozg.git && cd mozg
cp .env.selfhost.example .env     # fill ANTHROPIC_API_KEY + BETTER_AUTH_SECRET
docker compose -f docker-compose.selfhost.yml up

Postgres com pgvector, o embedder, o aplicativo e o worker sobem juntos; o esquema se migra antes de o aplicativo iniciar. Abra http://localhost:3300, crie uma conta, cole uma URL de documentação.

O primeiro boot baixa ~2,2 GB de pesos de embedding para um volume — essa é a parte lenta, e acontece uma vez. Detalhes operacionais completos, incluindo implantações de produção atrás de nginx, estão em docs/SELFHOST.md.

Nuvem, ou seu próprio metal

mozg.sh cloudauto-hospedagem (este repositório)
Ler, conectar, estudargrátisseu
Catálogo oficialgrátis, curado, mantido atualizadosemeie você mesmo (scripts/catalogue.ts)
Construir cérebroscérebro de teste grátis, depois planos ou traga sua própria chave de APIsuas chaves, sem limites
Marketplaceautores externos vendem, 95% para elesn/a
Geração de estilo25¢/imagem, 10¢ para o artistaprecisa de uma chave de API com capacidade de imagem
Operaçõesnossasdocs/SELFHOST.md

O acordo é honesto: construir cérebros gasta tokens de modelo. Na nuvem, você paga um plano (nós gastamos), define sua própria chave de API nas configurações (você gasta) ou ensina por meio de uma assinatura do Claude Code com o /mozg:train do plugin.

O que um agente recebe

Quatorze ferramentas MCP. As descrições dizem quando usar cada uma, o que é a diferença entre um cérebro que é usado e um que fica parado.

brain_list · brain_brief · brain_search · brain_read · brain_verify · brain_handoff · brain_write · brain_write_batch · brain_feedback · brain_create · brain_add_source · brain_refresh · library_add · library_remove

O plugin do Claude Code adiciona comandos de barra e dois hooks offline — um nomeia sua prateleira no início da sessão, outro lembra você de deixar um bastão antes de o contexto ser compactado.

Stack

Next.js 16 · Postgres 14 + pgvector (HNSW) · pg-boss (fila no Postgres) · better-auth · embeddings bge-m3 + bge-reranker (FastAPI auto-hospedado) · serviço de renderização Playwright para sites de documentação com shell JS · worker empacotado com esbuild. 211 testes, CI a cada push, página de status pública.

O manifesto

Isto é construído por uma pessoa da República de Sakha — três milhões de quilômetros quadrados, um milhão de pessoas e os lugares habitados mais frios da Terra. Cerca de 450.000 pessoas falam sakha. Pergunte a qualquer modelo de fronteira algo nesse idioma e observe: confiança total e errado, porque nunca houve o suficiente de nós online para valer a pena aprender direito.

Não somos suficientes para sermos aprendidos. Somos suficientes para ensinar.

É aí que a maior parte do mundo já está — não apenas idiomas, mas ofícios, regiões e a parte de cada arte que vive nas pessoas, não em páginas indexadas. O que não está nos dados de treinamento não existe para a máquina, e a máquina está rapidamente se tornando como tudo é consultado.

A alternativa a ser raspado não é ser ignorado. É ser licenciado.

Uma resposta errada e confiante é pior que o silêncio, e quase tudo construído até agora é otimizado para produzir uma.

Leia tudo → — o que estou realmente afirmando, em cinco linhas, e por que uma base de conhecimento deveria ter que passar por um exame.

Contribuindo

Relatórios de bug com reprodução superam tudo; relatórios de brain_feedback de uso real superam esses. PRs pequenos são bem-vindos — veja CONTRIBUTING.md. Novos pacotes de catálogo são entradas de dados, não código.

Licença

AGPL-3.0. Rode, altere, auto-hospede; hospede para outros e suas alterações permanecem abertas. A nuvem hospedada em mozg.sh vende conveniência e inferência — nunca bloqueia.