O que é o nanobot?
nanobot é um framework de agente de IA pessoal gratuito, de código aberto e auto-hospedado, escrito em Python e desenvolvido pela HKUDS. Ele não executa seu próprio modelo de linguagem — em vez disso, envolve memória, acesso a ferramentas, coordenação multiagente e agendamento em torno de um modelo que você conecta, e expõe o resultado por interface web, terminal ou integrações de apps de chat.
- Tipo de produto: um framework de agente / camada de orquestração, não um app empacotado para usuário final nem um modelo
- Criador: HKUDS (organização no GitHub)
- Repositório: github.com/HKUDS/nanobot, criado em 1º de fevereiro de 2026
- Licença: MIT, confirmada pelo campo de licença do repositório do GitHub
- Documentação: nanobot.wiki
- Escala, segundo a API do GitHub no momento desta análise: 49.657 estrelas, 8.700 forks (proporção de forks de cerca de 18%), 868 issues abertas, 207 assinantes, 100+ colaboradores, última versão marcada v0.4.0 (28 de outubro de 2026)
O que o nanobot realmente faz?
O nanobot adiciona quatro capacidades sobre um modelo ao qual você já tem acesso: memória persistente, integração de ferramentas MCP, delegação multiagente e automação agendada.
- Memória persistente: segundo o nanobot.wiki, histórico de sessão e memória de longo prazo (documentados sob o nome "Dream") permitem que um agente mantenha o contexto entre conversas em vez de começar do zero a cada sessão
- Integração de ferramentas MCP: conecta-se a servidores Model Context Protocol (MCP) por uma interface "Apps" na WebUI, com integrações pré-configuradas e suporte para adicionar servidores MCP personalizados
- Delegação multiagente: segundo sua própria documentação, o nanobot pode delegar subtarefas a outros agentes em vez de tratar cada etapa dentro de um único loop de agente
- Automação agendada: os agentes podem rodar em um horário programado, não só em resposta a uma mensagem de chat ao vivo
- Roteamento de modelo: suporta APIs compatíveis com OpenAI, Ollama local e vLLM local, além de roteamento de modelo de reserva descrito na documentação
- Três modos de acesso: uma WebUI no navegador (iniciada com
nanobot webui), um modo terminal nativo (iniciado comnanobot) e integrações com Telegram, Discord, Slack, WhatsApp, WeChat, e-mail, Mattermost, Feishu, Microsoft Teams, Linear e QQ
O que a documentação do nanobot cobre (e o que não)
O README documenta MCP, anexos e canais de chat, mas não prompt caching, WhatsApp nem benchmarks; a documentação do repositório acrescenta WhatsApp, streaming e heartbeat. Esta seção confere o README em github.com/HKUDS/nanobot, a pasta docs do mesmo repositório (referência de apps de chat e guia de configuração) e o nanobot.wiki quanto aos recursos mais buscados, para você distinguir o comportamento documentado de suposições.
- Arquitetura: segundo o README, o gateway em Python "owns agent execution, sessions, tools, memory, and security policy" para a WebUI, o terminal e os apps de chat, e o laço central do agente "builds context, calls the model, executes requested tools, and returns the result". Ele também lista "Small core: readable internals with MCP, memory, deployment, and automation built in". Não faz nenhuma afirmação sobre o número de linhas.
- Suporte a MCP: na WebUI, os "Apps" conectam servidores MCP, ativam Agent Plugins e gerenciam adaptadores locais de apps CLI; no terminal,
@pode mencionar um app, um servidor MCP ou uma sessão salva. Não há garantias de confiabilidade nem resultados de testes específicos de MCP documentados. - Prompt caching: o README e o guia de configuração não mencionam
cache_controlnem o prompt caching da Anthropic, e não publicam números de acertos de cache. Dizem apenas que o indicador de contexto da WebUI mostra "cache reuse when the provider reports it", que os acertos de cache "still depend on the provider" e que o tempo limite de inatividade para compactação pode ser aumentado se o seu provedor mantiver o cache de prompts por mais tempo. - Streaming: o README não o nomeia, mas a referência de apps de chat e o guia de configuração, sim: as respostas no Discord e no Feishu são transmitidas por streaming por padrão (
streamingvaletruepor padrão e pode ser desativado), e as chamadas ao modelo usam por padrão um tempo limite de inatividade de stream de 90 segundos (NANOBOT_STREAM_IDLE_TIMEOUT_S). - Multimodal e arquivos: a WebUI permite "Attach documents or images", o terminal aceita imagens coladas da área de transferência (
Ctrl+VouAlt+V) e a lista de ferramentas inclui geração de imagens. As notas da versão v0.4.0 acrescentam, na WebUI, anexos de arquivos locais e vídeos, miniaturas de imagens e cartões de arquivo. - Canais de chat: a referência de apps de chat do repositório cobre, entre outros, Telegram, Discord, Slack, Feishu, WhatsApp (vinculado por QR code), WhatsApp Agent Platform, WeChat, QQ, e-mail, Mattermost e Linear. O README cita Telegram, Discord, Slack, WeChat, e-mail, Mattermost e Linear, além de "other channels", e a lista "Why nanobot" acrescenta Feishu e Microsoft Teams.
- Heartbeat: documentado no guia de configuração, não no README. Uma tarefa heartbeat embutida fica ativa por padrão com
nanobot gateway, verifica oHEARTBEAT.mda cada 1.800 segundos (gateway.heartbeat.intervalS) e envia apenas resultados acionáveis ao chat ativo mais recente. - Confiabilidade: a documentação descreve uma cadeia ordenada de modelos de fallback (
agents.defaults.fallbackModels) e novas tentativas de entrega de mensagens (3 tentativas por padrão, com espera de 1 s e depois 2 s). Também indica limites: horários agendados perdidos não são reexecutados após reiniciar o gateway, e tarefas de subagentes interrompidas não são relançadas automaticamente. A versão v0.4.0 move o histórico de conversas para o SQLite. - Benchmarks: nem o README nem as páginas de documentação lidas por esta review afirmam nenhum, e esta review não executou nenhum.
Plataforma, preços e licença
Plataforma
- O que o nanobot informa:
- Auto-hospedado em Linux, macOS ou Windows via scripts de instalação, ou implantado com Docker / Docker Compose como serviço persistente, segundo o repositório do GitHub.
Custo
- O que o nanobot informa:
- Gratuito e de código aberto. Você paga apenas pelo modelo ou API que conectar (ou nada, se rodar um modelo Ollama ou vLLM local) — não existe um plano pago separado do nanobot.
Licenciamento
- O que o nanobot informa:
- Licença MIT, confirmada pelo campo de licença do repositório do GitHub.
Hardware
- O que o nanobot informa:
- Sem exigência própria de GPU ou RAM mínima — é um loop de agente que chama um modelo, não um motor de inferência. A necessidade real de hardware depende inteiramente do modelo de backend escolhido.
Método de instalação
- O que o nanobot informa:
- Segundo o nanobot.wiki e o README do GitHub: um script de instalação de uma linha para macOS/Linux e Windows PowerShell, ou via
pip install nanobot-ai/uv tool install nanobot-ai. Veja a seção "Instalar o nanobot" abaixo.
Verifique as instruções atuais de instalação e implantação diretamente no nanobot.wiki antes de executar qualquer comando, já que as etapas de instalação podem mudar entre versões.
Instalar o nanobot
O nanobot é instalado gratuitamente via script de uma linha, gerenciador de pacotes ou a partir do código-fonte — não há plano pago nem chave de licença.
Install method | Command |
|---|---|
| macOS / Linux (script de instalação) | curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh |
| Windows (PowerShell) | irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex |
| Via uv | uv tool install nanobot-ai |
| Via pip | python -m pip install nanobot-ai |
| A partir do código-fonte | git clone github.com/HKUDS/nanobot, crie um ambiente virtual e depois pip install -e . |
| Docker / Docker Compose | Documentado no GitHub para implantação como serviço persistente — confira o arquivo compose do repositório. |
| Site e documentação | nanobot.wiki |
Requer Python 3.11 ou mais recente segundo o README do GitHub; Git e Bun só são necessários para uma instalação a partir do código-fonte. Após instalar, execute nanobot webui para a interface no navegador ou nanobot para o modo terminal.
Para quem o nanobot é indicado?
O nanobot é indicado para quem já roda ou chama um modelo de linguagem e quer memória persistente, acesso a ferramentas e automação em torno dele, em vez de um app de assistente empacotado e tudo-em-um.
Use o nanobot se você
- já tem acesso a uma API compatível com OpenAI, ou roda modelos locais via Ollama ou vLLM, e quer uma camada de agente por cima em vez de uma pilha de inferência completa
- quer um agente que lembre sessões anteriores em vez de começar do zero a cada conversa
- precisa conectar servidores de ferramentas MCP para que o agente atue em sistemas externos, não apenas responda perguntas
- quer acessar o mesmo agente por navegador, terminal e apps de chat como Telegram ou Slack, sem ficar preso a uma única interface
- se sente confortável auto-hospedando um serviço em Python e não busca um produto hospedado e gerenciado
Procure outra opção se você
- quer um único app de desktop para baixar sem configuração — o nanobot é um framework auto-hospedado, não um instalador de um clique para um produto pronto
- precisa de um produto apoiado por um fornecedor com contrato de suporte e SLA — esta análise não encontrou rodada de investimento nem empresa comercial por trás do nanobot
- não se sente confortável executando scripts de instalação, pacotes pip ou contêineres Docker
- quer um histórico longo e auditado de forma independente — o repositório do nanobot tem cerca de nove meses no momento desta análise
Para que o nanobot não é indicado
O nanobot não é uma boa escolha se você quer um app de assistente pronto e empacotado, ou se precisa de um histórico longo e verificado de forma independente antes de adotar uma ferramenta.
- Não é um motor de inferência — não tem exigência própria de GPU/VRAM, mas também não executa inferência de modelo por conta própria; você ainda precisa de Ollama, vLLM ou uma chave de API para o modelo que faz o raciocínio real
- Não é um app de desktop tudo-em-um polido — é um framework auto-hospedado que você configura, mais próximo do CrewAI ou do agent-zero em esforço de configuração do que de um app de chat de um clique
- Não é apoiado por uma rodada de investimento ou empresa que esta análise conseguiu verificar — trate-o como um projeto mantido de forma independente e conduzido pela comunidade
- Não está livre da ressalva sobre o número de estrelas mencionada acima — esta análise encontrou repositórios imitadores com texto de marketing idêntico em outras partes do GitHub, então verifique se você está olhando para github.com/HKUDS/nanobot especificamente antes de confiar em qualquer número de estrelas citado para "nanobot"
- Não é um projeto estabelecido há muito tempo — o repositório foi criado em 1º de fevereiro de 2026, então não tem o histórico de vários anos de frameworks como AutoGPT ou Open Interpreter
Erros comuns ao avaliar o nanobot
A maior parte da confusão sobre o nanobot vem de misturá-lo com um projeto sem relação de mesmo nome, ou de interpretar mal seus números de crescimento.
Erro 1: confundir com o nanobot-ai/nanobot
Um projeto do GitHub distinto e sem relação — nanobot-ai/nanobot, descrito como "Build MCP Agents" pela equipe Obot, criado por volta de 16 de maio de 2025, com cerca de 1.343 estrelas — compartilha o mesmo nome. Esta análise cobre apenas o HKUDS/nanobot; verifique o nome da organização na URL do GitHub antes de instalar qualquer um dos dois.
Erro 2: tratar o número de estrelas como um sinal de crescimento auditado
49.657 estrelas em um repositório criado em fevereiro de 2026 é incomumente rápido, e uma busca no GitHub traz repositórios imitadores usando a mesma descrição de marketing. O número de forks (8.700), issues abertas (868) e colaboradores (100+) sugere atividade majoritariamente orgânica, mas esta análise não auditou de forma independente o histórico de estrelas — verifique os números atuais diretamente no GitHub em vez de citar o retrato desta análise como atual.
Erro 3: esperar que o nanobot rode modelos por conta própria
O nanobot roda só em CPU porque não realiza inferência — ele chama uma API compatível com OpenAI, um servidor Ollama local ou um servidor vLLM local. Seus requisitos de hardware vêm do modelo de backend escolhido, não do nanobot.
Erro 4: presumir que existe um plano pago
O nanobot é gratuito e de código aberto sob a licença MIT, sem plano pago separado. Qualquer custo vem do modelo de backend ou da API à qual você o conecta.
Concorrentes e alternativas
O nanobot é mais frequentemente comparado a outros frameworks de agentes auto-hospedados como AutoGPT, Open Interpreter, agent-zero e CrewAI — seu principal diferencial é combinar memória persistente, ferramentas MCP, delegação multiagente e integrações de chat em um único framework, em vez de se especializar em apenas um desses aspectos.
Tool | Best known for | Link |
|---|---|---|
| AutoGPT | Um dos primeiros frameworks de agente autônomo, focado em cadeias de tarefas orientadas a objetivos | Análise do AutoGPT |
| Open Interpreter | Permite que um modelo execute código localmente para completar tarefas, popular pela simplicidade | Análise do Open Interpreter |
| agent-zero | Framework de agente de propósito geral auto-hospedado e baseado em Docker, com ambiente persistente | Análise do agent-zero |
| CrewAI | Framework de orquestração multiagente focado em equipes de agentes por função | Análise do CrewAI |
Esta lista reflete ferramentas comumente comparadas ao nanobot no mesmo segmento de frameworks de agentes auto-hospedados, não um ranking independente da PromptQuorum — verifique o conjunto de recursos atual de cada ferramenta antes de escolher.
Perguntas frequentes
O que é o nanobot?
nanobot (nanobot.wiki) é um framework de agente de IA pessoal gratuito, de código aberto (MIT) e auto-hospedado, desenvolvido pela HKUDS, que adiciona memória persistente, integração de ferramentas MCP, delegação multiagente e automação agendada a um modelo que você conectar.
O nanobot é gratuito?
Sim, o nanobot em si é gratuito e de código aberto sob a licença MIT, sem plano pago separado. Você paga apenas pelo modelo de backend ou API que conectar.
Como instalo o nanobot?
Segundo o nanobot.wiki e o README do GitHub: execute o script de instalação de uma linha para macOS/Linux ou Windows PowerShell, ou instale via pip install nanobot-ai ou uv tool install nanobot-ai. Requer Python 3.11 ou mais recente.
O nanobot roda seu próprio modelo de IA?
Não. O nanobot é um framework de agente, não um motor de inferência — ele chama uma API compatível com OpenAI, um servidor Ollama local ou um servidor vLLM local. Não tem exigência própria de GPU; as necessidades de hardware dependem do modelo de backend escolhido.
Com quais apps de chat o nanobot se integra?
Segundo a referência de apps de chat do repositório: entre outros, Telegram, Discord, Slack, Feishu, WhatsApp, WeChat, QQ, e-mail, Mattermost e Linear. O README também cita o Microsoft Teams, além da interface web e do modo terminal.
O nanobot é o mesmo que o nanobot-ai/nanobot?
Não. O nanobot-ai/nanobot é um projeto distinto, sem relação e menor, "Build MCP Agents" da equipe Obot (cerca de 1.343 estrelas, criado em 16 de maio de 2025). Esta análise trata exclusivamente do HKUDS/nanobot — verifique o nome da organização no GitHub antes de instalar.
Por que o nanobot tem tantas estrelas no GitHub para um projeto tão novo?
49.657 estrelas em um repositório criado em 1º de fevereiro de 2026 é incomumente rápido, e uma busca no GitHub encontra repositórios imitadores com texto de marketing idêntico. A proporção de forks de ~18%, as centenas de issues abertas e os 100+ colaboradores sugerem atividade majoritariamente orgânica, mas esta análise não auditou de forma independente o histórico de estrelas — verifique os números atuais diretamente no GitHub.
O que é o MCP e como o nanobot o usa?
MCP (Model Context Protocol) é um padrão que permite a um agente de IA se conectar a ferramentas e fontes de dados externas por meio de servidores dedicados. O nanobot se conecta a servidores MCP por uma interface "Apps" em sua WebUI, com integrações pré-configuradas e suporte para servidores personalizados.
O nanobot suporta fluxos de trabalho multiagente?
Sim. Segundo sua própria documentação, ele pode delegar subtarefas a outros agentes em vez de tratar cada etapa dentro de um único loop de agente.
A PromptQuorum testou de forma independente as afirmações do nanobot?
Esta análise se baseia no README do GitHub do nanobot, na documentação do nanobot.wiki e na API do GitHub, em vez de testes práticos de memória ou desempenho multiagente realizados pela PromptQuorum.
O nanobot suporta cache de prompts (prompt caching)?
Não como recurso documentado. O README e o guia de configuração não mencionam cache_control nem o prompt caching da Anthropic. O único trecho relacionado é "cache reuse when the provider reports it" no indicador de contexto da WebUI, mais uma nota de que os acertos de cache "still depend on the provider". Confira a documentação do seu provedor de modelos antes de supor que o cache é aplicado.
O nanobot suporta WhatsApp?
Sim, segundo a referência de apps de chat do repositório: um canal de WhatsApp vinculado por QR code (nanobot channels login whatsapp) e um canal separado, WhatsApp Agent Platform, que usa um token de API de agente. O README não cita o WhatsApp; por isso, confira a documentação da versão que você instalar.
O nanobot oferece streaming de respostas?
Em parte, segundo a referência de apps de chat e o guia de configuração, não o README. As respostas no Discord e no Feishu são transmitidas por streaming por padrão (streaming vale true por padrão), e as chamadas ao modelo usam um tempo limite de inatividade de stream de 90 segundos (NANOBOT_STREAM_IDLE_TIMEOUT_S). As páginas lidas por esta review não dizem se todos os outros canais transmitem token a token.
O nanobot suporta imagens e arquivos (multimodal)?
Documentado em parte. A WebUI permite anexar documentos ou imagens, o terminal aceita imagens coladas da área de transferência e a lista de ferramentas inclui geração de imagens. Quais entradas de imagem realmente funcionam depende do modelo de backend conectado, já que o próprio nanobot não executa inferência.
Qual é a arquitetura do nanobot?
Segundo o README, um gateway em Python cuida da execução de agentes, das sessões, das ferramentas, da memória e da política de segurança, e a WebUI, o terminal e os apps de chat são clientes desse mesmo runtime. O laço central do agente monta o contexto, chama o modelo, executa as ferramentas solicitadas e devolve o resultado. O nanobot não executa modelos por conta própria: ele chama uma API compatível com OpenAI, um servidor Ollama local ou um servidor vLLM local.
O nanobot tem benchmarks?
O README do nanobot não afirma nenhum benchmark, e a PromptQuorum não executou nenhum. Trate qualquer número de desempenho citado em outro lugar para o nanobot como não verificado.