Skip to content

Latest commit

 

History

History
617 lines (440 loc) · 30 KB

README.pt-br.md

File metadata and controls

617 lines (440 loc) · 30 KB
Rhizome

Rhizome: Seu Agente de IA, em Qualquer Lugar

Any Machine · Single Binary · ms Boot · Let's Go, Rhizome!

Go Hardware License
GitHub Docs Discord

中文 | 日本語 | 한국어 | 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.fun ou 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 rhizome completo 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.

📢 Novidades

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!

✨ Funcionalidades

🪶 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.

Footprint Atual da Build

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!

Rhizome Hardware Compatibility

🦾 Demonstração

🛠️ Fluxos de Trabalho Padrão do Assistente

Modo Engenheiro Full-Stack

Registro e Planejamento

Busca na Web e Aprendizado

Desenvolver · Implantar · Escalar Agendar · Automatizar · Lembrar Descobrir · Insights · Tendências

🐜 Implantação Inovadora de Baixo Consumo

O Rhizome pode ser implantado em uma ampla gama de dispositivos Linux e embarcados!

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!

📦 Instalação

Download pelo GitHub Releases (Recomendado)

Visite a página GitHub Releases e baixe o binário para sua plataforma.

Download do binário pré-compilado

Alternativamente, baixe o binário para sua plataforma na página de GitHub Releases.

Compilar a partir do código-fonte (para desenvolvimento)

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 install

Raspberry 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.

🚀 Guia de Início Rápido

🌐 WebUI Launcher (Recomendado para Desktop)

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 navegador

Tip

Acesso remoto / Docker / VM: Adicione a flag -public para escutar em todas as interfaces:

rhizome-launcher -public

WebUI Launcher

Primeiros 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:18800

Usuários de Docker / VM: O Gateway escuta em 127.0.0.1 por padrão. Defina RHIZOME_GATEWAY_HOST=0.0.0.0 ou use a flag -public para 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 -d
macOS — 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:

Aviso do macOS Gatekeeper

"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.

macOS Privacidade & Segurança — Abrir Mesmo Assim

Após este passo único, o rhizome-launcher abrirá normalmente em lançamentos subsequentes.

📱 Android

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)
  1. Instale o Termux (baixe do GitHub Releases, ou procure em F-Droid / Google Play)
  2. 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 Linux

Depois siga a seção Terminal Launcher abaixo para completar a configuração.

Rhizome on Termux

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 onboard

Isso 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.json no 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 gateway

🔌 Providers (LLM)

O 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.

💬 Channels (Apps de Chat)

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
WhatsApp Fácil (QR scan ou bridge URL) Nativo / Bridge Guia
Weixin Fácil (scan QR nativo) iLink API Guia
QQ 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ão 127.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 via RHIZOME_LOG_LEVEL. Veja Configuração para detalhes.

Para instruções detalhadas de configuração de channels, veja Configuração de Apps de Chat.

🔧 Ferramentas

🔍 Busca na Web

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

⚙️ Outras Ferramentas

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

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.

🔗 MCP (Model Context Protocol)

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.

ClawdChat Junte-se à Rede Social de Agents

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

🖥️ Referência CLI

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

⏰ Tarefas Agendadas / Lembretes

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

📚 Documentação

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

🤝 Contribuir & Roadmap

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

WeChat: WeChat group QR code