sammaryhelper

Описание проекта

Sammaryhelper - это приложение с графическим интерфейсом для автоматизированного анализа и суммаризации диалогов Telegram. Приложение использует API OpenAI для создания кратких содержаний переписок, что позволяет пользователям быстро получать суть обсуждений без необходимости чтения всего диалога.

Функциональные возможности

• Подключение к учетной записи Telegram через клиентское API
• Загрузка и анализ диалогов из выбранных чатов
• Генерация кратких содержаний сообщений с использованием моделей OpenAI
• Анализ участников диалога
• Настраиваемые параметры суммаризации
• Сохранение истории анализа

Требования

• Python 3.8+
• Telethon (библиотека для работы с Telegram API)
• OpenAI API (требуется API ключ)
• Asyncio
• Tkinter (для графического интерфейса)

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

Windows

# Клонирование репозитория
git clone https://github.com/yourusername/sammaryhelper.git
cd sammaryhelper

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

# Активация виртуального окружения
# Для PowerShell (с правами на выполнение скриптов):
.\venv\Scripts\Activate.ps1
# Или для cmd:
venv\Scripts\activate.bat

# Установка зависимостей
pip install -r requirements.txt

# Запуск приложения
python -m Sammaryhelper.main

Linux/MacOS

# Клонирование репозитория
git clone https://github.com/yourusername/sammaryhelper.git
cd sammaryhelper

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

# Активация виртуального окружения
source venv/bin/activate

# Установка зависимостей
pip install -r requirements.txt

# Запуск приложения
python -m Sammaryhelper.main

Настройка

1. При первом запуске вам потребуется ввести данные вашего аккаунта Telegram (номер телефона, код подтверждения)
2. Также необходимо указать API ключ OpenAI в соответствующем поле настроек
3. Выберите модель OpenAI для генерации суммарий (по умолчанию используется chatgpt-4o-latest)
4. Настройте прочие параметры в соответствии с вашими потребностями

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

1. После подключения к Telegram выберите чат или группу для анализа
2. Укажите количество сообщений для анализа
3. Нажмите кнопку "Анализировать диалоги" для получения суммарии
4. Результаты анализа будут отображены в основном окне приложения
5. При необходимости можно экспортировать результаты или задать дополнительные вопросы ИИ

Устранение проблем

• Если возникают проблемы с активацией виртуального окружения в PowerShell, попробуйте запустить PowerShell с правами администратора и выполнить:

  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  

• При проблемах с установкой asyncpg==0.29.0e, используйте:

  pip install asyncpg
  

Лицензия

AGPL-3.0