Seu Agente de IA Pessoal na Guia
Recentemente me peguei pensando: todos acumulamos inscrições no ChatGPT, Claude e outros serviços em nuvem, mas na realidade somos apenas convidados lá. Seus dados, histórico de conversas e prompts vivem em algum lugar nos servidores de outra pessoa. E se você quiser construir seu próprio "Homem de Ferro" que possa navegar em arquivos, pesquisar no Google e não precise montar um data center em casa?
Encontrei o nanobot. É um mecanismo de código aberto para criar agentes de IA pessoais. O projeto se destaca porque não está tentando ser um "matador da OpenAI". Em vez disso, é uma camada leve que combina seus modelos favoritos, mensageiros e ferramentas locais em um único sistema funcional.
O Que É Isso
Resumindo, nanobot é um ambiente de execução de agentes. Os autores focaram em manter o núcleo pequeno e legível. Em vez de construir abstrações complexas, eles deram aos desenvolvedores "trilhos" prontos: WebUI, integrações de chat (Telegram, Discord, Slack), gerenciamento de memória e ferramentas.
O projeto é escrito em Python e requer a versão 3.11+. Já possui mais de 45.000 estrelas no GitHub, um número significativo para uma ferramenta especializada.
Como É Útil na Prática
O principal problema com a maioria dos agentes de IA é que são "descartáveis". Você faz uma pergunta, recebe uma resposta e o contexto se perde. O nanobot resolve isso através de sessões e objetivos de longa duração.
Agente no Seu Mensageiro
Em vez de abrir uma aba do navegador toda vez, você pode conectar o nanobot ao Telegram ou WeChat. Não é apenas um bot de resposta automática. Ele tem acesso ao seu espaço de trabalho (arquivos, scripts). Você pode enviar um PDF no Telegram e pedir para ele resumir ou encontrar um bug no código que está localmente na pasta do seu projeto.
Trabalhando com Ferramentas e MCP
O projeto suporta o Model Context Protocol (MCP). Isso significa que o agente pode usar ferramentas externas: pesquisar no Google, executar comandos shell, gerar imagens ou até chamar outros sub-agentes para resolver subtarefas.
Memória que Não Apaga
O nanobot tem um mecanismo Dream para memória de longo prazo. O agente lembra o contexto de sessões anteriores. Se você discutiu a arquitetura do projeto há uma semana, ele não vai perguntar novamente "em que estamos escrevendo isso?".
Análise de Mercado |
Escrita de Código |
Gerenciador de Tarefas |
Base de Conhecimento |
|---|---|---|---|
|
|
|
Como a Arquitetura Funciona
No centro de tudo está um pequeno loop de agente. Mensagens chegam dos canais de comunicação, o LLM decide se precisa de uma ferramenta e a memória é puxada como contexto. Os desenvolvedores deliberadamente evitaram frameworks pesados de orquestração para que o sistema possa ser facilmente personalizado para suas necessidades.
O tratamento de modelos é implementado de forma elegante. Você não fica preso a um único provedor. Você pode configurar um modelo primary (por exemplo, Claude 3.5 Sonnet) e configurar um fallbackModels caso a API do provedor principal caia ou atinja os limites de taxa. Qualquer endpoint compatível com OpenAI é suportado, incluindo Ollama local ou vLLM.
Como Iniciar e Configurar
A maneira mais rápida de experimentar é instalar via uv ou pip regular:
uv tool install nanobot-ai
# или
python -m pip install nanobot-ai
Após a instalação, execute o assistente de configuração interativo:
nanobot onboard --wizard
A configuração fica em ~/.nanobot/config.json. Tudo lá é intuitivo: você adiciona suas chaves de API, seleciona um modelo e especifica o caminho do espaço de trabalho. O espaço de trabalho é uma pasta à qual o agente terá acesso. A segurança é prioridade máxima aqui: o agente não vai bisbilhotar suas pastas do sistema a menos que você as adicione você mesmo.
Para quem prefere uma interface gráfica, há uma WebUI integrada:
nanobot gateway
Abra http://127.0.0.1:8765 e você obtém um ambiente de trabalho completo com chats, logs de execução de ferramentas e gerenciamento de automação.
Para Quem Isso Será Útil
O projeto é perfeito para quem quer automatizar tarefas rotineiras, mas não está pronto para entregar seus dados a sistemas corporativos fechados.
Por exemplo, se você for:
- Um desenvolvedor que precisa de um assistente de IA com acesso ao terminal para código local.
- Um pesquisador construindo uma base de conhecimento a partir de centenas de documentos.
- Um entusiasta de automação que quer executar tarefas agendadas (cron) através de IA.
O nanobot conquista você com sua transparência. Você vê cada passo que o agente dá, cada chamada de ferramenta, e pode corrigir sua lógica a qualquer momento simplesmente alterando algumas linhas em um script Python ou configuração. É um ótimo bloco de construção para quem já superou os chatbots regulares e quer algo mais tangível e controlável.
Projetos relacionados


