docs/python_conflicts.md

# Conflitos Python — Gerenciamento de Ambientes

## Problema Principal
Múltiplos projetos (ComfyUI, OpenWebUI, llama.cpp) podem ter dependências conflitantes.

## Solução Recomendada: Ambientes Virtuais Separados

### Criar ambiente para ComfyUI
```bash
python -m venv venv_comfyui
venv_comfyui\Scripts\activate
pip install -r ComfyUI/requirements.txt
```

### Criar ambiente para OpenWebUI (se não usar Docker)
```bash
python -m venv venv_openwebui
venv_openwebui\Scripts\activate
pip install open-webui
```

## Versão Python Recomendada
- Python 3.10.x (mais compatível com o stack atual)
- Evitar Python 3.12+ por possíveis incompatibilidades

## Verificação de Conflitos
```bash
pip check
pip list --outdated
```

## Observações
- Docker para OpenWebUI evita conflitos de dependências completamente
- ComfyUI funciona melhor em ambiente virtual dedicado
- llama.cpp não precisa de ambiente Python (é compilado em C++)