Docs/Installazione

# Installazione

Istruzioni dettagliate per l'installazione di Cognitor Assistant.

Requisiti

  • Python 3.10+
  • pip
  • (Opzionale) GPU NVIDIA con CUDA per il training

Clona il repository

bash
git clone https://github.com/lucaterribili/cognitor-assistant.git
cd cognitor-assistant

Crea un ambiente virtuale (consigliato)

bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
# oppure
venv\Scripts\activate  # Windows

Installa le dipendenze

bash
pip install -r requirements.txt

Dipendenze Principali

  • torch: Framework per deep learning
  • fasttext: Word embeddings
  • spacy: NLP
  • fastapi: Web framework
  • uvicorn: Server ASGI
  • pandas: Manipolazione dati
  • scikit-learn: ML utilities
  • pytorch-crf: Conditional Random Fields per NER
  • python-jose: JWT authentication
  • passlib: Hashing password

Download modelli Spacy

bash
python -m spacy download it_core_news_sm

Configurazione

Il file config.py contiene le configurazioni base del progetto:

python
import os
BASE_DIR = os.path.dirname(os.path.abspath(__file__))

Verifica installazione

bash
python -c "import torch; print(f'PyTorch: {torch.__version__}')"
python -c "import fasttext; print(f'FastText: OK')"
python -c "import fastapi; print(f'FastAPI: OK')"

Training dei modelli

Dopo l'installazione, potresti voler addestrare i modelli:

bash
python -m pipeline

Vedi la guida [Training](/training) per maggiori dettagli.