Tajiko Telegram Bot

Telegram bot project for learning Tajik from A0 to B2. The repo includes a CEFR-aligned curriculum, short lessons, SRS review, and a working aiogram skeleton.

What is included

• Pedagogical concept and methodology (CEFR, CLT, SRS, Active Recall, Comprehensible Input, Task-Based, Spiral Learning)
• Full course structure A0-B2 with lesson lists, goals, grammar, vocabulary, and skills
• Standard lesson format with tasks, dialogue, review, and mini-test
• Full content pack (A0-B2 lessons, lexicon lists, dialogues, task templates)
• Telegram bot architecture, user journey, and data model
• Python (aiogram) bot skeleton with handlers and services

Quick start

1. Create a bot token via BotFather.
2. Copy .env.example to .env and fill values.
3. Install dependencies:

   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

4. Run the bot:

   python -m bot.main

Project structure

• docs/ - methodology, curriculum, lesson format, architecture, technical design, roadmap
• data/ - lesson JSON, vocab lists, dialogues, task templates
• bot/ - aiogram bot code

Content format

• Lesson schema and examples: docs/lesson_format.md
• Content samples list: docs/content_samples.md

Environment variables

See .env.example.

Notes

• Default DB is SQLite for local run; schema is compatible with PostgreSQL.
• Content uses Tajik Cyrillic with Russian explanations.