Oliveboard Mocks Bot

A powerful Telegram bot repository to connect with Oliveboard Web Interface via COOKIES to fetch & generate visually appealing HTML test files, using your authorised credentials

---

Features

• Fetch test data using COOKIES.
• Support for multi-language questions (English and Hindi).
• Generates enhanced HTML files with styled question and answer content.
• Fixes image URLs dynamically for compatibility.
• Minimal dependencies and efficient performance.

---

Requirements

• Python 3.8+
• Telethon library for interacting with Telegram.
• Internet access to fetch data and communicate with Telegram servers.

---

1. Installing on VPS or Windows

To deploy the bot on your VPS:

1. Clone the Repository:

   git clone -b oliveboard https://github.com/devgaganin/Mocks-Saver-Bot.git olive
   cd olive

2. Install Dependencies: Ensure Python 3.8+ and pip are installed, then run:

   pip install -r requirements.txt

3. Set Up Environment Variables: Create a .env file in the root directory or export the following variables:

   API_ID=your_api_id
   API_HASH=your_api_hash
   BOT_TOKEN=your_bot_token
   COOKIES=you_cookies

4. Run the Bot: Start the bot using:

   python main.py

---

2. Deploying on Heroku

To deploy the bot on Heroku, click the button below and fill in the required environment variables:

Steps:

1. Click the Deploy on Heroku button above.
2. Enter the following required environment variables during deployment:
   • API_ID
   • API_HASH
   • BOT_TOKEN
   • COOKIES
3. Deploy the app and monitor the logs to ensure the bot is running successfully.

---

Commands

Command	Description
/start	Display a welcome message with usage instructions.
/fetch <test_name> <test_id>	Fetch test data from the OliveBoard for the provided test ID and Exam.

---

Usage

1. Start the bot:

   • Type /start in your Telegram chat with the bot.
   • The bot will respond with a welcome message and basic instructions.

2. Fetch a test:

   • Use /fetch <test_name> <test_id>. Replace <test_id> and <test_name> with the specific test ID/name provided.
   • The bot will validate the test ID and retrieve the corresponding test data.

---

Example Workflow

1. /start
   Bot: "Welcome to the Testbook Bot! Use the command /fetch <test_id> to fetch test data."

2. /fetch ntpc1 1
   Bot: "Uploading test papers ... auto submiitting ... uploading solution"

---

License

This project is licensed under the GNU Affero General Public License v3 (APGL-3.x).
Strict Provisions:

• No Commercial Use: This software and its derivatives must not be used for commercial purposes or sold.
• No part of this code, including edits, is allowed to be used for commercial or sale purposes.

© GitHub.com/devgaganin
Unauthorized commercial use is strictly prohibited.

---

Disclaimer

The bot is intended solely for personal and educational purposes.
Use at own responsibilty and copying, modifying part of this code/reuse is not allowed. The developer is not responsible for any misuse or breach of third-party API terms.

For Oliveboard Representatives:

Hey respected representatives, If this project is engaging in any activities that you consider misleading, inappropriate, or in violation of your policies, please feel free to reach out to me immediately. I am committed to resolving any issues and will take necessary actions, including shutting down the project if required.

Contact Information: Email

Thank you for your understanding and cooperation.