Gemini Translator

Gemini Translator — это настольное приложение для Windows, macOS и Linux, предназначенное для перевода текстов и документов с использованием Google Gemini API. Приложение обладает гибкими настройками, поддерживает работу с большими документами и позволяет настраивать шаблоны запросов для достижения наилучшего качества перевода.

🚀 Основные возможности

• Интеграция с Google Gemini API: Использует мощные языковые модели Google для высококачественного перевода.
• Гибкий импорт:
  • Импорт текста из файлов .txt, .pdf и .docx.
  • Извлечение текста напрямую со страниц по URL.
• Обработка больших документов: Автоматическое разделение текста на фрагменты (чанки) для обработки больших объемов данных без превышения лимитов API.
• Кастомизация промптов: Встроенный редактор позволяет создавать и изменять шаблоны запросов к AI, чтобы точно настроить стиль и контекст перевода.
• Сохранение сессий: Возможность сохранять и загружать проекты (.gt файлы), включая исходный текст, перевод и все настройки сессии.
• Многоязычный интерфейс: Поддержка русского и английского языков интерфейса.
• Защита кода от перевода: Автоматически определяет блоки кода (Markdown) и защищает их от перевода, сохраняя их в неизменном виде.
• Обратный перевод: Быстрый перевод результата обратно на исходный язык для оценки качества.
• Темная тема: Приятный для глаз интерфейс в темных тонах.

⚙️ Установка и запуск

Для работы приложения необходим Python 3.10 или новее.

1. Клонируйте репозиторий:

git clone https://github.com/kobaltgit/gemini_translator.git
cd gemini_translator

2. Создайте и активируйте виртуальное окружение:

• Windows:

  python -m venv venv
  .\venv\Scripts\activate

• macOS / Linux:

  python3 -m venv venv
  source venv/bin/activate

3. Установите зависимости:

pip install -r requirements.txt

4. Настройте API ключ:

Для работы с Google Gemini API вам понадобится ключ.

• Получите его в Google AI Studio.

Есть два способа настроить ключ:

• (Рекомендуется) Через интерфейс приложения:

  1. Запустите приложение.
  2. Перейдите в меню Правка > Настройки... (Edit > Settings...).
  3. Вставьте свой API ключ в поле "Gemini API Key".
  4. Нажмите "Проверить и загрузить модели", выберите модель и сохраните.

• (Для разработчиков) Через файл .env:

  1. Создайте в корневой папке проекта файл с именем .env.
  2. Добавьте в него следующую строку, заменив YOUR_API_KEY_HERE на ваш реальный ключ:

     GEMINI_API_KEY="YOUR_API_KEY_HERE"
     

5. Запустите приложение:

python main.py

📖 Использование

1. Настройте API ключ: Если вы не сделали этого на этапе установки, перейдите в Правка > Настройки....
2. Введите или импортируйте текст: Вставьте текст в левую панель или нажмите кнопку "Импорт текста..." для загрузки файла.
3. Выберите язык: Укажите язык, на который нужно перевести текст, в выпадающем списке справа вверху.
4. Нажмите "Перевести": Запустите процесс перевода. Прогресс будет отображаться в строке состояния и на прогресс-баре.
5. Сохраните результат: После завершения перевода вы можете скопировать текст в буфер обмена или экспортировать его в файл с помощью соответствующих кнопок.
6. Сохраните проект: Чтобы вернуться к работе позже, используйте меню Файл > Сохранить проект как....

📂 Структура проекта

• main.py: Точка входа в приложение.
• /core: Основная бизнес-логика (взаимодействие с API, обработка текста, построение промптов).
• /gui: Все, что связано с графическим интерфейсом (окна, диалоги, виджеты).
• /database: Управление базами данных (шаблоны промптов, файлы проектов).
• /resources: Иконки, файлы справки, скриншоты.
• /config: Конфигурация логгера и загрузка настроек из .env.
• /utils: Вспомогательные утилиты (работа с файлами, сетью).
• requirements.txt: Список зависимостей проекта.

⚖️ Лицензия

Этот проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.