Roda no seu Mac, fala via Telegram, lembra de tudo e tem personalidade definida por você. Sem Docker, sem cloud obrigatória, ~3.000 linhas legíveis e 7 dependências.
# clone e suba tudo git clone https://github.com/inematds/intelecto.git cd intelecto ./start.sh # venv + deps + wizard
INTELECTO é o oposto de um framework de agente pesado: sem cloud obrigatória, sem Docker, sem dashboard web. Single-owner — é seu. O Telegram é a interface, e a personalidade vive em arquivos Markdown que você edita.
~3.000 linhas, 35 arquivos, 7 dependências pip, 0 containers Docker. Nada de YAML infinito — ./start.sh e acabou.
OpenRouter (100+ modelos via LiteLLM) ou Ollama 100% local — zero custo, zero privacidade comprometida.
SQLite FTS5 com ranking BM25 e deduplicação — sem embeddings, sem chamadas de API pra busca, sem custo extra.
Você manda mensagem; o INTELECTO recebe via long-polling, monta o contexto (SOUL/AGENTS/USER + memórias relevantes), pensa no agent loop (máx. 5 rounds), usa ferramentas se precisar, salva um resumo na memória e responde.
A personalidade vive em workspace/SOUL.md (tom e valores), AGENTS.md (regras), USER.md (seu perfil) e MEMORY.md (fatos de bootstrap). Edite no editor de texto.
read_file, write_file, list_directory e run_command (com safety check). Segredos em store Fernet (chave = UUID do hardware), blocklist de comandos e audit log.
É um projeto Python pra macOS. Você precisa de Python 3.11+, um token de bot do Telegram e uma chave do OpenRouter (ou Ollama instalado, se quiser rodar 100% local).
O start.sh cria o venv e instala as 7 dependências. Confirme a versão:
# versão do Python python3 --version
Crie um bot pelo BotFather e tenha o token pronto pro wizard.
# no Telegram @BotFather → /newbot → copie o token
Pegue uma chave em openrouter.ai/keys, ou instale o Ollama pra rodar local.
# cloud: chave OpenRouter openrouter.ai/keys # local: ollama instalado
O start.sh faz quase tudo: cria venv, instala dependências e roda o wizard de 6 etapas. Comandos reais do README.
Baixe o projeto e entre na pasta.
git clone https://github.com/inematds/intelecto.git cd intelecto
Um único comando cria o venv, instala as dependências e abre o wizard de configuração.
./start.sh
Cole o token do Telegram, a chave do OpenRouter, escolha o modelo padrão, dê um nome ao assistente e defina a personalidade em uma frase.
# o wizard pede, em ordem: [1/6] Telegram Bot Token [2/6] OpenRouter API Key [3/6] Modelo padrão # ex.: Claude Sonnet 4 [4/6] Nome do assistente [5/6] Personalidade em uma frase
O wizard salva a config, cria o banco de memória e instala o auto-start (launchd) — o agente reinicia sozinho.
# o wizard confirma: ✓ Configuração salva ✓ Banco de memória criado ✓ Auto-start instalado (launchd)
Mande uma mensagem no Telegram. Pra ajustar o jeito do assistente, edite os arquivos da workspace no seu editor.
# edite a identidade quando quiser workspace/SOUL.md # tom e valores workspace/USER.md # seu perfil
É um assistente pessoal de verdade: lembra do seu contexto, usa ferramentas no seu Mac e roda do jeito que você configurar — cloud ou local.
Pergunte algo da semana passada; a memória SQLite FTS5 traz os fatos relevantes por BM25 e o agente responde com contexto.
Peça pra ler, escrever ou listar arquivos — as ferramentas filesystem fazem read_file, write_file e list_directory.
run_command executa no Mac passando por safety check e blocklist, com tudo registrado no audit log.
Troque o provider pra Ollama e rode sem mandar nada pra cloud — zero custo e privacidade total.
O norte é manter o projeto enxuto e legível — o antídoto contra frameworks inchados. As fases abaixo refletem a arquitetura modular (providers, channels, tools, memory) pensada pra crescer sem inchar.