Our take
Inactiveno commits in over a year- 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 commit | 2025-10-06 (1 year ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 0 |
| Contributors | 1 |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 15 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.
Stars
54Forks
6Change 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.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| Article-Assistant--RAG-Telegram-Bot | Python | MIT | 54 | Inactive |
| kotaemon | Python | Apache-2.0 | 25.8k | Quiet |
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.