Seu assistente de IA 100% local, privado e ultra-leve em menos de 10 minutos
Você está prestes a descobrir como rodar uma inteligência artificial completa na sua máquina, sem pagar um centavo de API, sem enviar seus dados para nuvem, sem depender de conexão com internet. Enquanto todo mundo corre para os serviços pagos do ChatGPT e Claude, uma revolução silenciosa acontece nos bastidores: a era da IA local, privada e soberana.
O Nanobot é o segredo mais bem guardado dos desenvolvedores que entendem onde o futuro está indo. Com apenas 4.000 linhas de código, ele rivaliza com assistentes enterprise que custam milhares de dólares por mês. Integrado ao Ollama, ele transforma seu computador em um data center pessoal de IA, capaz de processar textos, gerar código, analisar dados e automatizar tarefas complexas sem nunca tocar em um servidor externo.
Pense nas implicações. Seus dados sensíveis nunca mais saem do seu hardware. Suas conversas confidenciais não treinam modelos de big techs. Seus projetos proprietários permanecem sob seu controle absoluto. E o melhor: zero custos recorrentes. Você paga uma vez pelo hardware e usa para sempre.
Neste guia, vou te mostrar exatamente como instalar essa stack poderosa em menos de 10 minutos. Do download à primeira conversa, passo a passo, sem suposições, sem complicação. Seja você um desenvolvedor experiente ou alguém curioso sobre o próximo capítulo da computação, este é o seu ponto de entrada para a independência digital.
Prepare sua máquina. A revolução da IA local começa agora.
0 O Que Você Vai Construir
O Nanobot é um assistente de IA open-source ultra-leve, com apenas 4.000 linhas de código, que rivaliza com soluções enterprise. Integrado ao Ollama, ele permite rodar modelos de linguagem completamente offline, sem enviar dados para nuvem, sem custos de API e com total controle sobre suas informações.
1 Requisitos do Sistema
2 Instalar o Ollama
Baixar e instalar o Ollama
O Ollama é a engine que permite rodar modelos de IA localmente. A instalação é simples e direta.
curl -fsSL https://ollama.com/install.sh | sh
# Baixe o instalador em: # https://ollama.com/download/windows # Ou via winget: winget install Ollama.Ollama
ollama --version
Baixar um modelo de IA
Escolha um modelo baseado no seu hardware. Quanto maior o modelo, melhor a qualidade, mas mais RAM necessária.
| Modelo | Parâmetros | RAM Necessária | Comando |
|---|---|---|---|
| Llama 3.2 | 3B | 8GB | ollama pull llama3.2 |
| Llama 3.1 | 8B | 16GB | ollama pull llama3.1 |
| Mistral | 7B | 16GB | ollama pull mistral |
| Gemma 2 | 9B | 16GB | ollama pull gemma2 |
ollama pull llama3.2
ollama run llama3.2 (digite /bye para sair)
Iniciar o servidor Ollama
O Nanobot se comunica com o Ollama via API local. Certifique-se de que o servidor está rodando.
ollama serve
http://localhost:11434. Mantenha esta janela aberta ou execute em segundo plano.3 Instalar o Nanobot
Opção A: Instalar via pip (Recomendado)
pip install nanobot-ai
Opção B: Instalar via uv (Mais rápido)
O uv é um gerenciador de pacotes Python ultrarrápido. Ideal se você já usa em seu workflow.
# Instalar uv primeiro curl -LsSf https://astral.sh/uv/install.sh | sh # Instalar nanobot uv tool install nanobot-ai
Opção C: Instalar do código-fonte (Últimas features)
git clone https://github.com/HKUDS/nanobot.git cd nanobot pip install -e .
nanobot --version deve mostrar a versão instalada
4 Configurar o Nanobot para Ollama
Inicializar a configuração
nanobot onboard
Este comando cria a estrutura de diretórios e arquivos de configuração em ~/.nanobot/.
Editar arquivo de configuração
Abra o arquivo ~/.nanobot/config.json no seu editor preferido e configure para usar o Ollama local.
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434",
"model": "llama3.2"
}
},
"agents": {
"defaults": {
"model": "ollama/llama3.2",
"temperature": 0.7
}
},
"tools": {
"web": {
"search": {
"enabled": false
}
},
"shell": {
"enabled": true
},
"file": {
"enabled": true
}
}
}
llama3.2 pelo modelo que você baixou no passo 2. Se baixou mistral ou gemma2, atualize em ambos os lugares.5 Testar a Instalação
Executar comando de teste
nanobot agent -m "Olá! Você está funcionando completamente offline?"
Se tudo estiver correto, você verá uma resposta gerada localmente pelo seu modelo Ollama, sem nenhuma chamada de API externa.
Modo interativo (chat contínuo)
nanobot agent
Este modo inicia um chat interativo onde você pode fazer múltiplas perguntas. Digite exit ou pressione Ctrl+C para sair.
Verificar status do sistema
nanobot status
Mostra informações sobre o provedor ativo, modelo em uso e ferramentas disponíveis.
6 Configurar Modo Gateway (Acesso Web/Telegram)
Iniciar o gateway web
O modo gateway permite acessar o Nanobot via navegador, Telegram, Discord ou outros canais.
nanobot gateway
O gateway ficará disponível em http://localhost:18790 por padrão.
config.json e adicione as credenciais dos canais desejados na seção channels.7 Solução de Problemas Comuns
Erro: “Connection refused” ao conectar no Ollama
O servidor Ollama não está rodando ou está em porta diferente.
# Verifique se ollama está rodando ollama list # Se não estiver, inicie em outro terminal ollama serve # Ou inicie em background (Linux/macOS) ollama serve &
Erro: Modelo não encontrado
O modelo configurado no Nanobot não foi baixado no Ollama.
# Liste modelos disponíveis ollama list # Baixe o modelo configurado (exemplo: llama3.2) ollama pull llama3.2
Lentidão nas respostas
Modelos grandes em hardware limitado podem ser lentos.
llama3.2:1b ou phi3:mini para maior velocidade. A qualidade será menor, mas a resposta será instantânea.8 Próximos Passos
Agora que você tem um assistente de IA 100% local funcionando, explore as possibilidades:
Nanobot + Ollama vs OpenClaw: Qual Assistente Local Escolher em 2026?
A revolução da IA local não tem um único protagonista. Enquanto o Nanobot conquista desenvolvedores pela simplicidade brutal, o OpenClaw (anteriormente Moltbot/Clawdbot) viralizou como o assistente pessoal que “realmente faz coisas”. Entender as diferenças entre eles é essencial para escolher a ferramenta certa para seu workflow.
O Nanobot é minimalismo radical. Cerca de 4.000 linhas de código, foco em execução local via Ollama, e uma filosofia de “fazer uma coisa e fazer bem”. Ele é o canivete suíço para quem quer processar linguagem natural sem complexidade.
O OpenClaw é uma plataforma completa. Com 68.000 estrelas no GitHub e crescimento explosivo em 2026, ele conecta não apenas modelos locais, mas dezenas de integrações externas, canais de mensagem (WhatsApp, Telegram, Discord), e uma arquitetura de “skills” que permite ao agente aprender e criar novas capacidades automaticamente.
Comparativo Técnico Direto
| Dimensão | Nanobot + Ollama | OpenClaw |
|---|---|---|
| Tamanho do código | ~4.000 linhas | ~100.000+ linhas |
| Foco principal | Execução local de LLMs | Assistente pessoal multi-canal |
| Integrações nativas | Limitadas (extensível via código) | 50+ integrações, 100+ AgentSkills |
| Canais de chat | Interface web/local | WhatsApp, Telegram, Discord, Slack, iMessage |
| Execução de código | Sim, via shell | Sim, com sandbox e browser automation |
| Memória persistente | Básica | Avançada (arquivos Markdown locais) |
| Automação proativa | Não | Sim (agendamentos, gatilhos) |
| Custo | Gratuito (apenas hardware) | Gratuito (open source), mas consome APIs pagas se usar Claude/GPT |
| Curva de aprendizado | Baixa (instalação em 10 min) | Média (configuração de canais e skills) |
| Hardware mínimo | 8GB RAM | 8GB RAM (16GB recomendado) |
Quando Escolher Nanobot + Ollama
A escolha pelo Nanobot faz sentido quando você quer total controle com mínima sobrecarga. Desenvolvedores que precisam integrar IA em pipelines específicos, sem a complexidade de gerenciar múltiplos canais de comunicação, encontram no Nanobot a ferramenta ideal.
Se seu caso de uso envolve principalmente: processar textos localmente, gerar código, analisar documentos, ou criar automações específicas via script, o Nanobot entrega exatamente isso sem adicionar camadas desnecessárias. A integração direta com Ollama significa que você pode trocar modelos (Llama, Mistral, Gemma) instantaneamente, sem reconfigurar todo um ecossistema.
A privacidade absoluta é outro fator decisivo. Sem integrações externas obrigatórias, seus dados nunca tocam um servidor fora da sua máquina. Para empresas com dados sensíveis ou profissionais em regiões com restrições de compliance, essa simplicidade é uma vantagem de segurança.
Quando Escolher OpenClaw
O OpenClaw brilha quando você quer um assistente pessoal completo, não apenas uma ferramenta de processamento de linguagem. A capacidade de receber mensagens no WhatsApp ou Telegram e executar tarefas complexas no seu computador transforma a experiência de “usar IA” para “ter um assistente”.
A arquitetura de AgentSkills é o diferencial técnico. O OpenClaw pode escrever código para si mesmo, criando novas habilidades conforme necessidade. Enquanto o Nanobot executa o que você programa, o OpenClaw pode evoluir suas próprias capacidades.
Para quem gerencia múltiplos projetos, a memória persistente em arquivos Markdown locais permite que o assistente lembre preferências, contextos de conversas anteriores, e detalhes específicos do seu workflow. Isso cria uma experiência de continuidade impossível em ferramentas stateless.
A automação proativa é outro território exclusivo. O OpenClaw pode agendar tarefas, monitorar condições, e agir sem comando explícito. Enquanto o Nanobot responde perguntas, o OpenClaw pode avisar que um deploy falhou, sugerir reuniões baseadas em padrões de e-mail, ou lembrar deadlines antes que você pergunte.
