Spaces:
Runtime error
Runtime error
File size: 2,087 Bytes
1429e38 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 |
# Instalação e Configuração
## Requisitos do Sistema
### Hardware Recomendado
- **GPU**: NVIDIA T4 16GB ou superior
- **CPU**: 4+ cores
- **RAM**: 16GB mínimo
- **Armazenamento**: 10GB+ disponível
### Software Necessário
- Python 3.10+
- CUDA 11.8+ (para GPU)
- Git
## Instalação Local
1. Clone o repositório:
```bash
git clone https://github.com/seu-usuario/hackatoon-1iadt.git
cd hackatoon-1iadt
```
2. Crie e ative um ambiente virtual:
```bash
python -m venv venv
source venv/bin/activate # Linux/Mac
.\venv\Scripts\activate # Windows
```
3. Instale as dependências:
```bash
pip install -r requirements.txt
```
4. Configure as variáveis de ambiente:
```bash
cp .env.example .env
```
Edite o arquivo `.env` com suas configurações:
```
HUGGINGFACE_TOKEN=seu_token
GPU_MEMORY_FRACTION=0.9
MAX_CONCURRENT_REQUESTS=2
```
## Configuração do Ambiente
### GPU (NVIDIA)
1. Verifique a instalação do CUDA:
```bash
nvidia-smi
```
2. Ajuste as configurações de GPU em `.env`:
```
USE_GPU=true
GPU_DEVICE=0
```
### CPU
Para usar apenas CPU:
```
USE_GPU=false
```
## Deployment no Hugging Face
1. Configure as variáveis de ambiente do Hugging Face:
```bash
cp .env.example .env.huggingface
```
2. Edite `.env.huggingface`:
```
HF_SPACE_ID=seu-espaco
HF_TOKEN=seu_token
```
3. Execute o deploy:
```bash
./deploy.sh
```
## Verificação da Instalação
1. Execute os testes:
```bash
pytest
```
2. Inicie a aplicação:
```bash
python app.py
```
3. Acesse: http://localhost:7860
## Troubleshooting
### Problemas Comuns
1. **Erro CUDA**
- Verifique a instalação do CUDA
- Confirme compatibilidade de versões
2. **Memória Insuficiente**
- Ajuste `GPU_MEMORY_FRACTION`
- Reduza `MAX_CONCURRENT_REQUESTS`
3. **Falha no Deploy**
- Verifique credenciais do Hugging Face
- Confirme permissões do espaço
### Logs
- Logs da aplicação: `logs/app.log`
- Logs do GPU: `logs/gpu.log`
## Suporte
Para problemas e dúvidas:
1. Abra uma issue no GitHub
2. Consulte a documentação completa
3. Entre em contato com a equipe de suporte |