Guia Completo: Aider e Llama.cpp no Termux

Este guia centraliza o processo de instalação e uso do llama.cpp e do aider no ambiente Termux (Android).

1. Preparação do Ambiente

No Termux, instale os pacotes básicos necessários:

pkg update && pkg upgrade -y
pkg install git cmake clang build-essential openssl proot-distro -y

2. Compilação do llama.cpp

Clonar e Aplicar Patch

O llama.cpp precisa de um patch para compilar corretamente no Android devido a limitações de posix_spawn.

git clone https://github.com/ggml-org/llama.cpp
cd llama.cpp
# Certifique-se de ter o arquivo fix-android-build.patch na pasta pai ou copie-o para cá
git apply ../fix-android-build.patch

Compilar

cmake -B build \
    -DLLAMA_BUILD_SERVER=ON \
    -DLLAMA_BUILD_EXAMPLES=ON \
    -DCMAKE_BUILD_TYPE=Release

cmake --build build --target llama-server llama-cli -j$(nproc)

# Tornar binários acessíveis
mkdir -p ~/bin
cp build/bin/llama-* ~/bin/
export PATH=$PATH:~/bin

3. Instalação do Aider

O Aider roda dentro de um ambiente Ubuntu (via proot) para garantir compatibilidade de dependências.

Instalar Ubuntu

proot-distro install ubuntu
proot-distro login ubuntu

Instalar Aider (dentro do Ubuntu)

apt update && apt install python3-pip git build-essential -y
pip3 install git+https://github.com/Aider-AI/aider.git --break-system-packages --ignore-installed
exit

4. Configuração de Modelos

Modelo Local (GGUF)

Baixe um modelo (ex: Llama 3.2 1B) e salve em ~/model.gguf:

curl -L https://huggingface.co/unsloth/Llama-3.2-1B-Instruct-GGUF/resolve/main/Llama-3.2-1B-Instruct-Q4_K_M.gguf -o ~/model.gguf

5. Uso dos Scripts

Certifique-se de que aiderllama.sh e brain-local estejam na mesma pasta e dê permissão de execução:

chmod +x aiderllama.sh brain-local

Chat Simples (brain-local)

• Chat Interativo: ./brain-local
• Modo Servidor: ./brain-local --serve (porta 8080)

Agente de Código (aiderllama.sh)

Execute ./aiderllama.sh e escolha o modo:

1. Local: Usa o llama-server (requer ~/model.gguf).
2. OpenRouter: Requer chave API (limite de 200 req/dia grátis).
3. Gemini: Requer chave API do Google AI Studio (recomendado, gratuito e sem limites).