Konstantin-vanov-hub

Article-Assistant--RAG-Telegram-Bot: Ask Articles in Telegram

A Python Telegram bot built on OpenAI GPT-4 for asking questions about web articles and uploaded documents, with answers grounded in indexed sources. It also summarizes content and can transcribe YouTube videos with OpenAI Whisper.

InactivePythonMITAIRAGChatbot
View on GitHub Compare
Stars
54
Forks
6
Stars, last 30 days
-1
Last commit
1 year ago
Contributors
1

Our take

Inactiveno commits in over a year

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

-1 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

This is a practical, self-hostable RAG bot for personal document Q&A, but its inactive development and single-contributor history make it a cautious choice for ongoing deployments.

Good fit if

  • You want document and article Q&A inside Telegram, with citations and summaries.
  • You can provide Telegram and OpenAI credentials and are comfortable running Python or Docker Compose.
  • You want MIT-licensed code that you can inspect or adapt.

Look elsewhere if

  • You need a project with recent maintenance, multiple contributors, or a record of releases.
  • Your deployment cannot send content to OpenAI services.
  • You need a supported workflow beyond the documented URL, PDF, TXT, and YouTube inputs.
All health signals
Last commit2025-10-06 (1 year ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age15 months

Checked on 2026-10-20 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

54

Forks

6

Change since Nov 14, 2026: 0 stars·0 forks

Overview

Article Assistant is a Python Telegram bot built on OpenAI GPT-4 that turns web articles, PDFs, and text files into searchable knowledge bases. Users can ask questions in Telegram and receive answers with source citations, rather than searching through documents themselves. It also uses OpenAI Whisper to transcribe YouTube videos for questions and summaries.

The bot offers English and Russian interfaces and is intended for people who want a conversational way to work with a personal collection of reading or reference material. It runs with a Telegram bot token and OpenAI API key, either directly in Python or with Docker Compose.

Key Features

  • Index web pages from URLs for later question answering.
  • Process uploaded PDF and TXT documents.
  • Transcribe YouTube videos with OpenAI Whisper, with a stated two-hour maximum.
  • Answer questions about indexed material and provide source citations.
  • Summarize indexed content into key points.
  • Switch between English and Russian interfaces.
  • Configure AI behavior with custom prompts.

Use Cases

  • Readers can collect articles and ask focused questions instead of rereading full pages.
  • Students or researchers can query PDFs and text notes from a Telegram chat.
  • Video viewers can get searchable transcripts and summaries of supported YouTube videos.
  • Teams can deploy a document Q&A bot for a small, shared workflow, provided they are comfortable managing the bot and API credentials themselves.

What you need

Detected in the repository

  • Python (from requirements.txt)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Clone the repository, configure .env with TELEGRAM_TOKEN and OPENAI_API_KEY, then start with Docker Compose:

git clone https://github.com/KonstantinVanov/Article-Assistant--RAG-Telegram-Bot.git
cd Article-Assistant--RAG-Telegram-Bot
cp .env.example .env
# Set TELEGRAM_TOKEN and OPENAI_API_KEY in .env
docker-compose up -d --build

See the README for traditional Python installation, configuration details, and troubleshooting.

Alternatives

  • kotaemon: kotaemon offers document RAG Q&A through a customizable web app, rather than a Telegram bot focused on articles and uploads.
ProjectLanguageLicenseStarsStatus
Article-Assistant--RAG-Telegram-BotPythonMIT54Inactive
kotaemonPythonApache-2.025.8kQuiet

Considerations

The repository has had no commits in over a year and no releases in the past year; all recorded contributions come from one person. The supplied project data also reports no test suite or CI configuration, so adopters should validate changes and deployments themselves. Runtime use requires a Telegram bot token and an OpenAI API key, and the README notes a 10 MB file limit and a two-hour YouTube video limit. Processing depends on external OpenAI services, so account access, costs, and handling of submitted content should be assessed before use.

Found this useful?

Share it with someone who would like Article-Assistant--RAG-Telegram-Bot.

Comparisons