Mapa da trilha
Conteúdo detalhado
📦 Instalar o kernel
Python, clone do repo, instalação das deps (CPU vs CUDA), virtualenv e verificação básica.
AIOS exige Python ≥ 3.10. 3.11 ou 3.12 são recomendados pela performance e melhor type-checking.
Versões antigas (3.8/3.9) quebram imports de Cerebrum e libs do ecossistema.
pyenv · asdf · brew · type-hints modernos.
Em Local Kernel mode, clone ambos. git clone https://github.com/agiresearch/AIOS.git e git clone https://github.com/agiresearch/Cerebrum.git.
Instalar AIOS já puxa Cerebrum como dependência; mas ter o repo local facilita debug e leitura do código.
Local install · editable mode · symlink de dev.
CPU: pip install -r requirements.txt. GPU: pip install -r requirements-cuda.txt. CUDA traz torch+vllm para hospedar modelos locais.
Se você só usa APIs (OpenAI, Claude), CPU basta. CUDA só se for hospedar modelos via vLLM/HuggingFace local.
vLLM · torch · cuDNN · hospedar local.
AIOS tem muitas dependências. Sempre instale em ambiente isolado: python -m venv .venv && source .venv/bin/activate.
Sem isolamento, conflitos com outras libs Python te queimam horas.
venv · conda · pyenv · uv.
python -c "import aios; print(aios.__version__)" e python -c "import cerebrum; print(cerebrum.__version__)" confirmam imports.
Smoke test evita "instalei mas nada funciona" — pega problema antes de gastar tempo configurando keys.
Smoke test · import check · versão alinhada.
Erros típicos: torch CUDA mismatch, falta de gcc, conflito de pydantic v1/v2, falta do config.yaml.
Conhecer os 5 erros mais comuns economiza 80% do tempo de setup.
Logs · stack trace · GitHub issues · venv limpo.
🔑 Configurar providers
Estrutura do config.yaml, keys de OpenAI/Anthropic/Gemini/Groq/HuggingFace/Novita e como subir o kernel em background com Terminal UI.
aios/config/config.yaml centraliza keys, modelos default, scheduler escolhido e storage path. É o primeiro arquivo a editar.
Mudanças aqui propagam pelo kernel todo sem precisar tocar em código.
YAML · single source of truth · hot reload (parcial).
Adicione openai: "sk-..." e anthropic: "sk-ant-..." em api_keys. O LLM Core ativa o provider correspondente automaticamente.
São os 2 providers mais maduros — ótima escolha para começar.
API key · secret manager · rotação periódica.
Adicione gemini (Google), groq (Llama acelerado) e novita (proxy open). Cada um para um caso.
Diversificar providers reduz risco de rate limit e cria opções de custo/qualidade.
Rate limit · fallback · diversificação.
Para modelos HuggingFace, configure huggingface.auth_token e huggingface.cache_dir (pasta para download de pesos).
Modelos locais oferecem privacidade e custo zero por token — mas precisam de cache configurado para não baixar toda vez.
HF auth · cache · vLLM · GPU mandatório para modelos grandes.
Foreground: python -m aios.kernel. Background com log: nohup python -m aios.kernel > kernel.log 2>&1 &.
Em dev, foreground (vê log na hora). Em prod, background com log + systemd.
nohup · systemd · tmux · supervisord.
python scripts/run_terminal.py abre prompt interativo conectado ao kernel.
É a forma mais rápida de validar que o kernel está respondendo e os providers estão configurados.
REPL · primeira query · sanity check · debug visual.