O que é o nanobot
O nanobot, do laboratório HKUDS (Universidade de Hong Kong), é um framework de agente pessoal de IA, open source e self-hosted, escrito em Python. Em 12 de outubro de 2026, o repositório tinha cerca de 49 mil estrelas no GitHub, licença MIT e commits no dia anterior, segundo a API do GitHub. A proposta é ter um assistente parecido com os comerciais, mas rodando na sua máquina ou servidor, com um núcleo pequeno e legível.
O que ele faz
Segundo o README, o nanobot:
- roda numa WebUI no navegador ou no terminal;
- conecta a Telegram, Discord, Slack, WeChat, e-mail, Mattermost, Linear, Feishu, Teams e outros canais;
- usa ferramentas de arquivos, shell, busca e leitura na web, MCP, cron, geração de imagem e subagentes;
- mantém histórico e memória de longo prazo (um recurso chamado Dream);
- executa metas de longo prazo e automações agendadas;
- expõe um SDK Python e uma API compatível com a OpenAI;
- funciona com APIs compatíveis com OpenAI, LLMs locais e modelos de fallback.
Como instalar
Requer Python 3.11+. Há três caminhos:
# com uv (recomendado para versão estável)
uv tool install nanobot-ai
# ou com pip, dentro de um ambiente virtual
python -m pip install nanobot-ai
O projeto também oferece um instalador de uma linha (curl ... | sh). Se preferir esse caminho, leia o script antes (scripts/install.sh) ou use a opção --dry-run, que o próprio README sugere para ver o plano sem mudar nada.
Depois:
nanobot webui
Isso abre http://127.0.0.1:8765. Em Settings → Models, você escolhe o provedor, a credencial e o modelo. Para manter o agente rodando depois de fechar o terminal: nanobot gateway --background.
Pontos positivos
- Controle dos dados: conversas e memória ficam na sua infraestrutura.
- Liberdade de modelo: dá para usar um modelo local para dados sensíveis e um modelo de nuvem para tarefas gerais.
- Canais de chat: útil para equipes que já vivem no Slack, Teams ou Telegram.
- Código pequeno e legível: mais fácil de auditar que plataformas gigantes.
Cuidados de segurança
Um agente com shell, arquivos e acesso a e-mail é poderoso, e perigoso se mal configurado:
- WebUI só em localhost. O README diz que o primeiro uso escuta apenas em localhost. Não exponha na internet sem autenticação e TLS.
- Rode num usuário ou contêiner isolado, com acesso apenas às pastas necessárias.
- Cuidado com injeção de prompt: e-mails e páginas web lidos pelo agente podem conter instruções maliciosas. Exija confirmação humana para ações sensíveis.
- Guarde as chaves de API em variáveis de ambiente ou num cofre, nunca em repositórios.
- Revise servidores MCP de terceiros antes de conectar.
Para quem faz sentido
Desenvolvedores e pequenas equipes técnicas que querem um assistente sob seu controle, integrado ao chat da empresa e a modelos locais. Para quem não tem equipe técnica, um assistente gerenciado pode ser mais seguro e simples.
Fontes
- Repositório: https://github.com/HKUDS/nanobot
- README e documentação do projeto (consultados em 12/10/2026)
- API do GitHub (estrelas e licença, 12/10/2026)
Quer implantar um agente de IA com segurança na sua empresa? A KGA IT oferece uma consulta gratuita: kga-it.com.