docs/installation.md

# 🚀 Guia de Instalação

## Pré-requisitos

### Sistema Operacional
- Windows 10/11 (recomendado)
- Linux (Ubuntu 20.04+)
- macOS (10.15+)

### Software Necessário
- **Python 3.13+** (obrigatório)
- **Git** (para clonagem do repositório)
- **Visual Studio Build Tools** (Windows - para compilação de dependências)

## Instalação Passo a Passo

### 1. Preparação do Ambiente

#### Windows
```powershell
# Verificar versão do Python
python --version

# Instalar Visual Studio Build Tools (se necessário)
# Baixar de: https://visualstudio.microsoft.com/visual-cpp-build-tools/
```

#### Linux/macOS
```bash
# Verificar versão do Python
python3 --version

# Instalar dependências do sistema (Ubuntu)
sudo apt update
sudo apt install python3-pip python3-venv build-essential
```

### 2. Clonagem do Repositório

```bash
git clone <repository-url>
cd vampire-trading-bot
```

### 3. Criação do Ambiente Virtual

#### Windows
```powershell
# Criar ambiente virtual
python -m venv venv

# Ativar ambiente virtual
.\venv\Scripts\Activate.ps1
```

#### Linux/macOS
```bash
# Criar ambiente virtual
python3 -m venv venv

# Ativar ambiente virtual
source venv/bin/activate
```

### 4. Instalação das Dependências

```bash
# Atualizar pip
pip install --upgrade pip

# Instalar dependências principais
pip install -r requirements.txt
```

#### Dependências Principais
- `gradio==4.44.0` - Interface web
- `transformers` - Modelos de IA
- `torch` - Framework de deep learning
- `numpy` - Computação numérica
- `pandas` - Manipulação de dados
- `scipy` - Computação científica
- `psutil` - Monitoramento de sistema

### 5. Verificação da Instalação

```bash
# Testar importações principais
python -c "import gradio, transformers, torch, numpy, pandas; print('✅ Todas as dependências instaladas com sucesso!')"

# Executar aplicação em modo de teste
python app.py
```

## Resolução de Problemas Comuns

### Erro de Compilação do Rust (tokenizers)

**Problema**: Erro ao instalar `tokenizers` devido à falta do Rust

**Solução**:
```bash
# Instalar versão mais recente do transformers
pip install --upgrade transformers

# Ou instalar Rust (alternativa)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

### Erro do pyaudioop (Python 3.13)

**Problema**: `ModuleNotFoundError: No module named 'pyaudioop'`

**Solução**:
```bash
# Atualizar Gradio para versão mais recente
pip install --upgrade gradio

# O audioop-lts será instalado automaticamente
```

### Problemas de Memória

**Problema**: Erro de memória ao carregar modelos de IA

**Solução**:
- Usar modelos menores (configurar em `config.py`)
- Aumentar memória virtual do sistema
- Executar em modo standalone (sem IA)

### Problemas de Permissão (Windows)

**Problema**: Erro de permissão ao executar scripts

**Solução**:
```powershell
# Alterar política de execução
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

## Configuração Inicial

### 1. Configurar Modelos de IA

Edite o arquivo `config.py`:

```python
# Modelos disponíveis (do menor para o maior)
FINANCIAL_MODELS = [
    "nlptown/bert-base-multilingual-uncased-sentiment",  # Mais leve
    "cardiffnlp/twitter-roberta-base-sentiment-latest",   # Médio
    "ProsusAI/finbert"  # Mais pesado, melhor precisão
]
```

### 2. Configurar Caminhos de Log

Para integração em tempo real, configure o caminho dos logs:

```python
# Em real_time_integration.py
LOG_FILE_PATH = "caminho/para/seus/logs/trading.log"
```

### 3. Configurar Interface

Personalize a interface em `config.py`:

```python
class UIConfig:
    TITLE = "Seu Título Personalizado"
    SUBTITLE = "Sua Descrição"
    # ... outras configurações
```

## Execução

### Modo Desenvolvimento
```bash
# Executar com reload automático
python app.py
```

### Modo Produção
```bash
# Executar com configurações otimizadas
python app.py --share=False --server_name=0.0.0.0 --server_port=7860
```

### Modo Standalone (Sem IA)
```bash
# Executar sem dependências de IA
python app.py --no-ai
```

## Verificação Final

Após a instalação, verifique se:

1. ✅ O aplicativo inicia sem erros
2. ✅ A interface web carrega em `http://localhost:7860`
3. ✅ As análises técnicas funcionam
4. ✅ Os modelos de IA carregam (se disponíveis)
5. ✅ O monitoramento de performance está ativo

## Próximos Passos

- Leia a [Documentação da Arquitetura](architecture.md)
- Configure suas preferências em [Configuração](configuration.md)
- Explore a [Referência da API](api-reference.md)

## Suporte

Para problemas não cobertos neste guia, consulte:
- [Troubleshooting](troubleshooting.md)
- [Issues do GitHub](link-para-issues)
- Documentação oficial das dependências