Skip to content

🌐 Local AI-powered translator with GUI using Hunyuan-MT models. Private, offline translation for 50+ languages with dual-stage processing (base + Chimera refinement)

License

Notifications You must be signed in to change notification settings

Cr1ator/hunyuan-translator-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 Hunyuan Translator GUI

Python License Platform Status

Локальный, приватный и мощный переводчик с графическим интерфейсом

Работает на моделях Hunyuan-MT-7B и Hunyuan-MT-Chimera-7B

🚀 Установка📖 Использование🔧 Требования🐛 Проблемы


✨ Особенности

🔒 Полная конфиденциальность — Все вычисления происходят локально, данные не покидают ваш компьютер
🎯 Двухэтапный перевод — Базовая модель + улучшение качества с помощью Chimera
🌍 Поддержка 50+ языков — Включая китайский, английский, русский, японский и многие другие
🔍 Автоопределение языка — Автоматически определяет исходный язык текста
Высокое качество — Квантованные 8-битные модели (Q8_0) для оптимального баланса качества и скорости
🖥️ Кроссплатформенность — Windows, macOS, Linux
🎨 Интуитивный интерфейс — Простой и понятный GUI на Tkinter

🎯 Как это работает

  1. Базовый перевод — Модель Hunyuan-MT-7B создает первоначальный перевод
  2. Улучшение — Модель Chimera анализирует и улучшает перевод, исправляя грамматику и стиль
  3. Результат — Вы получаете два варианта: базовый и улучшенный перевод

🔧 Системные требования

Компонент Минимум Рекомендуется
RAM 8 ГБ 16+ ГБ
Свободное место 12 ГБ 20+ ГБ
CPU 4 ядра 8+ ядер
Python 3.8+ 3.10+

⚠️ Внимание: Модели занимают ~11 ГБ дискового пространства и требуют значительного объема RAM для загрузки.

⚙️ Установка

Шаг 1: Клонирование репозитория

git clone https://github.com/Cr1ator/hunyuan-translator-gui.git
cd hunyuan-translator-gui

Шаг 2: Создание виртуального окружения

# Создание виртуального окружения
python -m venv venv

# Активация
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

Шаг 3: Установка зависимостей

pip install -r requirements.txt

Шаг 4: Скачивание моделей

Создайте папку model и скачайте обе модели:

mkdir model
cd model

Скачайте файлы:

Итоговая структура:

hunyuan-translator-gui/
├── model/
│   ├── Hunyuan-MT-7B.Q8_0.gguf
│   └── Hunyuan-MT-Chimera-7B.Q8_0.gguf
├── gui.py
├── model_manager.py
├── main.py
├── requirements.txt
└── README.md

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

Запуск приложения

python main.py

Первый запуск

  1. Нажмите "Загрузить модели" — это займет 2-5 минут
  2. Дождитесь сообщения "Модели готовы к работе!"
  3. Начинайте переводить!

Основ��ые функции

  • Автоопределение языка: Выберите "Автоопределение" в качестве исходного языка
  • Режим Chimera: Включите для получения улучшенного перевода
  • Горячие клавиши: Ctrl+Enter для быстрого перевода
  • Сохранение: Кнопка "Сохранить" для экспорта результатов

🌍 Поддерживаемые языки

Нажмите, чтобы увидеть полный список (50+ языков)
  • Английский (English)
  • Русский (Russian)
  • Китайский (中文)
  • Японский (日本語)
  • Корейский (한국어)
  • Французский (Français)
  • Испанский (Español)
  • Немецкий (Deutsch)
  • Итальянский (Italiano)
  • Португальский (Português)
  • Арабский (العربية)
  • Турецкий (Türkçe)
  • Тайский (ไทย)
  • Вьетнамский (Tiếng Việt)
  • Хинди (हिन्दी)
  • И многие другие...

🐛 Решение проблем

Частые проблемы

❌ "Файлы моделей не найдены"

  • Убедитесь, что файлы .gguf находятся в папке model/
  • Проверьте правильность имен файлов

❌ "Ошибка загрузки моделей"

  • Проверьте, что у вас достаточно RAM (мин. 8 ГБ)
  • Закройте другие ресурсоемкие приложения

❌ Медленная работа

  • Увеличьте количество потоков в model_manager.py (параметр n_threads)
  • Рассмотрите использование моделей меньшего размера (Q4_0 вместо Q8_0)

❌ Проблемы с зависимостями

pip install --upgrade pip
pip install -r requirements.txt --force-reinstall

Логи и диагностика

Для отладки добавьте в начало model_manager.py:

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 Участие в разработке

Мы приветствуем ваш вклад! Возможные улучшения:

  • 🎨 Улучшение UI/UX
  • 🌐 Добавление новых языков
  • ⚡ Оптимизация производительности
  • 📱 Мобильная версия
  • 🔧 Новые функции

Как ��частвовать:

  1. Форкните репозиторий
  2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)
  3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
  4. Отправьте в ветку (git push origin feature/amazing-feature)
  5. Откройте Pull Request

📄 Лицензия

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

🙏 Благодарности

  • Tencent за модели Hunyuan-MT
  • @mradermacher за конвертацию в GGUF формат
  • llama-cpp-python за Python биндинги
  • Сообществу открытого ПО за вдохновение

📞 Поддержка

Если у вас есть вопросы или предложения:


⭐ Если проект оказался полезным, поставьте звездочку!

Сделано с ❤️ для сообщества

About

🌐 Local AI-powered translator with GUI using Hunyuan-MT models. Private, offline translation for 50+ languages with dual-stage processing (base + Chimera refinement)

Topics

Resources

License

Stars

Watchers

Forks

Languages