КИНОЛИБА — Telegram-бот для поиска и хранения фильмов и сериалов

Warning

Разработан в образовательных целях и для личного использования. Не является официальным инструментом сторонних сервисов. Автор не несёт ответственности за последствия его использования.

КИНОЛИБА работает с HUBBLE API и предоставляет удобный Telegram-интерфейс для поиска контента, ведения коллекции и отслеживания дат выхода серий.

Возможности

• Поиск по названию — просто напиши название, бот найдёт фильм или сериал
• Поиск по описанию — опиши своими словами, AI подберёт название (требует OpenRouter)
• Библиотека — карусель с постерами, фильтрами и управлением прямо в чате
• Что посмотреть? — случайный непросмотренный из библиотеки, подбор по настроению или случайная рекомендация от AI (частично требует OpenRouter)
• Похожие — найти похожий контент прямо с карточки
• Даты выхода — когда выйдут новые серии добавленных сериалов

Установка

1. Клонировать репозиторий

git clone https://github.com/cloudsucker/kinoliba.git
cd kinoliba

2. Настроить окружение

cp .env.example .env

Отредактируй .env:

BOT_TOKEN=токен_от_BotFather
BOT_PASSPHRASE=пароль_для_доступа_к_боту
HUBBLE_URL=http://127.0.0.1:8080/
OPENROUTER_API_KEY=ключ_openrouter   # опционально, для AI-функций
OPENROUTER_MODEL=google/gemini-2.0-flash-lite

OpenRouter не обязателен. Без ключа поиск по описанию и «Что посмотреть? → По настроению/Удивить» просто не появятся в интерфейсе.

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

python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate
pip install -r requirements.txt

4. Запустить

python main.py

Деплой на сервер

sudo bash deploy.sh

Скрипт интерактивно создаст .env, установит зависимости и настроит systemd-сервис.

HUBBLE API

Для работы бота требуется локально запущенный HUBBLE API. URL настраивается через HUBBLE_URL в .env (по умолчанию http://127.0.0.1:8080/).

Обратная связь

По всем вопросам: ferjenkill@gmail.com