Instalação

O Aru é distribuído via PyPI como o pacote aru-code e precisa de Python 3.11 ou superior.

Via pip

pip install aru-code

Depois da instalação, o comando aru fica disponível globalmente no seu terminal.

Providers opcionais

O provider padrão é a Anthropic (Claude) e já vem incluído. Para usar outros providers, instale os extras correspondentes:

Todos os providersOpenAIOllamaGroq

pip install "aru-code[all-providers]"

pip install "aru-code[openai]"

pip install "aru-code[ollama]"

pip install "aru-code[groq]"

A partir do código fonte

git clone https://github.com/estevaofon/aru.git
cd aru
pip install -e ".[dev]"

A instalação em modo editável (-e) permite rodar o Aru e modificar o código ao mesmo tempo — útil para contribuições ou debugging.

Configurando a chave de API

O Aru usa Claude Sonnet 4.6 por padrão. Você precisa de uma chave da Anthropic.

Crie um arquivo .env na raiz do seu projeto:

ANTHROPIC_API_KEY=sk-ant-sua-chave-aqui

Ou defina como variável de ambiente no seu shell:

Linux / macOSWindows (PowerShell)

export ANTHROPIC_API_KEY=sk-ant-sua-chave-aqui

$env:ANTHROPIC_API_KEY = "sk-ant-sua-chave-aqui"

Usando outro provider?

Veja a página de Modelos e Providers para configurar OpenAI, Ollama, Groq, OpenRouter ou DeepSeek.

Verificando a instalação

aru --version

Se tudo estiver correto, você verá o número da versão instalada. Em seguida, rode aru para entrar na REPL interativa.