✨ Aspirant AI - AI-Powered Learning Assistant 🚀

Empowering learners with AI-driven education! 📚✨

Aspirant AI is an intelligent learning platform leveraging Google's Gemini AI to generate practice questions, explain complex concepts, and now available both as a website and Telegram bot! 🎉

🌟 Features

✅ Dynamic question generation for competitive exams
✅ Concept explanations with real-life examples
✅ Adaptive difficulty levels for personalized learning
✅ Web-based Interface & Fully Functional Telegram Bot 🤖
✅ Sleek, modern UI for seamless interaction
✅ Supports multiple subjects and topics

---

🎬 Aspirant AI Intro Video

🔹 Click the image to watch the full video!

---

🖥 Web Interface Preview

🔹 This is what the frontend of Aspirant AI looks like!

---

🔥 Installation & Setup

git clone https://github.com/Aspirant-ai/aspirant-ai.git
cd aspirant-ai
python -m venv venv
venv\Scripts\activate  # For Windows
source venv/bin/activate  # For macOS/Linux
pip install -r requirements.txt

---

⚙️ Configuration

1. Create a .env file:

GEMINI_API_KEY=your_actual_api_key_here
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

2. Get your Gemini API Key from Google AI Studio.
3. Obtain your Telegram Bot Token from BotFather.

---

🚀 Deployment & Hosting

Render Configuration:

• Build Command: pip install -r requirements.txt
• Start Command: pip install gunicorn && gunicorn gunicorn_server:app

---

🎯 How to Use

🌍 Web Interface

Simply visit: Aspirant AI Web and start learning! 🖥️

🤖 Telegram Bot Commands

• /start - Start the bot
• /generate <topic> - Generate AI-powered questions on any topic
• /ask <question> - Get AI-powered explanations
• /help - Get assistance on how to use the bot

---

📁 Project Structure

aspirant-ai/
├── app.py               # Main Flask application
├── telegram_bot.py      # Telegram Bot Integration
├── templates/           # HTML templates
│   └── index.html
├── static/              # CSS/JS assets
│   ├── style.css
│   └── script.js
├── requirements.txt     # Dependencies
└── gunicorn_server.py   # Production server config

---

🛠 Tech Stack

🔹 Backend: Flask + Gemini AI
🔹 Frontend: HTML5/CSS3 + JavaScript
🔹 Bot: Telegram API Integration
🔹 Hosting: Render (Auto-deploy)
🔹 WSGI Server: Gunicorn

---

🏆 Contributing

We welcome contributions! 🚀 If you'd like to contribute:

1. Fork the repo
2. Create a feature branch
3. Commit and push your changes
4. Open a PR!

Please follow PEP8 coding guidelines.

---

📬 Contact & Support

📧 Email: support
🐛 GitHub Issues: Report Bugs/Requests
💬 Community Discord: Join Discussion

---

🌟 Join us on this AI-powered learning journey and supercharge your education! 🚀📚