Requer Rust 1.92+ (alinhado com MSRV declarado em Cargo.toml — GAR-441)

<!-- markdownlint-disable MD033 MD041 MD060 -->

<p align="center">
  <img src="assets/logo.png" alt="GarraIA" width="280" />
</p>

<h1 align="center">GarraIA</h1>

<p align="center">
  <strong>O framework seguro e leve de código aberto para agentes de IA.</strong>
</p>

<p align="center">
  <a href="https://github.com/michelbr84/GarraRUST/actions"><img src="https://github.com/michelbr84/GarraRUST/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
  <a href="https://github.com/michelbr84/GarraRUST/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Licença: MIT"></a>
  <a href="https://github.com/michelbr84/GarraRUST/stargazers"><img src="https://img.shields.io/github/stars/michelbr84/GarraRUST" alt="Estrelas"></a>
  <a href="https://github.com/michelbr84/GarraRUST/issues"><img src="https://img.shields.io/github/issues/michelbr84/GarraRUST" alt="Issues"></a>
  <a href="https://github.com/michelbr84/GarraRUST/issues?q=label%3Agood-first-issue+is%3Aopen"><img src="https://img.shields.io/github/issues/michelbr84/GarraRUST/good-first-issue?color=7057ff&label=good%20first%20issues" alt="Boas Primeiras Issues"></a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/rust-1.92%2B-orange?logo=rust" alt="Rust">
  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
  <img src="https://img.shields.io/badge/crates-16-green" alt="Crates">
  <img src="https://img.shields.io/badge/channels-11-purple" alt="Channels">
  <img src="https://img.shields.io/badge/LLM%20providers-15-red" alt="Providers">
</p>

<p align="center">
  <a href="#início-rápido">Início Rápido</a> &middot;
  <a href="#por-que-garraia">Por que GarraIA?</a> &middot;
  <a href="#recursos">Recursos</a> &middot;
  <a href="#memória-e-auto-aprendizado">Memória</a> &middot;
  <a href="#segurança">Segurança</a> &middot;
  <a href="#arquitetura">Arquitetura</a> &middot;
  <a href="#migrando-do-openclaw">Migrar do OpenClaw</a> &middot;
  <a href="#contribuindo">Contribuindo</a>
</p>

---

**O assistente de IA brasileiro que funciona 100% no seu computador.** Um único binário de 16 MB que executa seus agentes de IA no Telegram, Discord, Slack, WhatsApp e iMessage — com armazenamento de credenciais criptografadas, recarregamento de configuração a quente, sistema completo de memória e apenas 13 MB de RAM em modo de espera. Desenvolvido em Rust para a segurança e confiabilidade que os agentes de IA exigem.

**100% Local** — Todos os seus dados, conversas e configurações ficam exclusivamente no seu computador. Nenhum dado é enviado para servidores externos.

<!-- TODO: Adicionar GIF de demonstração do terminal VHS aqui (#103) -->

## 🐾 Conheça o Garra

O **Garra** não é só um endpoint de API — ele é o seu assistente pessoal, e fala
como um. Desde o primeiro `garra start`, ele se apresenta com nome, conversa em
português do Brasil na primeira pessoa e mantém um tom caloroso, direto e honesto
(sem bajulação). Quando algo dá errado, ele explica o que aconteceu e qual é o
próximo passo — nada de despejar códigos de erro crus.

> _"Oi! 👋 Eu sou o Garra, seu assistente pessoal. Pode falar comigo como você
> falaria com um amigo."_

Essa personalidade é **o padrão**, mas você manda: defina `agent.system_prompt`
para dar a ele uma personalidade própria, ou `agent.persona = "neutral"` para um
tom totalmente neutro. Veja [ADR 0012](docs/adr/0012-garra-persona.md).

## 🗺️ Roadmap AAA

O desenvolvimento do GarraRUST segue um plano ambicioso de evolução para o tier AAA em 7 fases, consolidado no [ROADMAP.md](ROADMAP.md). Inclui GarraMaxPower nativo (`garra max-power`, registry de skills e Agent Team MVP), Superpowers, TurboQuant+ (KV cache), RAG local (lancedb), MCP + plugins WASM, zero-latency streaming (OpenTelemetry), e a nova direção **Group Workspace** — espaço compartilhado família/equipe multi-tenant com arquivos, chats, memória IA e módulo tipo-Notion (tasks + docs + databases), desenhado em [`deep-research-report.md`](deep-research-report.md). Execução semana a semana acompanhada nos [projects Linear do time GarraIA-RUST](https://linear.app/chatgpt25/team/GAR/projects).

Nota de sincronizacao (2026-05-24): a decisao GarraMaxPower esta formalizada em [ADR 0011](docs/adr/0011-garra-max-power.md), e o backlog operacional curto agora vive em [`TODO.md`](TODO.md) para pendencias seguras entre `ROADMAP.md` e Linear.

## Início Rápido

```bash
# Requer Rust 1.92+ (alinhado com MSRV declarado em Cargo.toml — GAR-441)
cargo build --release -p garraia

# Configuração interativa - escolha seu provedor de LLM, armazene chaves de API em cofre criptografado
./target/release/garra init

# Iniciar
./target/release/garra start

# Conversa rápida não-interativa (GAR-579) — ideal para Claude Code, CI, scripts
./target/release/garra ask --provider openrouter --model openrouter/free \
  --json --timeout-secs 30 "Responda apenas: GAR-ASK-OK"

# MCP server stdio (GAR-583) — expõe `garra_ask` para Claude Desktop / Cl

... (truncated)