How it works

Como funciona

Every request climbs a cost ladder and stops at the first step that solves it.

Cada pedido sobe uma escada de custo e para no primeiro degrau que resolve.

What you need

O que precisa

The installer takes care of most of it.

O instalador cuida da maior parte.

Models are picked for your GPU: 12 GB+ gets qwen3:8b, qwen2.5-coder:7b and qwen2.5vl:7b; 8 GB drops vision; 6 GB uses qwen3:4b; CPU-only uses qwen3:1.7b.

Os modelos são escolhidos pela sua placa: 12 GB ou mais usa qwen3:8b, qwen2.5-coder:7b e qwen2.5vl:7b; 8 GB fica sem visão; 6 GB usa qwen3:4b; só processador usa qwen3:1.7b.

Install

Instalar

One command. It asks before each optional step.

Um comando. Ele pergunta antes de cada passo opcional.

git clone https://github.com/felipebherve/agente-local.git
cd agente-local
./install.sh

git clone https://github.com/felipebherve/agente-local.git
cd agente-local
powershell -ExecutionPolicy Bypass -File .\install.ps1

What the installer does

O que o instalador faz

1. Checks Python and Git (on Windows, installs them with winget if missing).
2. Installs Ollama if missing.
3. Creates the agent's own Python environment in .venv.
4. Offers to install OmniRoute (optional).
5. Runs agente init: detects your GPU, downloads the right models, writes config.yaml and registers the agent in Claude Code and Claude Desktop.
6. Creates the Agente local shortcut, which opens the panel in your browser.

1. Confere Python e Git (no Windows, instala pelo winget se faltar).
2. Instala o Ollama se faltar.
3. Cria o ambiente Python do agente em .venv.
4. Oferece instalar o OmniRoute (opcional).
5. Roda o agente init: vê sua placa, baixa os modelos certos, escreve o config.yaml e registra o agente no Claude Code e no Claude Desktop.
6. Cria o atalho Agente local, que abre o painel no navegador.

Something wrong? Run agente doctor: it checks every piece and tells you what to fix.

Deu algo errado? Rode agente doctor: ele confere cada peça e diz o que corrigir.

Connect your accounts

Conectar suas contas

The agent never stores a password. It uses the logins you already have.

O agente nunca guarda senha. Ele usa os logins que você já tem.

Connect your OmniRoute (free cloud AI, optional)

Conectar o seu OmniRoute (IA grátis na nuvem, opcional)

1. Install and start it: npm install -g omniroute then omniroute.
2. Open http://localhost:20128, go to Providers and connect a provider with your own free account (for example Groq, Gemini or NVIDIA NIM).
3. In config.yaml, set omniroute.ligado: true and list the models in order under omniroute.modelos:

1. Instale e ligue: npm install -g omniroute e depois omniroute.
2. Abra http://localhost:20128, vá em Providers e conecte um provedor com a sua conta grátis (por exemplo Groq, Gemini ou NVIDIA NIM).
3. No config.yaml, coloque omniroute.ligado: true e liste os modelos em ordem em omniroute.modelos:

omniroute:
  ligado: true
  url: http://127.0.0.1:20128/v1
  modelos:
    - groq/llama-3.3-70b-versatile
    - gemini/gemini-2.5-flash

The agent tries the first model, then the next. If OmniRoute is off, it skips straight to Claude. You are responsible for following each provider's terms; prefer providers with an official free tier.

O agente tenta o primeiro modelo, depois o próximo. Se o OmniRoute estiver desligado, ele pula direto para o Claude. Cada pessoa é responsável por seguir os termos dos provedores; prefira os que têm plano grátis oficial.

Using it

Usar

Nothing special: Claude Code calls the agent on its own. Try asking:

Nada especial: o Claude Code chama o agente sozinho. Experimente pedir:

Safety and privacy

Segurança e privacidade

FAQ