Pular para conteúdo

Instalação

O que você precisa

  • Python 3.12 ou mais novo (download)

  • uv — gerenciador de pacotes Python rápido. Instale com:

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

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

  • Uma chave de API LLM — qualquer uma de:

    • Google Gemini (camada gratuita disponível — recomendado para começar)
    • Qualquer endpoint compatível com OpenAI (OpenAI, Anthropic via proxy, Ollama / LM Studio local, etc.)

Opcional, mas desbloqueia mais funcionalidades

Ferramenta Usado por Quando você precisa
FFmpeg (download) Legenda, Voz, Dublagem, Live Qualquer fluxo de áudio/vídeo
LibreOffice (download) Formatos Office no Linux/macOS Traduzir legacy .doc / .xls / .ppt, ou qualquer arquivo Office quando MS Office não estiver instalado
Tesseract (guia de instalação) Motor OCR (padrão) Página Extrair texto, tradução de PDFs escaneados, tradução de imagens embutidas
MS Office + pywin32 Office no Windows Tradução Office de máxima fidelidade no Windows

Você pode instalar AI Translate sem nenhum desses — funcionalidades que precisam deles avisam antes de falhar.

Configurar

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

Isso instala tudo o necessário para executar o app desktop, o CLI e o servidor MCP.

Executar

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # transporte stdio (para Claude Desktop / Code)

Adicione sua chave de API

Na primeira vez que você abrir o app desktop:

  1. Clique em Configurações na barra lateral
  2. Abra a aba LLM
  3. Cole sua chave de API Google Gemini (ou configure um provedor personalizado compatível com OpenAI). Usuários enterprise podem trocar Gemini para modo Vertex AI — aponte para um projeto e região GCP, opcionalmente forneça um caminho JSON de service account; veja Provedores LLM para detalhes.
  4. Escolha um modelo padrão — qualquer variante Flash atual (ex. gemini-2.5-flash) é um sólido ponto de partida gratuito. Variantes Pro dão melhor qualidade a custo mais alto.
  5. Feche Configurações — pronto

As chaves são salvas no chaveiro do seu OS (Keychain macOS, Credential Manager Windows, GNOME / KDE Secret Service no Linux), não em texto plano em disco.

Instalação headless / servidor

Se você não pode executar o app desktop para configurar chaves, veja Provedores LLM para os comandos CLI keychain.

Próximo: experimente

Primeira tradução em 5 minutos →