Установка¶

Что вам нужно¶

Python 3.12 или новее (скачать)

uv — быстрый менеджер пакетов Python. Установите:

macOS / LinuxWindows

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

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

API-ключ LLM — любой из:
- Google Gemini (бесплатный уровень — рекомендуется для старта)
- Любой OpenAI-совместимый endpoint (OpenAI, Anthropic через прокси, локальный Ollama / LM Studio и т. д.)

Опционально, но открывает больше возможностей¶

Инструмент	Используется	Когда нужен
FFmpeg (скачать)	Субтитры, Голос, Дубляж, Live	Любой аудио/видео workflow
LibreOffice (скачать)	Office-форматы на Linux/macOS	Перевод legacy `.doc` / `.xls` / `.ppt`, или любого Office-файла, когда MS Office не установлен
Tesseract (руководство по установке)	OCR-движок (по умолчанию)	Страница «Извлечение текста», перевод сканированных PDF, перевод встроенных изображений
MS Office + pywin32	Office на Windows	Высочайшая точность Office-перевода на Windows

Можно установить AI Translate без всего этого — функции, которым нужны эти инструменты, скажут вам об этом до сбоя.

Настройка¶

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

Это устанавливает всё необходимое для запуска десктопного приложения, CLI и MCP-сервера.

Запуск¶

Десктопное приложениеКомандная строкаMCP-сервер

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # stdio-транспорт (для Claude Desktop / Code)

Добавление API-ключа¶

При первом открытии десктопного приложения:

Нажмите Настройки в боковой панели
Откройте вкладку LLM
Вставьте Google Gemini API-ключ (или настройте кастомного OpenAI-совместимого провайдера). Корпоративные пользователи могут переключить Gemini в режим Vertex AI — укажите GCP-проект и регион, опционально путь к JSON service-account; см. LLM-провайдеры для деталей.
Выберите модель по умолчанию — любой текущий вариант Flash (например gemini-2.5-flash) — солидная бесплатная отправная точка. Pro-варианты дают лучшее качество за более высокую цену.
Закройте Настройки — готово

Ключи хранятся в связке ключей вашей ОС (Keychain на macOS, Credential Manager на Windows, GNOME / KDE Secret Service на Linux), не в открытом виде на диске.

Headless / серверная установка

Если вы не можете запустить десктопное приложение для настройки ключей, см. LLM-провайдеры для команд keychain CLI.

Дальше: попробуйте¶

Первый перевод за 5 минут →