Skip to content

INSTALL.md

Latest commit

 

History

History
212 lines (144 loc) · 3.8 KB

INSTALL.md

File metadata and controls

212 lines (144 loc) · 3.8 KB
Raw

🔧 Guia de Instalação e Setup

Pré-requisitos

  • Sistema Operacional: Linux, macOS, ou Windows (WSL2)
  • Python: 3.9 ou superior
  • Gerenciador de pacotes: pip (vem com Python)
  • Git: para versionamento

Verifique se tem instalado:

python --version  # Deve mostrar 3.9+
pip --version     # Deve mostrar versão recente
git --version     # Deve estar disponível

Se algum não estiver, baixe em:

Opção 1: Setup Rápido (Recomendado)

1. Clone o repositório

git clone https://github.com/claudiogpt/lab-vibecoding.git
cd lab-vibecoding

2. Crie um ambiente virtual

# Linux/macOS
python -m venv venv
source venv/bin/activate

# Windows
python -m venv venv
venv\Scripts\activate

3. Instale dependências

pip install -r requirements.txt

4. Teste a instalação

python -c "import anthropic; print('✅ Anthropic SDK OK')"
# ou
python -c "import ollama; print('✅ Ollama OK')"

Opção 2: Setup com Ollama (LLM Local + Grátis)

Se preferir não usar APIs de terceiros e rodar localmente:

1. Instale Ollama

Baixe em: https://ollama.ai

2. Rode um modelo local

ollama pull llama2
ollama serve  # Em outro terminal, deixa rodando

3. Siga os passos 1-3 acima, depois:

# Configure para usar Ollama
export OLLAMA_HOST=http://localhost:11434
# Testes usarão Ollama automaticamente

Opção 3: Setup com OpenAI API (Gratuito com créditos)

1. Crie conta em https://openai.com

2. Gere uma chave API em https://platform.openai.com/account/api-keys

3. Configure a variável de ambiente

# Linux/macOS (adicione ao ~/.bashrc ou ~/.zshrc)
export OPENAI_API_KEY="sk-..."

# Windows (Command Prompt)
set OPENAI_API_KEY=sk-...

# Windows (PowerShell)
$env:OPENAI_API_KEY="sk-..."

4. Siga os passos 1-3 acima

Opção 4: Setup com Anthropic/Claude API

1. Crie conta em https://claude.ai

2. Gere uma chave API em https://console.anthropic.com

3. Configure a variável de ambiente

# Linux/macOS
export ANTHROPIC_API_KEY="sk-ant-..."

# Windows
set ANTHROPIC_API_KEY=sk-ant-...

4. Siga os passos 1-3 acima

Verificação de Setup

Execute o script de teste:

python tests/check_setup.py

Deve mostrar quais LLMs estão disponíveis:

✅ Ollama (local)
✅ OpenAI API
❌ Anthropic API (não configurado)

Troubleshooting

Erro: "ModuleNotFoundError: No module named 'anthropic'"

pip install anthropic
# ou reinstale tudo
pip install -r requirements.txt

Erro: "Connection refused" ao conectar em Ollama

# Verifique se Ollama está rodando
ollama serve
# Em outro terminal, tente conectar
curl http://localhost:11434/api/generate -d '{"model":"llama2", "prompt":"hi"}'

Erro: "OPENAI_API_KEY not set"

# Verifique a variável
echo $OPENAI_API_KEY

# Se vazio, configure:
export OPENAI_API_KEY="seu-token"

Python 3.9 não está disponível

Se seu sistema só tem Python 3.8:

# Considere usar pyenv para múltiplas versões
curl https://pyenv.run | bash
# Depois instale Python 3.9+
pyenv install 3.11.0

Estrutura de Pastas Recomendada

lab-vibecoding/
├── venv/                 # Ambiente virtual
├── 00-introducao/
├── 01-conceitos-fundamentais/
├── ...
├── requirements.txt
└── INSTALL.md (este arquivo)

Próximos Passos

  1. ✅ Instalação completa? Vá para 00-introducao/slides.md
  2. Leia ferramentas-gratuitas.md para mais opções
  3. Consulte README.md para visão geral do lab

Ajuda

Problema não resolvido? Veja recursos-extras.md ou abra uma issue.