# Virtual Environment Setup

## ✅ Virtual Environment Creato

Il virtual environment è stato creato con successo in `venv/` e tutte le dipendenze sono state installate.

## Come Attivare il Virtual Environment

### Windows PowerShell
```powershell
.\venv\Scripts\Activate.ps1
```

### Windows CMD
```cmd
.\venv\Scripts\activate.bat
```

### Linux/Mac
```bash
source venv/bin/activate
```

## Verifica Installazione

Dopo aver attivato il venv, verifica che tutto sia installato:

```powershell
# Attiva venv
.\venv\Scripts\Activate.ps1

# Verifica pacchetti installati
pip list

# Verifica versione Python
python --version
```

## Pacchetti Installati

Tutti i pacchetti da `requirements.txt` sono stati installati:

- ✅ `telnetlib3` - Client Telnet asincrono
- ✅ `networkx` - Gestione grafi per auto-mapping
- ✅ `sqlalchemy` - ORM per database
- ✅ `pydantic` - Validazione configurazione
- ✅ `rich` - Output formattato console
- ✅ `memvid` - Encoding QR-in-MP4
- ✅ `faiss-cpu` - Vector similarity search
- ✅ `sentence-transformers` - Text embeddings
- ✅ `torch` - Deep learning framework (dipendenza)
- ✅ `pytest` - Testing framework
- ✅ `pytest-asyncio` - Async testing
- ✅ `pytest-cov` - Coverage reporting

## Eseguire l'Applicazione

```powershell
# Attiva venv
.\venv\Scripts\Activate.ps1

# Esegui l'applicazione
python -m src.main

# Oppure con config personalizzato
python -m src.main --config my_config.yaml
```

## Eseguire i Test

```powershell
# Attiva venv
.\venv\Scripts\Activate.ps1

# Esegui tutti i test
pytest tests/ -v

# Esegui con coverage
pytest --cov=src --cov-report=html

# Esegui test specifico
pytest tests/test_parser.py -v
```

## Disattivare il Virtual Environment

Quando hai finito di lavorare:

```powershell
deactivate
```

## Aggiungere Nuove Dipendenze

Se devi aggiungere nuove dipendenze:

```powershell
# Attiva venv
.\venv\Scripts\Activate.ps1

# Installa nuovo pacchetto
pip install nome-pacchetto

# Aggiorna requirements.txt
pip freeze > requirements.txt
```

## Ricreare il Virtual Environment

Se hai problemi, puoi ricreare il venv:

```powershell
# Rimuovi venv esistente
Remove-Item -Recurse -Force venv

# Crea nuovo venv
python -m venv venv

# Attiva
.\venv\Scripts\Activate.ps1

# Reinstalla dipendenze
pip install -r requirements.txt
```

## Note

- Il virtual environment è **gitignored** (vedi `.gitignore`)
- Ogni sviluppatore deve creare il proprio venv locale
- Non committare mai la cartella `venv/` su git
- Usa sempre il venv quando lavori sul progetto

## Troubleshooting

### Errore "Execution Policy"

Se ricevi un errore di execution policy in PowerShell:

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

### Pacchetti Mancanti

Se mancano pacchetti:

```powershell
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
```

### Versione Python Sbagliata

Assicurati di usare Python 3.10+:

```powershell
python --version
```

Se hai una versione più vecchia, installa Python 3.10 o superiore.