中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English
Rhizome é um hard fork mantido pela comunidade do PicoClaw. É escrito inteiramente em Go e continua com o objetivo de ser um assistente de IA pessoal ultra-leve.
Rhizome é um assistente de IA pessoal ultra-leve inspirado no NanoBot. Ele adiciona uma mesh P2P Go, sincronização de workspace e um gateway de agentes por cima da ideia original do PicoClaw.
Um único binário Go, sem dependências de runtime — roda nativamente em Linux, Windows, macOS, FreeBSD/NetBSD e Android. Veja a Lista de Compatibilidade de Hardware para placas verificadas e os requisitos de recursos atuais dos dois níveis.
Caution
Aviso de Segurança
- SEM CRIPTO: O Rhizome não emitiu nenhum token oficial ou criptomoeda. Todas as alegações no
pump.funou outras plataformas de negociação são golpes. - FONTE CANÔNICA (CANONICAL SOURCE): A fonte e o local de lançamento canônicos são https://github.com/stpinkie/rhizome; os releases são publicados no GitHub Releases. Cuidado com domínios de terceiros que afirmam ser oficiais.
- ATENÇÃO: Muitos domínios
.ai/.org/.com/.net/...foram registrados por terceiros. Não confie neles. - NOTA: O Rhizome está em desenvolvimento rápido inicial. Podem existir problemas de segurança não resolvidos. Não implante em produção antes da v1.0.
- NOTA: O binário
rhizomecompleto tem cerca de 98 MB e o daemon usa cerca de 60 MB de memória privada. A otimização de recursos está planejada após a estabilização de funcionalidades.
2026-09-07 🌐 v0.7.0 — Modo Swarm adiciona grupos nomeados de peers confiáveis com coordenação por envelopes assinados (/rhizome/swarm/1.0.0): presença e gossip de roster, fila de trabalho offer/claim, eleição determinística de coordenador com estado compartilhado sincronizado via workspace, orquestração de objetivos (rhizome swarm run), painel Swarms no dashboard Network e transporte GossipSub opcional. Veja as notas de versão v0.7.0 (em inglês).
2026-09-05–08 🌐 v0.5.0–v0.6.2 — Mesh: NAT traversal, tarefas remotas assíncronas, segurança mesh reforçada (manifestos assinados, ACLs, trilha de auditoria), dashboard Network, pontuação de peers e failover de tarefas. Notas de versão: v0.5.0–v0.6.2.
2026-09-01–04 🚀 v0.4.x — Portabilidade: builds linux/386, windows/386, linux/armv7, Android nativo (arm64/arm/386/amd64), transportes P2P reforçados para Linux 3.4 / Android 4.4, API de status de rede e providers locais (Ollama, vLLM, LM Studio).
2026-05-28 🚀 v0.2.9 Lançada! Gerenciamento de MCP server na Web UI, busca na web via Sogou configurável, animação de feedback de ferramenta nos channels, padrões pretty_print e disable_escape_html, e diversas correções de bugs em providers e channels.
2026-05-14 🚀 v0.2.8 Lançada! Comandos MCP CLI (show, add, list, remove, test, edit), objeto vazio ao invés de null para parâmetros de ferramentas MCP, e correções de build.
2026-05-07 🚀 v0.2.7 Lançada! Busca na web via Sogou configurável, animação de feedback de ferramenta nos channels, correções de linter.
2026-04-23 🚀 v0.2.6 Lançada! Hooks com ação de respond e documentação abrangente, suporte a isolamento, correção de banner de ajuda.
2026-04-11 🚀 v0.2.5 Lançada! Zoneinfo a partir das variáveis de ambiente TZ/ZONEINFO, alinhamento de renderização Matrix CommonMark, read_file por linhas.
2026-03-31 📱 Suporte Android! Rhizome agora roda no Android! O APK Android não é publicado neste fork; compile a partir do código-fonte ou verifique os GitHub Releases para uma APK futura.
2026-03-25 🚀 v0.2.4 Lançada! Reformulação da arquitetura Agent (SubTurn, Hooks, Steering, EventBus), integração WeChat/WeCom, fortalecimento de segurança (.security.yml, filtragem de dados sensíveis), novos providers (AWS Bedrock, Azure, Xiaomi MiMo) e 35 correções de bugs. O Rhizome atingiu 26K Stars!
2026-03-17 🚀 v0.2.3 Lançada! UI na bandeja do sistema (Windows e Linux), consulta de status de sub-agent (spawn_status), hot-reload experimental do Gateway, controle de segurança do Cron e 2 correções de segurança. O Rhizome atingiu 25K Stars!
2026-03-09 🎉 v0.2.1 — Maior atualização até agora! Suporte ao protocolo MCP, 4 novos channels (Matrix/IRC/WeCom/Discord Proxy), 3 novos providers (Kimi/Minimax/Avian), pipeline de visão, armazenamento de memória JSONL, roteamento de modelos.
2026-02-28 📦 v0.2.0 lançada com suporte a Docker Compose e Web UI Launcher.
Notícias anteriores...
2026-02-26 🎉 O Rhizome atinge 20K Stars em apenas 17 dias! Orquestração automática de channels e interfaces de capacidade estão disponíveis.
2026-02-16 🎉 O Rhizome ultrapassa 12K Stars em uma semana! Funções de mantenedor da comunidade e Roadmap lançados oficialmente.
2026-02-13 🎉 O Rhizome ultrapassa 5000 Stars em 4 dias! Roadmap do projeto e grupos de desenvolvedores em andamento.
2026-02-09 🎉 Rhizome Lançado! Construído em 1 dia para explorar AI Agents ultra-leves. Let's Go, Rhizome!
🪶 Binário único, sem dependências de runtime: Um executável Go estaticamente vinculado que roda em Linux, Windows, macOS, FreeBSD/NetBSD e Android.*
💰 Custo mínimo: Eficiente o suficiente para rodar em uma ampla gama de placas ARM e RISC-V de baixo custo; veja a Lista de Compatibilidade de Hardware.
⚡️ Boot ultrarrápido: Inicializa em menos de 1s nas placas de baixo custo verificadas.
🌍 Verdadeiramente portátil: Binário único para arquiteturas RISC-V, ARM, MIPS e x86. Um binário, roda em qualquer lugar!
🤖 Bootstrapped por IA: Implementação nativa pura em Go — 95% do código principal foi gerado por um Agent e refinado por revisão humana.
🔌 Suporte a MCP: Integração nativa com o Model Context Protocol — conecte qualquer servidor MCP para estender as capacidades do Agent.
👁️ Pipeline de visão: Envie imagens e arquivos diretamente ao Agent — codificação base64 automática para LLMs multimodais.
🧠 Roteamento inteligente: Roteamento de modelos baseado em regras — consultas simples vão para modelos leves, economizando custos de API.
*A medição de footprint foi feita no Windows com CGO_ENABLED=0, tags goolm,stdjson e -ldflags "-s -w"; o binário stripado tem cerca de 98 MB.
| Modo | Caso de uso | RAM Total | RAM Livre | Armazenamento |
|---|---|---|---|---|
| Base | rhizome agent, rhizome onboard one-shot |
256 MB | 128 MB | 128 MB |
| Completo | rhizome daemon com P2P, syncer e gateway |
512 MB | 256 MB | 128 MB |
Lista de Compatibilidade de Hardware — Veja todas as placas testadas, do Raspberry Pi a celulares Android. Sua placa não está listada? Envie um PR!
Modo Engenheiro Full-Stack |
Registro e Planejamento |
Busca na Web e Aprendizado |
|---|---|---|
| Desenvolver · Implantar · Escalar | Agendar · Automatizar · Lembrar | Descobrir · Insights · Tendências |
O Rhizome pode ser implantado em uma ampla gama de dispositivos Linux e embarcados!
- $15 Raspberry Pi Zero (ou Zero 2 W), para um assistente doméstico mínimo
- $50~70 CanMV-K230, para uso embarcado baseado em RISC-V
- $100 NanoKVM-Pro, para operações automatizadas de servidor
- $100 MaixCAM2, para vigilância inteligente
Veja a Lista de Compatibilidade de Hardware para a lista completa de placas verificadas e os requisitos atuais dos dois níveis.
picoclaw_detect_person.mp4
🌟 Mais Casos de Implantação Aguardam!
Visite a página GitHub Releases e baixe o binário para sua plataforma.
Alternativamente, baixe o binário para sua plataforma na página de GitHub Releases.
Pré-requisitos:
- Go 1.26+
- Node.js 22+ e pnpm 10.33.0+ para builds do Web UI / launcher
git clone https://github.com/stpinkie/rhizome.git
cd rhizome
make deps
# Instalar dependências do frontend
(cd web/frontend && pnpm install --frozen-lockfile)
# Build o binário principal para a plataforma atual
make build
# Build o Web UI Launcher (necessário para o modo WebUI)
make build-launcher
# Build os binários principais para todas as plataformas gerenciadas pelo Makefile
make build-all
# Build para Raspberry Pi Zero 2 W
# 32-bit: make build-linux-arm
# 64-bit: make build-linux-arm64
make build-pi-zero
# Build e instalação
make installRaspberry Pi Zero 2 W: Use o binário que corresponde ao seu SO: Raspberry Pi OS 32-bit -> make build-linux-arm; 64-bit -> make build-linux-arm64. Ou execute make build-pi-zero para buildar ambos.
O WebUI Launcher fornece uma interface baseada em navegador para configuração e chat. Esta é a maneira mais fácil de começar — sem necessidade de conhecimento de linha de comando.
Opção 1: Duplo clique (Desktop)
Após baixar do GitHub Releases, dê duplo clique em rhizome-launcher (ou rhizome-launcher.exe no Windows). Seu navegador abrirá automaticamente em http://localhost:18800.
Opção 2: Linha de comando
rhizome-launcher
# Abra http://localhost:18800 no seu navegadorTip
Acesso remoto / Docker / VM: Adicione a flag -public para escutar em todas as interfaces:
rhizome-launcher -publicPrimeiros passos:
Abra o WebUI e então: 1) Configure um Provider (adicione sua API key de LLM) → 2) Configure um Channel (ex.: Telegram) → 3) Inicie o Gateway → 4) Converse!
Para documentação detalhada, veja a pasta docs/ neste repo.
Docker (alternativa)
# 1. Clone este repositório
git clone https://github.com/stpinkie/rhizome.git
cd rhizome
# 2. Primeira execução — gera docker/data/config.json automaticamente e sai
# (só dispara quando ambos config.json e workspace/ estão ausentes)
docker compose -f docker/docker-compose.yml --profile launcher up
# O container imprime "First-run setup complete." e para.
# 3. Configure suas API keys
vim docker/data/config.json
# 4. Inicie
docker compose -f docker/docker-compose.yml --profile launcher up -d
# Abra http://localhost:18800Usuários de Docker / VM: O Gateway escuta em
127.0.0.1por padrão. DefinaRHIZOME_GATEWAY_HOST=0.0.0.0ou use a flag-publicpara torná-lo acessível a partir do host.
# Ver logs
docker compose -f docker/docker-compose.yml logs -f
# Parar
docker compose -f docker/docker-compose.yml --profile launcher down
# Atualizar
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -dmacOS — Aviso de segurança no primeiro lançamento
O macOS pode bloquear o rhizome-launcher no primeiro lançamento porque ele é baixado da internet e não é notarizado pela Mac App Store.
Passo 1: Dê duplo clique em rhizome-launcher. Você verá um aviso de segurança:
"rhizome-launcher" Não Aberto — A Apple não pôde verificar se "rhizome-launcher" está livre de malware que pode prejudicar o seu Mac ou comprometer sua privacidade.
Passo 2: Abra Configurações do Sistema → Privacidade & Segurança → role para baixo até a seção Segurança → clique em Abrir Mesmo Assim → confirme clicando em Abrir Mesmo Assim na caixa de diálogo.
Após este passo único, o rhizome-launcher abrirá normalmente em lançamentos subsequentes.
Dê uma segunda vida ao seu celular de uma década! Transforme-o em um Assistente de IA inteligente com o Rhizome.
Opção 1: Instalação via APK
Pré-visualização:
![]() |
![]() |
![]() |
![]() |
O APK Android ainda não é publicado neste fork; compile a partir do código-fonte ou verifique os GitHub Releases para uma APK futura.
Opção 2: Termux
Para uma lista de verificação completa de configuração via linha de comando, veja o Guia Android Termux.
Terminal Launcher (para ambientes com recursos limitados)
- Instale o Termux (baixe do GitHub Releases, ou procure em F-Droid / Google Play)
- Execute os seguintes comandos:
# Baixe o release mais recente
wget https://github.com/stpinkie/rhizome/releases/latest/download/rhizome_Linux_arm64.tar.gz
tar xzf rhizome_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./rhizome onboard # chroot fornece um layout padrão de sistema de arquivos LinuxDepois siga a seção Terminal Launcher abaixo para completar a configuração.
Para ambientes mínimos onde apenas o binário principal rhizome está disponível (sem Launcher UI), você pode configurar tudo via linha de comando e um arquivo de configuração JSON.
1. Inicializar
rhizome onboardIsso cria ~/.rhizome/config.json e o diretório de workspace.
2. Configurar (~/.rhizome/config.json)
{
"agents": {
"defaults": {
"model_name": "gpt-5.4"
}
},
"model_list": [
{
"model_name": "gpt-5.4",
"model": "openai/gpt-5.4"
// api_key agora é carregado de .security.yml
}
]
}Veja
config/config.example.jsonno repo para um modelo de configuração completo com todas as opções disponíveis.Observe: config.example.json está no formato version 0, com códigos sensíveis, e será migrado automaticamente para version 1+; então config.json armazenará apenas dados não sensíveis, e os códigos sensíveis ficarão em .security.yml. Se precisar modificar os códigos manualmente, veja
docs/security/security_configuration.md.
3. Conversar
# Uma pergunta única
rhizome agent -m "What is 2+2?"
# Modo interativo
rhizome agent
# Inicie o gateway para integração com app de chat
rhizome gatewayO Rhizome suporta mais de 30 providers de LLM através da configuração model_list. Use o formato protocolo/modelo:
| Provider | Protocolo | API Key | Notas |
|---|---|---|---|
| OpenAI | openai/ |
Obrigatória | GPT-5.4, GPT-4o, o3, etc. |
| Anthropic | anthropic/ |
Obrigatória | Claude Opus 4.6, Sonnet 4.6, etc. |
| Google Gemini | gemini/ |
Obrigatória | Gemini 3 Flash, 2.5 Pro, etc. |
| OpenRouter | openrouter/ |
Obrigatória | 200+ modelos, API unificada |
| Zhipu (GLM) | zhipu/ |
Obrigatória | GLM-4.7, GLM-5, etc. |
| DeepSeek | deepseek/ |
Obrigatória | DeepSeek-V3, DeepSeek-R1 |
| Volcengine | volcengine/ |
Obrigatória | Modelos Doubao, Ark |
| Qwen | qwen/ |
Obrigatória | Qwen3, Qwen-Max, etc. |
| Groq | groq/ |
Obrigatória | Inferência rápida (Llama, Mixtral) |
| Moonshot (Kimi) | moonshot/ |
Obrigatória | Modelos Kimi |
| Minimax | minimax/ |
Obrigatória | Modelos MiniMax |
| Mistral | mistral/ |
Obrigatória | Mistral Large, Codestral |
| NVIDIA NIM | nvidia/ |
Obrigatória | Modelos hospedados pela NVIDIA |
| Cerebras | cerebras/ |
Obrigatória | Inferência rápida |
| Novita AI | novita/ |
Obrigatória | Vários modelos abertos |
| Xiaomi MiMo | mimo/ |
Obrigatória | Modelos MiMo |
| Ollama | ollama/ |
Não necessária | Modelos locais, self-hosted |
| vLLM | vllm/ |
Não necessária | Implantação local, compatível com OpenAI |
| LiteLLM | litellm/ |
Varia | Proxy para 100+ providers |
| Azure OpenAI | azure/ |
Obrigatória | Implantação Azure Enterprise |
| GitHub Copilot | github-copilot/ |
OAuth | Login por código de dispositivo |
| Antigravity | antigravity/ |
OAuth | Google Cloud AI |
Implantação local (Ollama, vLLM, etc.)
Ollama:
{
"model_list": [
{
"model_name": "local-llama",
"model": "ollama/llama3.1:8b",
"api_base": "http://localhost:11434/v1"
}
]
}vLLM:
{
"model_list": [
{
"model_name": "local-vllm",
"model": "vllm/your-model",
"api_base": "http://localhost:8000/v1"
}
]
}Para detalhes completos de configuração de providers, veja Providers & Models.
Converse com seu Rhizome por meio de mais de 17 plataformas de mensagens:
| Channel | Configuração | Protocolo | Docs |
|---|---|---|---|
| Telegram | Fácil (bot token) | Long polling | Guia |
| Discord | Fácil (bot token + intents) | WebSocket | Guia |
| Fácil (QR scan ou bridge URL) | Nativo / Bridge | Guia | |
| Weixin | Fácil (scan QR nativo) | iLink API | Guia |
| Fácil (AppID + AppSecret) | WebSocket | Guia | |
| Slack | Fácil (bot + app token) | Socket Mode | Guia |
| Matrix | Médio (homeserver + token) | Sync API | Guia |
| Feishu / Lark | Médio (App ID + Secret) | WebSocket/SDK | Guia |
| LINE | Médio (credenciais + webhook) | Webhook | Guia |
| WeCom | Fácil (login QR ou manual) | WebSocket | Guia |
| IRC | Médio (servidor + nick) | Protocolo IRC | Guia |
| OneBot | Médio (WebSocket URL) | OneBot v11 | Guia |
| MaixCam | Fácil (habilitar) | TCP socket | Guia |
| Pico | Fácil (habilitar) | Protocolo nativo | Integrado |
| Pico Client | Fácil (WebSocket URL) | WebSocket | Integrado |
Todos os channels baseados em webhook compartilham um único servidor HTTP do Gateway (
gateway.host:gateway.port, padrão127.0.0.1:18790). O Feishu usa modo WebSocket/SDK e não utiliza o servidor HTTP compartilhado.
A verbosidade dos logs é controlada por
gateway.log_level(padrão:warn). Valores suportados:debug,info,warn,error,fatal. Também pode ser definido viaRHIZOME_LOG_LEVEL. Veja Configuração para detalhes.
Para instruções detalhadas de configuração de channels, veja Configuração de Apps de Chat.
O Rhizome pode pesquisar na web para fornecer informações atualizadas. Configure em tools.web:
| Motor de Busca | API Key | Nível Gratuito | Link |
|---|---|---|---|
| DuckDuckGo | Não necessária | Ilimitado | Fallback integrado |
| Baidu Search | Obrigatória | 1500 consultas/mês (alocação diária) | IA, otimizado para chinês |
| Tavily | Obrigatória | 1000 consultas/mês | Otimizado para AI Agents |
| Brave Search | Obrigatória | 2000 consultas/mês | Rápido e privado |
| Perplexity | Obrigatória | Pago | Busca com IA |
| SearXNG | Não necessária | Self-hosted | Metabuscador gratuito |
| GLM Search | Obrigatória | Varia | Busca web Zhipu |
O Rhizome inclui ferramentas integradas para operações de arquivo, execução de código, agendamento e mais. Veja Configuração de Ferramentas para detalhes.
Skills são capacidades modulares que estendem seu Agent. Elas são carregadas a partir de arquivos SKILL.md no seu workspace.
Instalar skills do ClawHub:
rhizome skills search "web scraping"
rhizome skills install <skill-name>Configurar token do ClawHub (opcional, para limites de taxa mais altos):
Adicione ao seu config.json:
{
"tools": {
"skills": {
"registries": {
"clawhub": {
"auth_token": "your-clawhub-token"
}
}
}
}
}Para mais detalhes, veja Configuração de Ferramentas - Skills.
O Rhizome suporta nativamente o MCP — conecte qualquer servidor MCP para estender as capacidades do seu Agent com ferramentas externas e fontes de dados.
{
"tools": {
"mcp": {
"enabled": true,
"servers": {
"filesystem": {
"enabled": true,
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}
}
}Para configuração completa de MCP (transportes stdio, SSE, HTTP, Tool Discovery), veja Configuração de Ferramentas - MCP.
Conecte o Rhizome à Rede Social de Agents simplesmente enviando uma única mensagem via CLI ou qualquer App de Chat integrado.
Leia https://clawdchat.ai/skill.md e siga as instruções para entrar no ClawdChat.ai
| Comando | Descrição |
|---|---|
rhizome onboard |
Inicializar config e workspace |
rhizome auth weixin |
Conectar conta WeChat via QR |
rhizome agent -m "..." |
Conversar com o agent |
rhizome agent |
Modo de chat interativo |
rhizome gateway |
Iniciar o gateway |
rhizome status |
Exibir status |
rhizome version |
Exibir informações de versão |
rhizome model |
Ver ou trocar o modelo padrão |
rhizome cron list |
Listar todos os jobs agendados |
rhizome cron add ... |
Adicionar um job agendado |
rhizome cron disable |
Desabilitar um job agendado |
rhizome cron remove |
Remover um job agendado |
rhizome skills list |
Listar skills instaladas |
rhizome skills install |
Instalar uma skill |
rhizome migrate |
Migrar dados de versões anteriores |
rhizome auth login |
Autenticar com providers |
O Rhizome suporta lembretes agendados e tarefas recorrentes através da ferramenta cron:
- Lembretes únicos: "Lembre-me em 10 minutos" -> dispara uma vez após 10min
- Tarefas recorrentes: "Lembre-me a cada 2 horas" -> dispara a cada 2 horas
- Expressões cron: "Lembre-me às 9h diariamente" -> usa expressão cron
Para guias detalhados além deste README:
| Tópico | Descrição |
|---|---|
| Docker & Início Rápido | Configuração do Docker Compose, modos Launcher/Agent |
| Apps de Chat | Guias de configuração para todos os 17+ channels |
| Configuração | Variáveis de ambiente, layout do workspace, sandbox de segurança |
| Providers & Models | 30+ providers de LLM, roteamento de modelos, configuração de model_list |
| Spawn & Tarefas Assíncronas | Tarefas rápidas, tarefas longas com spawn, orquestração assíncrona de sub-agents |
| Hooks | Sistema de hooks orientado a eventos: observadores, interceptores, hooks de aprovação |
| Steering | Injetar mensagens em um loop de agente em execução |
| SubTurn | Coordenação de subagentes, controle de concorrência, ciclo de vida |
| Solução de Problemas | Problemas comuns e soluções |
| Configuração de Ferramentas | Habilitar/desabilitar por ferramenta, políticas de exec, MCP, Skills |
| Compatibilidade de Hardware | Placas testadas, requisitos mínimos |
PRs são bem-vindos! O código-fonte é intencionalmente pequeno e legível.
Veja nosso Roadmap da Comunidade e CONTRIBUTING.md para diretrizes.
Grupo de desenvolvedores em formação, entre após seu primeiro PR mesclado!
Grupos de Usuários:
Discord: https://discord.gg/V4sAZ9XWpN












