Installazione

Cosa ti serve

• Python 3.12 o più recente (download)

• uv — gestore pacchetti Python veloce. Installa con:

  macOS / LinuxWindows

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• Una chiave API LLM — una di:

  • Google Gemini (livello gratuito disponibile — consigliato per iniziare)
  • Qualsiasi endpoint compatibile OpenAI (OpenAI, Anthropic via proxy, Ollama / LM Studio locale, ecc.)

Opzionale, ma sblocca più funzionalità

Strumento	Usato da	Quando ti serve
FFmpeg (download)	Sottotitolo, Voce, Doppiaggio, Live	Qualsiasi flusso audio/video
LibreOffice (download)	Formati Office su Linux/macOS	Tradurre legacy .doc / .xls / .ppt, o qualsiasi file Office quando MS Office non è installato
Tesseract (guida installazione)	Motore OCR (default)	Pagina Estrai testo, traduzione PDF scansionati, traduzione immagini incorporate
MS Office + pywin32	Office su Windows	Traduzione Office di massima fedeltà su Windows

Puoi installare AI Translate senza nessuno di questi — le funzionalità che ne hanno bisogno te lo dicono prima di fallire.

Setup

git clone https://github.com/cadic2603/ai-translate.git
cd ai-translate
uv sync

Questo installa tutto il necessario per eseguire l'app desktop, il CLI e il server MCP.

Eseguilo

App desktopRiga di comandoServer MCP

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # trasporto stdio (per Claude Desktop / Code)

Aggiungi la tua chiave API

La prima volta che apri l'app desktop:

1. Clicca su Impostazioni nella barra laterale
2. Apri il tab LLM
3. Incolla la tua chiave API Google Gemini (o configura un provider personalizzato compatibile OpenAI). Gli utenti enterprise possono cambiare Gemini in modalità Vertex AI — puntalo a un progetto e regione GCP, opzionalmente fornisci un percorso JSON di service account; vedi Provider LLM per i dettagli.
4. Scegli un modello di default — qualsiasi variante Flash attuale (es. gemini-2.5-flash) è un solido punto di partenza gratuito. Le varianti Pro danno qualità migliore a costo più alto.
5. Chiudi le Impostazioni — hai finito

Le chiavi sono salvate nel portachiavi del tuo OS (Keychain macOS, Credential Manager Windows, GNOME / KDE Secret Service su Linux), non in chiaro su disco.

Installazione headless / server

Se non puoi eseguire l'app desktop per configurare le chiavi, vedi Provider LLM per i comandi CLI keychain.

Avanti: provala

Prima traduzione in 5 minuti →