Os assistentes prontos guardam a sua vida no servidor de alguém, e os agentes que mexem no computador podem ler as suas senhas e apagar arquivos. O INTELECTO v2 é grátis, roda na sua máquina, pensa com uma IA local de graça, lembra o que você contou e só faz o que é perigoso depois que você aprova.
Você quer um assistente de IA só seu, que lembre das suas coisas, mas não quer entregar seus dados nem deixar uma IA solta no computador. O INTELECTO v2 é um assistente pessoal gratuito que você instala no seu computador e conversa com ele pelo terminal ou pelo Telegram. Ele pensa com uma IA que roda na sua máquina (Ollama, sem custo) ou na nuvem, guarda memórias, mexe só numa pasta de trabalho e pede a sua aprovação antes de qualquer comando que não seja só de leitura. Você precisa de Python 3.10 ou mais novo; nada mais é obrigatório.
Dá para ter os dois: um assistente que ajuda de verdade e que não te coloca em risco.
Nos assistentes prontos, tudo o que você conta fica guardado na empresa. No INTELECTO a memória é um arquivo no seu computador, e com a IA local nada sai da máquina.
Um agente que roda comandos sozinho alcança as suas senhas, a internet e os seus arquivos. Basta um erro ou um texto malicioso escondido num site.
Os frameworks de agente têm milhares de arquivos. O INTELECTO tem 1.500 linhas, separadas em 8 peças, que dá para ler numa tarde.
Cada peça mora numa pasta própria. Você entende o todo sem programar.
Por onde você fala: o terminal ou o Telegram. No Telegram ele só responde a você.
Pensa, usa uma ferramenta, olha o resultado e responde. No máximo 5 voltas, para não ficar rodando sem fim.
Quatro arquivos de texto: quem ele é, como trabalha, quem é você e o que ele já sabe. Você muda escrevendo.
A IA que pensa: uma no seu computador (Ollama, de graça) ou uma na nuvem (OpenRouter, serviço pago que precisa de conta).
Guarda o que você conta e acha de novo pelas palavras, mesmo sem acento. Continua lá amanhã.
Guardar e buscar memória, ler, gravar e listar arquivos (só na pasta dele) e rodar comando.
Decide se um comando pode rodar e guarda senhas cifradas. Tudo o que ele faz fica anotado.
Se você ligar, cada comando roda numa caixa descartável, sem internet e sem as suas senhas.
Atenção: elas já existem no código e passam nos testes, mas ainda não estão ligadas à conversa nem ao Telegram. Hoje você só consegue vê-las funcionando na demonstração abaixo. Ligar cada uma é trabalho de programação, para quem programa ou para o Claude Code/Codex.
Uma página da internet pode trazer um texto escrito para dar ordens à IA. A regra: o agente (a parte que trabalha sozinha) que puder ler a web não enxerga o que o assistente sabe de você. A regra está pronta; a leitura da web em si ainda não existe no INTELECTO.
Para a futura pesquisa na internet: cada afirmação guarda a frase exata da página, e o código confere se a frase está lá. Inventada, fica de fora; número de fonte que não existe vira [?].
Um trabalho de 10 minutos que não trava a conversa. Cada passo é salvo: se o computador desligar, ele continua de onde parou. Acabou o tempo, ele entrega o que tem.
Se a hora passou com o computador desligado, ainda vale até: lembrete, 2 horas; algo que o assistente faz sozinho (como um "bom dia"), 45 minutos; tarefa longa, 6 horas. Depois disso, é pulado e anotado. Horário de silêncio segura só o que você não pediu.
O cérebro é a IA que responde. Com vários em fila, se um cai, o próximo responde, e o que caiu descansa: 5 minutos se acabou a cota (o limite de uso), 30 se está fora do ar, 6 horas se o modelo não existe na sua conta.
Gravou, moveu ou apagou um arquivo errado? "Desfaz" volta. Apagar vai para uma lixeira. Gravar por cima de um arquivo com mais de 1 MB não tem volta, e ele avisa. Se não sabe como era antes, não finge que sabe.
Veja as seis funcionando no seu computador, sem internet e sem IA instalada, na pasta onde você baixou o projeto (a mesma do git clone):
git pull && python3 -m intelecto avancado
Para quem programa: a lista técnica de como ligar cada uma está em docs/RECURSOS-AVANCADOS.md. São 35 testes a mais (105 no total).
Antes de rodar qualquer comando, a trava olha o que ele faz. O padrão é perguntar: só passa direto o que apenas lê.
Comandos que só olham: listar arquivos, ler um texto, ver a data, ver o espaço do disco.
Qualquer outro: gravar, mover, apagar um arquivo, instalar, acessar a internet. Ele pergunta no terminal ou manda "/sim ou /nao" no seu Telegram.
O que destrói: apagar o disco ou a sua pasta pessoal, formatar, desligar a máquina, baixar e executar script. Nem com o seu OK.
A v1 tinha só uma lista de palavras proibidas: "rm -rf /" era barrado, mas "rm -r -f /" passava. A v2 entende as duas formas e mais 19 variações testadas, e quem não está na lista de leitura precisa da sua aprovação. A lista não é a única proteção: para comando que você não conhece, ligue a caixa.
Exemplo real: você manda "lembre que meu nome é Ana" e, no dia seguinte, "qual meu nome?". Isto é o que acontece dentro do INTELECTO.
A mensagem entra pelo terminal ou pelo Telegram. No Telegram, ele confere se quem mandou é você (lista de donos); mensagem de outra pessoa é ignorada e anotada.
Frase que começa com "lembre que", "guarde" ou "anote" é guardada na hora, sem depender da IA decidir. Por isso até um modelo pequeno lembra. Pergunta (com "?") nunca vira memória.
Junta os arquivos de identidade (quem ele é, como trabalha, quem é você), as memórias que combinam com a pergunta ("nome" acha "meu nome é Ana") e as últimas conversas.
Tudo isso vai para a IA (no seu computador ou na nuvem). Ela responde ou pede uma ferramenta: guardar, buscar, ler um arquivo, rodar um comando.
Se for comando, a trava decide: roda, pergunta a você ou recusa. Aprovado, ele roda na pasta de trabalho, ou na caixa sem internet se você ligou. O resultado volta para a IA, no máximo 5 voltas.
Você recebe a resposta, e tudo o que ele fez (comando, ferramenta, memória, erro) fica numa linha da auditoria, para você conferir depois.
O INTELECTO v2 é a base que já funciona. Para ir além (WhatsApp, agenda, casa inteligente, voz…), abra a mercearia: são 144 ingredientes de 12 projetos de agentes, em 8 corredores. Você escolhe, ela gera o arquivo meu-assistente.md, e o Claude Code ou o Codex constrói em cima do INTELECTO seguindo esse arquivo.
Clique nos ingredientes dos corredores, ou carregue um dos 5 exemplos prontos abaixo.
Cada item vem marcado: ✅ já existe no INTELECTO, 🟡 existe em parte, ➕ falta (e em qual peça encaixa). No fim, as regras para o agente: um item por vez, com teste.
Copie o arquivo para a pasta do INTELECTO, abra o Claude Code ou o Codex ali e peça para implementar. Mais seguro: dentro da caixa-do-agente.
Os ingredientes marcados com ➕ ainda não existem no INTELECTO: quem constrói é o agente, seguindo o arquivo. O que ele fizer, confira com os testes antes de usar.
Testado em 12/11/2026 num computador Linux. O que não foi testado ao vivo está escrito.
| Parte | Como foi testada |
|---|---|
| Loop, memória, ferramentas, trava, aprovação, cofre e auditoria | 105 testes automáticos, todos passando |
| IA local (Ollama) | Ao vivo com o modelo qwen3.6: ele guardou "meu nome é Nei e moro em Porto Alegre" e, numa conversa nova, respondeu "Seu nome é Nei e você mora em Porto Alegre". Com o llama3.2 (modelo pequeno) ele quase não usa as ferramentas sozinho, mas desde a versão 2.0.1 tudo o que começa com "lembre que" é guardado direto, e ele também lembrou do nome e da cidade. |
| Caixa (comando num container) | Ao vivo: enxerga só a pasta de trabalho, não vê as variáveis do seu terminal e fica sem internet |
| OpenRouter e Telegram | Contra servidores de teste no próprio computador (formato, chave, filtro de dono, aprovação por /sim). Não testados ao vivo: dependem da sua chave e do seu bot. |
| macOS | Não testado. O serviço do macOS e a chave do cofre pelo número da máquina estão no código. |
Daqui para baixo é a parte técnica: instalar, configurar e rodar. Você não precisa desta parte para entender o que está acima.
Só a biblioteca padrão do Python. O pacote cryptography é opcional (cofre com Fernet).
Uma linha de comando com 8 subcomandos: conversar, demo, telegram, configurar, cofre, memoria, auditoria e verificar.
Tudo do assistente fica numa pasta: config, memória, identidade, pasta de trabalho, auditoria e cofre. Troque com INTELECTO_HOME.
python3 -m pytest -q. Nenhum teste chama API de verdade.
O Python já vem no Linux e no macOS recente. O git (o programa que baixa o projeto) pode faltar numa máquina nova.
python3 --version && git --version sudo apt install -y git # Ubuntu, se faltar o git xcode-select --install # macOS, se faltar o git
De graça, em ollama.com. O modelo testado pede uma placa de vídeo boa; o llama3.2 roda em máquina simples: usa pouco as ferramentas, mas lembra o que você pede com "lembre que…".
ollama pull qwen3.6:35b-a3b ollama pull llama3.2 # mais leve
Opcional. Só se você quiser rodar os comandos numa caixa sem internet.
docker run --rm hello-worldA demonstração usa um cérebro de mentira: roda sem internet e sem modelo.
cd ~ && git clone https://github.com/inematds/intelecto-v2 && cd intelecto-v2 python3 -m intelecto demo
Pergunta o nome, a personalidade, o cérebro, o modelo, onde rodar comandos (local ou caixa) e a aprovação. Enter mantém o valor sugerido.
llama3.2).perigosos (padrão) faz o que está em "Como ele decide"; sempre pergunta até para listar arquivos; nunca não pergunta nada e só deixa rodar o que apenas lê.python3 -m intelecto configurar
Edite os 4 arquivos de identidade. Cada linha que começa com "- " no MEMORY.md vira uma memória na primeira vez.
nano ~/.intelecto2/identidade/USER.md # quem é você nano ~/.intelecto2/identidade/AGENTS.md # regras de trabalho (memória, ferramentas) nano ~/.intelecto2/identidade/SOUL.md # jeito de ser nano ~/.intelecto2/identidade/MEMORY.md # fatos iniciais
python3 -m intelecto verificar # → tudo certo python3 -m intelecto # conversa no terminal; 'sair' para terminar
Se aparecer [FALTA] no modelo, baixe-o com ollama pull <modelo> ou rode o configurar e escolha um dos que você já tem.
No Telegram, abra o @BotFather, mande /newbot, escolha um nome e copie o token que ele responde (o código secreto do seu bot, do tipo 123456:ABC…). Guarde esse token no cofre. Ligue o bot, mande /id para ele e ponha o número que ele responder no configurar (pergunta dos ids do Telegram; nas outras perguntas, só aperte Enter). Sem dono configurado, ele só responde ao /id.
python3 -m intelecto cofre guardar telegram # cola o token; não aparece na tela python3 -m intelecto telegram # mande /id no bot, depois Ctrl+C python3 -m intelecto configurar # coloque o seu id python3 -m intelecto telegram
# Linux (systemd do usuário; ajuste a pasta no arquivo se não clonou em ~/intelecto-v2) mkdir -p ~/.config/systemd/user cp servico/intelecto-telegram.service ~/.config/systemd/user/ systemctl --user daemon-reload && systemctl --user enable --now intelecto-telegram # macOS: troque SEU_USUARIO em servico/club.inema.intelecto.plist e copie para ~/Library/LaunchAgents/
Com Docker, cada comando aprovado roda num container sem rede, só com a pasta de trabalho.
docker pull python:3.12-slim python3 -m intelecto conversar --executor caixa # ou executor caixa no configurar
A chave vai no cofre, nunca no config. Cada mensagem custa conforme o modelo escolhido.
python3 -m intelecto cofre guardar openrouter python3 -m intelecto conversar --provedor openrouter --modelo anthropic/claude-sonnet-5.5
python3 -m intelecto memoria # últimas memórias python3 -m intelecto memoria cachorro # busca python3 -m intelecto auditoria -n 20 # comandos e ferramentas, com o que rodou e o que não rodou
python3 -m intelecto demo
você> rode: ls
intelecto> Feito. Resultado de rodar_comando: [local, saída 0]
você> rode: echo teste > nota.txt
intelecto> Feito. Resultado de rodar_comando: não rodei: o dono não aprovou
você> rode: rm -rf /
intelecto> Feito. Resultado de rodar_comando: não rodei: bloqueado: apagar pasta do sistema ou a pasta pessoal
você> leia ../../etc/passwd
intelecto> Feito. Resultado de ler_arquivo: fora da pasta de trabalho
O programa responde em português. Na demonstração ninguém aprova, por isso o "echo" não roda. Na conversa de verdade, ele pergunta a você.
| v1 | v2 | |
|---|---|---|
| Código | o README descrevia o assistente, mas só havia um exemplo mínimo com cérebro de mentira | assistente completo, 1.500 linhas, 105 testes (v2.1) |
| Comandos | lista de palavras proibidas | roda / pergunta / recusa, e o padrão é perguntar |
| Telegram | só a estrutura | funciona e só responde aos donos |
| Isolamento | prometido no curso | caixa por comando (Docker sem rede) |
| Plataforma | só macOS | Linux testado; macOS no código |
A v1 e o curso da v1 continuam no ar. O método dela continua valendo: escolher os ingredientes na mercearia de frameworks e entregar o briefing ao Claude Code ou ao Codex para montar um assistente do seu jeito.
O INTELECTO protege o que o assistente faz. A caixa-do-agente protege o projeto enquanto você, o Claude Code ou o Codex mexem nele.
Quando você deixa um agente de IA mexer no computador sozinho, ele alcança as suas senhas (.env, chaves), a internet e os seus arquivos de verdade. A caixa-do-agente faz o trabalho numa sala fechada, em 3 passos:
Faz uma cópia do projeto numa pasta temporária e deixa de fora as senhas e as chaves.
O comando roda na cópia, num container (uma caixa isolada dentro do seu computador) sem internet, com limite de memória, de processador e de tempo.
Mostra o que mudou num arquivo .patch (a lista das mudanças), apaga o container e a cópia. O original só muda se você aplicar.
É como deixar o pedreiro trabalhar numa maquete da sua casa, sem a chave do cofre: no fim você olha o que ele fez e decide se faz igual na casa de verdade. A segunda ferramenta do kit, o auditor, só lê e dá uma nota de 0 a 10 para a proteção de quem programa no projeto.
O arquivo de senha (.env) ficou fora da cópia, 67 testes passaram e 1 foi pulado (o que precisa de Docker, que não existe lá dentro) e 0 arquivos mudaram. Como a caixa não tem internet, o programa de testes (pytest) vai numa imagem preparada antes (caixa/Dockerfile).
O auditor olha o projeto e as ferramentas de programação que você usa nele (Claude Code, Codex). A nota subiu com duas mudanças: tiramos o arquivo de senha (.env) de dentro do projeto e pusemos um arquivo de regras para os agentes (CLAUDE.md).
Faltou a camada "caixa": no computador onde testamos, o Claude Code e o Codex estão configurados para rodar sem isolamento. Isso é configuração de cada computador, então rode o auditor no seu para ver a sua nota. Para fechar essa camada, rode o seu agente por dentro do caixa.sh.
# 1. imagem com o pytest (a caixa não tem internet para instalar nada) docker build -t intelecto-v2-testes caixa/ # 2. os testes numa cópia sem .env, sem rede, que se apaga no fim ~/caixa-do-agente/caixa.sh ~/intelecto-v2 --imagem intelecto-v2-testes -- python3 -m pytest -q -p no:cacheprovider # 3. a nota (só lê, não muda nada) python3 ~/caixa-do-agente/auditar.py ~/intelecto-v2
Para ter a caixa: git clone https://github.com/inematds/caixa-do-agente ~/caixa-do-agente (precisa de Docker e Python 3).