tilora 1.0.0
🗣️ Двусторонний переводчик карачаевского и русского языков с поддержкой OCR
License: MIT
Requires Python: >=3.7
Keywords: karachay, translator, ocr, russian, dictionary

﻿# TILO.RA

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/thetemirbolatov-official/tilora/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Status](https://img.shields.io/badge/status-Ready%20for%20Release-brightgreen.svg)](https://github.com/thetemirbolatov-official/tilora)

**Десктопный переводчик карачаевского языка. Работает онлайн.**

> ⚠️ **Внимание:** Этот файл TILORA.exe является первоначальной версией приложения. Для скачивания других версий (macOS, iOS, Android) следите за обновлениями.

## 📥 Скачать установщик

### Текущая версия для Windows
- **Файл:** `Установщик.rar`
- **Поддержка:** Windows 7, 8, 10, 11 (64-bit)
- **Размер:** ~35 MB
- **Статус:** Готов к выпуску

### Как скачать
1. **Прямая ссылка:** [СКАЧАТЬ TILORA.exe](ссылка будет добавлена перед выпуском)

## 🚀 Установка и запуск

### Простая установка
1. Скачайте файл `Установщик.rar`
2. Запустите его двойным кликом
3. Следуйте инструкциям установщика
4. После установки программа появится в меню "Пуск"


### Системные требования
| Компонент | Минимальные требования | Рекомендуемые |
|-----------|------------------------|---------------|
| **ОС** | Windows 7 SP1 | Windows 10/11 |
| **Архитектура** | x32 (32-bit) | x64 |
| **Память** | 2 ГБ ОЗУ | 4 ГБ ОЗУ |
| **Место на диске** | 100 МБ | 500 МБ |
| **Дополнительно** | .NET Framework 4.7.2 | .NET Framework 4.8 |

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

### Перевод текста
- **Двусторонний перевод:** Русский ↔ Карачаевский
- **Контекстный перевод:** Учитывает грамматические особенности
- **Быстрый перевод:** Мгновенная обработка текста

### Управление переводом
- **История переводов:** Сохранение всех выполненных переводов
- **Избранное:** Закладки для важных фраз
- **Экспорт:** Сохранение переводов в текстовые файлы
- **Буфер обмена:** Быстрое копирование результатов

### Интерфейс
- **Тёмная тема:** Элегантный тёмный интерфейс
- **Адаптивный дизайн:** Поддержка разных размеров окна
- **Минималистичный:** Ничего лишнего, только функционал
- **Быстрые клавиши:** Горячие клавиши для всех действий

## 🔧 Настройки приложения

### Языковые настройки
- Автоматическое определение языка
- Настройки форматирования текста
- Варианты перевода (дословный/контекстный)

### Интерфейс
- Выбор темы (тёмная/светлая)
- Настройка шрифтов
- Размер интерфейса
- Язык интерфейса

### Производительность
- Настройки кэширования
- Оптимизация для слабых ПК
- Автоматические обновления словаря

## 📁 Структура файлов

```
C:\Program Files\TILORA\
├── TILORA.exe              # Основной исполняемый файл     
└── datas\                  # Логи работы
    └── images
```

## 🛠 Устранение неполадок

### Частые проблемы и решения

| Проблема | Решение |
|----------|---------|
| **Не запускается на Windows 7** | Установите [.NET Framework 4.8](https://dotnet.microsoft.com/download/dotnet-framework/net48) |
| **Ошибка "Отказано в доступе"** | Запустите от имени администратора или отключите антивирус |
| **Не определяет карачаевский текст** | Проверьте кодировку текста (используйте UTF-8) |
| **Медленная работа** | Закройте другие программы, освободите память |
| **Ошибка словаря** | Переустановите приложение или восстановите словарь |

### Антивирусы
Некоторые антивирусы могут блокировать работу. Если возникают проблемы:
1. Добавьте `TILORA.exe` в исключения антивируса
2. Или временно отключите антивирус на время установки

## 📞 Поддержка и обратная связь

### Сообщить об ошибке
Если вы обнаружили баг или проблему:
1. **Скриншот:** Сделайте скриншот ошибки
2. **Шаги воспроизведения:** Опишите, как получить эту ошибку
3. **Отправить:** Отправьте на почту или в Telegram

### Предложить улучшение
Есть идеи для улучшения? Напишите:
- Что именно вы хотите улучшить
- Как это должно работать
- Почему это важно

### Контакты разработчика
- **Telegram:** [@thetemirbolatov](https://t.me/thetemirbolatov)
- **Instagram:** [@thetemirbolatov](https://instagram.com/thetemirbolatov)
- **GitHub:** [@thetemirbolatov](https://github.com/thetemirbolatov)
- **Email:**  mirajestory@gmail.com

## 🔄 Обновления

### Текущая версия: 1.0.0
- Первый релиз для Windows
- Базовая функциональность перевода
- Локальная работа без интернета

### Планируемые обновления
1. **Версия 1.1.0:** Улучшение словарной базы
2. **Версия 1.2.0:** Добавление голосового ввода
3. **Версия 2.0.0:** Версии для macOS, Android, iOS

### Как получать обновления
1. Следите за новостями в Telegram канале
2. Проверяйте обновления в настройках приложения
3. Регулярно проверяйте этот README

## 🤝 Контрибьютинг

### Как помочь проекту
1. **Тестирование:** Тестируйте приложение, сообщайте о багах
2. **Словари:** Помогите расширить словарную базу
3. **Переводы:** Помогите с переводами интерфейса
4. **Распространение:** Расскажите о проекте друзьям

### Для разработчиков
Проект закрытый, но вы можете:
1. Предложить улучшения кода
2. Помочь с оптимизацией
3. Предложить новые функции

## ⚖️ Лицензия и права

### Лицензионное соглашение
Используя TILO.RA, вы соглашаетесь:
1. Использовать только в личных целях
2. Не распространять без разрешения
3. Не декомпилировать и не модифицировать

### Авторские права
© 2026 thetemirbolatov Все права защищены.

## 🌟 Поддержать проект

Если вам нравится TILO.RA и вы хотите поддержать развитие:
- **Расскажите друзьям** о проекте
- **Оставьте отзыв** в соцсетях
- **Предложите улучшения** для будущих версий

---

> **Примечание:** Это первая версия приложения. Мы постоянно работаем над улучшениями. Ваши отзывы очень важны для нас!

**Скачайте сейчас и начните переводить!**

 
 # 🗣️ Tilora — Карачаевско-русский и русско-карачаевский переводчик

**Версия:** 1.0.0  
**Автор:** Temirbolatov (@thetemirbolatov)  
**Лицензия:** MIT  
**Статус:** Стабильный релиз 🚀

---

## 🌟 О проекте

**Tilora** — это мощная, профессиональная библиотека для двустороннего перевода между карачаевским и русским языками. 

Разработана с любовью к карачаевскому языку и культуре. Библиотека использует обширную базу данных слов, фраз и идиом, обеспечивая максимально точный перевод с сохранением контекста, регистра и пунктуации.

---

## ✨ Возможности

| Функция | Описание |
|---------|----------|
| 🔄 **Двусторонний перевод** | Русский ↔ Карачаевский |
| 🎯 **Приоритет фраз** | Сначала ищет точные фразы и идиомы |
| 📖 **Дословный перевод** | Если фраза не найдена — переводит по словам |
| 🖼️ **OCR с фото** | Извлекает текст с изображений и переводит |
| 📦 **Пакетная обработка** | Перевод нескольких текстов за раз |
| ⚡ **Кэширование** | Высокая скорость повторных переводов |
| 🎨 **Сохранение форматирования** | Регистр, пунктуация, пробелы |
| 📊 **Статистика** | Детальная информация о переводах |
| 🔍 **Автоопределение языка** | Автоматически определяет исходный язык |

---

## 📦 Установка

### Базовая установка

```bash
pip install tilora
С поддержкой OCR (распознавание текста с фото)
bash
pip install tilora[ocr]
Установка из исходников
bash
git clone https://github.com/thetemirbolatov-official/tilora.git
cd tilora
pip install -e .
🔧 Требования к системе
Минимальные требования
Python 3.7+

100 МБ свободного места

2 ГБ ОЗУ (рекомендуется)

Для работы OCR (Windows)
ВАЖНО! Tesseract OCR не входит в комплект библиотеки. Для работы с изображениями необходимо:

Скачать Tesseract OCR:
https://github.com/UB-Mannheim/tesseract/wiki

Установить в любую папку (рекомендуется: C:\Program Files\Tesseract-OCR\)

Или поместить tesseract.exe в папку data вашего проекта

Библиотека автоматически найдёт Tesseract в системе или в папке data.

🚀 Быстрый старт
Минимальный пример
python
from tilora import translate

# Простой перевод
print(translate("привет"))          # салам
print(translate("салам"))           # привет
print(translate("доброе утро"))     # эртденги салам
Расширенное использование
python
from tilora import KarachayTranslator, detect_language

# Создаём экземпляр переводчика
translator = KarachayTranslator()

# Перевод с деталями
result = translator.translate("как дела", return_details=True)

print(f"Оригинал: {result.original_text}")
print(f"Перевод: {result.translated_text}")
print(f"Язык: {result.source_language}")
print(f"Уверенность: {result.confidence:.1%}")
print(f"Тип: {result.translation_type}")
📖 Полная документация
1. Базовые функции
translate(text, from_lang=None, to_lang=None)
Быстрый перевод текста.

python
from tilora import translate

# Автоопределение языка
print(translate("привет"))           # салам
print(translate("салам"))            # привет

# Принудительное указание языка
print(translate("привет", from_lang='ru'))     # салам
print(translate("салам", from_lang='qar'))     # привет
detect_language(text)
Определение языка текста.

python
from tilora import detect_language

print(detect_language("привет"))     # ru
print(detect_language("салам"))      # qar
print(detect_language("къалайса"))   # qar
translate_batch(texts)
Пакетный перевод нескольких текстов.

python
from tilora import translate_batch

texts = ["привет", "как дела", "до свидания"]
results = translate_batch(texts)

for original, translated in zip(texts, results):
    print(f"{original} → {translated}")
2. Класс KarachayTranslator
Полный контроль над процессом перевода.

python
from tilora import KarachayTranslator

# Инициализация
translator = KarachayTranslator()

# Указание пути к словарю
translator = KarachayTranslator("data/words.json")

# Перевод с детальной информацией
result = translator.translate("доброе утро", return_details=True)

print(f"Перевод: {result.translated_text}")
print(f"Тип: {result.translation_type}")  # exact_phrase, partial_phrase, word_by_word
print(f"Альтернативы: {result.alternatives}")
Методы класса:
Метод	Описание
translate(text, ...)	Основной метод перевода
translate_batch(texts, ...)	Пакетный перевод
translate_from_image(image_path)	Перевод с изображения
translate_with_alternatives(text, max_alternatives=3)	Варианты перевода
get_dictionary_stats()	Статистика словаря
get_translator_stats()	Статистика переводов
clear_cache()	Очистка кэша
3. OCR — Распознавание текста с фото
python
from tilora import translate_image, KarachayTranslator

# Быстрый способ
text = translate_image("photo.jpg")
print(f"Перевод с фото: {text}")

# Расширенный способ
translator = KarachayTranslator()
result = translator.translate_from_image("photo.jpg")

if result:
    print(f"Распознано: {result.original_text}")
    print(f"Перевод: {result.translated_text}")
Поддерживаемые форматы: JPG, JPEG, PNG, BMP, TIFF, WEBP

4. Альтернативные переводы
python
from tilora import KarachayTranslator

translator = KarachayTranslator()

# Получить несколько вариантов перевода
variants = translator.translate_with_alternatives("спасибо", max_alternatives=3)

for i, variant in enumerate(variants, 1):
    print(f"{i}. {variant}")
5. Статистика и информация
python
from tilora import KarachayTranslator

translator = KarachayTranslator()

# Статистика словаря
dict_stats = translator.get_dictionary_stats()
print(f"📚 Слов в словаре: {dict_stats['total_words']}")
print(f"📝 Фраз: {dict_stats['total_phrases']}")
print(f"🇷🇺 Русско-карачаевских: {dict_stats['ru_entries']}")
print(f"🇰🇬 Карачаевско-русских: {dict_stats['qar_entries']}")

# Статистика переводов
trans_stats = translator.get_translator_stats()
print(f"⚡ Выполнено переводов: {trans_stats['total_translations']}")
print(f"💾 Кэш: {trans_stats['cache_size']} записей")
print(f"🎯 Эффективность кэша: {trans_stats['cache_ratio']:.1%}")
🎯 Примеры использования
Пример 1: Интерактивный переводчик
python
from tilora import translate, detect_language

print("🔄 Tilora Переводчик (выход: 'q')")
print("-" * 40)

while True:
    text = input("\n📝 Введите текст: ").strip()
    
    if text.lower() == 'q':
        break
    
    if not text:
        continue
    
    lang = detect_language(text)
    lang_name = "🇷🇺 Русский" if lang == 'ru' else "🇰🇬 Карачаевский"
    
    result = translate(text)
    
    print(f"{lang_name} → {result}")
Пример 2: Перевод файла
python
from tilora import KarachayTranslator

def translate_file(input_path, output_path):
    translator = KarachayTranslator()
    
    with open(input_path, 'r', encoding='utf-8') as f:
        text = f.read()
    
    translated = translator.translate(text)
    
    with open(output_path, 'w', encoding='utf-8') as f:
        f.write(translated)
    
    print(f"✅ Перевод сохранён в {output_path}")

translate_file("input.txt", "output.txt")
Пример 3: Пакетная обработка фото
python
import os
from tilora import translate_image

folder = "photos"
results = {}

for filename in os.listdir(folder):
    if filename.lower().endswith(('.jpg', '.jpeg', '.png')):
        path = os.path.join(folder, filename)
        translation = translate_image(path)
        results[filename] = translation
        print(f"{filename} → {translation[:50]}...")

# Сохраняем результаты
with open("translations.txt", "w", encoding="utf-8") as f:
    for filename, translation in results.items():
        f.write(f"{filename}: {translation}\n")
📊 Производительность
Операция	Скорость
Перевод слова	< 0.001 сек
Перевод фразы (5-10 слов)	< 0.005 сек
Перевод предложения (20+ слов)	< 0.02 сек
OCR + перевод фото	0.5-2 сек
Кэшированный перевод	< 0.0001 сек
🔄 Обновление
bash
# Обновление библиотеки
pip install --upgrade tilora

# Проверка версии
python -c "import tilora; print(tilora.__version__)"
❗ Часто задаваемые вопросы
❓ Не работает OCR. Что делать?
Установите Tesseract OCR:
https://github.com/UB-Mannheim/tesseract/wiki

Или поместите tesseract.exe в папку data вашего проекта

Проверьте установку:

python
from tilora import KarachayTranslator
tr = KarachayTranslator()
print(tr.translate_from_image("test.jpg"))
❓ Где скачать словарь?
Словарь words.json автоматически загружается при установке библиотеки и находится в папке data пакета.

❓ Поддерживаются ли другие языки?
В текущей версии поддерживаются только русский и карачаевский языки.

❓ Можно ли использовать в коммерческих проектах?
Да, библиотека распространяется под лицензией MIT, что позволяет использовать её в любых проектах, включая коммерческие.

🤝 Содействие проекту
Мы приветствуем любой вклад в развитие проекта!

Как помочь:
⭐ Поставьте звезду на GitHub

🐛 Сообщайте об ошибках в Issues

💡 Предлагайте улучшения

📖 Дополняйте словарь новыми словами и фразами

🌐 Рассказывайте о проекте в соцсетях

👨‍💻 Автор
Temirbolatov (@thetemirbolatov)

Разработчик, энтузиаст карачаевского языка и культуры.

📱 Социальные сети:
Платформа	Никнейм
ВКонтакте	@thetemirbolatov
Instagram	@thetemirbolatov
Telegram	@thetemirbolatov
GitHub	@thetemirbolatov-official
📧 Контакт:
По всем вопросам: thetemirbolatov@gmail.com

📄 Лицензия
MIT License

Copyright (c) 2024 Temirbolatov

Разрешается свободное использование, копирование, модификация и распространение при условии сохранения уведомления об авторстве.

🌟 Благодарности
Спасибо всем, кто помогает сохранять и развивать карачаевский язык!

Особая благодарность:

Карачаевскому научно-исследовательскому институту

Всем носителям языка, участвовавшим в составлении словаря

Сообществу разработчиков open-source


Сделано для карачаевского языка