🎓 NBKRIST ATTENDANCE Bot

A modern, AI-powered Telegram bot revolutionizing college attendance and communication.

🤖 Try the bot: @nbkrist_attendence

✨ Features

Core Capabilities

• 📱 Automated Attendance System - Real-time tracking and updates
• 🤖 AI-Powered Responses - Powered by Google's Gemini Model
• 👥 Smart Registration - Seamless student onboarding
• 📢 Admin Dashboard - Comprehensive control panel

Coming Soon 🚀

• 📊 Multi-year support
• 🎯 Department-specific features
• 📅 Advanced scheduling
• 📚 Resource sharing

🛠️ Tech Stack

• Framework: Pyrogram
• AI Engine: Google Gemini
• Database: SQLite
• Authentication: Telegram API

🚀 Quick Start

Prerequisites

• Python 3.7+
• Telegram Account
• Bot Token from @BotFather

Installation

1. Clone & Navigate

   git clone <repository-url>
   cd CollageBot

2. Set Up Environment

   pip install -r requirements.txt

3. Configure Environment Create .env file:

   BOT_TOKEN=your_bot_token
   ADMIN_CHAT_ID=your_admin_id
   API_ID=your_api_id
   API_HASH=your_api_hash

4. Launch

   python main.py

🎯 Future Roadmap

Phase 1: Extended Access 🌐

• Cross-year compatibility
• Multi-department support
• Scalable infrastructure

Phase 2: Enhanced Features 💫

• 📅 Smart timetable integration
• 📢 Department announcements
• 📊 Custom attendance analytics
• 🤖 Advanced AI interactions
• 📚 Study resource hub

Phase 3: Technical Evolution 🔧

• 🔄 Optimized database architecture
• 🚀 Performance enhancements
• 🔒 Advanced security protocols
• 📊 Analytics dashboard
• 💾 Automated backup systems

📁 Project Structure

CollageBot/
├── 📜 main.py           # Core bot logic
├── 📋 requirements.txt  # Dependencies
├── ⚙️ .env             # Configuration
└── 🔌 plugins/
    ├── register.py     # User registration
    ├── attendence.py   # Attendance system
    ├── greetings.py    # User interactions
    └── db_connection.py # Database handling

🤝 Contributing

We welcome contributions! Feel free to:

1. 🍴 Fork the repository
2. 🔨 Make your changes
3. 📤 Submit a pull request

📝 License

Released under the MIT License. See LICENSE for details.

👨‍💻 Author

Made with ❤️ by tobioffice

---

_{Built for NBKRIST College Community}