An interactive AI-powered Telegram educational mentor designed for structured concept explanation, doubt clearing, and automated MCQ quiz generation aligned with academic syllabi.
Features • Commands • Syllabus • Setup • Maintainer
- 🎯 Syllabus-Constrained Explanations: Tailored system prompts keep responses strictly focused on core academic curricula (Science, Mathematics, Social Studies), eliminating out-of-scope hallucinations.
- 📝 Automated MCQ Generator: Generates structured multiple-choice questions on demand for active recall and self-assessment.
- 💡 Structured Point-Wise Output: Answers are formatted with rich HTML markup (
<b>,<i>, bullet points) for enhanced mobile readability. - 👥 Group & Direct Chat Support: Operates seamlessly in private student chats or shared student study groups with user access controls.
- ☁️ Cloud Deployable: Includes production
Procfileready for Heroku, Railway, or VPS background daemon execution.
| Command | Arguments | Description |
|---|---|---|
/start |
— | Initializes the bot and presents the curriculum menu. |
/answer |
<topic or query> |
Requests a clear, structured explanation for a specific subject doubt. |
/mcq |
<topic> |
Generates a multiple-choice practice question with answer choices. |
/info |
— | Displays Telegram user ID, chat telemetry, and session state. |
The bot comes pre-configured with contextual knowledge across core secondary school curricula:
- 🔬 Science: Chemical Reactions, Acids/Bases/Salts, Metals, Carbon Compounds, Life Processes, Heredity & Evolution, Optics, Electricity & Magnetism.
- 📐 Mathematics: Real Numbers, Polynomials, Linear & Quadratic Equations, Coordinate Geometry, Trigonometry, Statistics & Probability.
- 🌍 Social Sciences: Nationalism in Europe/India, Resources, Agriculture, Federalism, Economic Development.
- Python 3.9+
- A valid Telegram Bot Token from @BotFather
# Clone the repository
git clone https://github.com/0xOpCode/study-bot.git
cd study-bot
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txtSet the required environment variable:
export BOT_TOK="your_telegram_bot_token"python main.pyThe project includes a Procfile:
worker: python main.py
Created and maintained by 0xOpCode.