{"id":48752376,"url":"https://github.com/GraveEaterMadison/Raspberry_pi_telegram_bot","last_synced_at":"2026-04-15T00:01:30.089Z","repository":{"id":254390601,"uuid":"846391722","full_name":"GraveEaterMadison/Raspberry_pi_telegram_bot","owner":"GraveEaterMadison","description":"The Raspberry Pi Telegram Bot is a lightweight, customizable bot built for Raspberry Pi users. It leverages Python and the Telegram Bot API to enable users to execute commands, receive updates, and automate processes from their Telegram account. Ideal for DIY projects, home automation, and remote control applications, this bot is easy to set up .","archived":false,"fork":false,"pushed_at":"2025-05-15T15:27:35.000Z","size":109,"stargazers_count":24,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-08T08:39:59.157Z","etag":null,"topics":["bot","home-automation","iot","notifications","python-library","raspberry-pi-4b","sensors","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GraveEaterMadison.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-23T05:33:50.000Z","updated_at":"2025-10-07T23:26:10.000Z","dependencies_parsed_at":"2025-09-08T20:34:53.818Z","dependency_job_id":"7a74646b-e171-462f-be2d-38aa888c2af2","html_url":"https://github.com/GraveEaterMadison/Raspberry_pi_telegram_bot","commit_stats":null,"previous_names":["graveeatermadison/raspberry_pi_telegram_bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GraveEaterMadison/Raspberry_pi_telegram_bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FRaspberry_pi_telegram_bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FRaspberry_pi_telegram_bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FRaspberry_pi_telegram_bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FRaspberry_pi_telegram_bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GraveEaterMadison","download_url":"https://codeload.github.com/GraveEaterMadison/Raspberry_pi_telegram_bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FRaspberry_pi_telegram_bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31820369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","home-automation","iot","notifications","python-library","raspberry-pi-4b","sensors","telegram-bot"],"created_at":"2026-04-12T21:00:16.526Z","updated_at":"2026-04-15T00:01:30.084Z","avatar_url":"https://github.com/GraveEaterMadison.png","language":"Python","funding_links":[],"categories":["Projects"],"sub_categories":[],"readme":"# Raspberry Pi Telegram Bot\n\n![Python](https://img.shields.io/badge/Python-3.11-blue.svg)\n![Raspberry Pi](https://img.shields.io/badge/Raspberry%20Pi-Model%20B-orange)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nA versatile Telegram bot that runs on a Raspberry Pi, allowing you to control your Pi and interact with it remotely via Telegram. This project is designed to help you automate tasks, gather system information, and manage your Raspberry Pi from anywhere.\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n- [Commands](#commands)\n- [File Structure](#file-structure)\n- [Contributing](#contributing)\n- [License](#license)\n- [Acknowledgements](#acknowledgements)\n\n## Features\n\n- **Remote Access**: Control your Raspberry Pi remotely via Telegram.\n- **System Monitoring**: Fetch real-time system information such as CPU usage, memory stats, and disk space.\n- **Automation**: Set up custom commands to automate various tasks.\n- **Modular Design**: Easily extend functionality by adding new modules to the bot.\n- **Secure**: Uses Telegram's secure API for bot communication, with customizable access controls.\n\n## Installation\n\n### Prerequisites\n\n- A Raspberry Pi running a Debian-based OS (e.g., Raspbian).\n- Python 3.11 installed.\n- A Telegram account to create a bot.\n\n### Steps\n\n1. **Clone the Repository**:\n    ```bash\n    git clone https://github.com/GraveEaterMadison/Raspberry_pi_telegram_bot.git\n    cd Raspberry_pi_telegram_bot\n    ```\n\n2. **Install Required Dependencies**:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. **Create a Telegram Bot**:\n   - Message [@BotFather](https://t.me/BotFather) on Telegram.\n   - Use the `/newbot` command to create your bot and get the API token.\n\n4. **Configure the Bot**:\n   - Copy the `config.py` and add your bot token and other configuration details.\n\n5. **Run the Bot**:\n    ```bash\n    python main.py\n    ```\n\n## Configuration\n\nEdit the `config.py` file to set your bot's configuration. Here's a breakdown of the essential settings:\n\n- **TOKEN**: Your Telegram bot token provided by BotFather.\n- **AUTHORIZED_USERS**: A list of Telegram user IDs allowed to interact with the bot.\n\n```python\nTOKEN = 'YOUR_TELEGRAM_BOT_TOKEN'\nAUTHORIZED_USERS = [123456789, 987654321]\n```\n\n## Usage\n\nOnce the bot is up and running, you can start sending commands via Telegram. The bot will respond with the requested information or perform the specified task.\n\n\n### Commands\n\nYou can add more commands by modifying the main.py file and defining new functions to handle those commands.\n\n### Example Commands\n\nHere are some example commands you can use:\n\n- **Start the bot**:\n  ```text\n  /start\n  ```\n\n- **List all available command**:\n  ```text\n  /help\n  ```\n\n- **Reboot the Raspberry Pi**:\n  ```text\n  /reboot\n  ```\n\n- **Shutdown the Raspberry Pi**:\n  ```text\n  /shutdown\n  ```\n  \n- **execute command remotely**:\n  ```text\n  /exec\n  ```\n  \n- **Check CPU usage**:\n  ```text\n  /cpu\n  ```\n\n- **Check ram usage**:\n   ```text\n  /ram\n  ```\n\n- **Check disk space**:\n   ```text\n  /disk\n  ```\n\n- **Turn on an LED connected to GPIO pin**:\n   ```text\n  /gpio on\n   ```\n- **Turn off an LED connected to GPIO pin**:\n   ```text\n  /gpio oFF\n   ```\n\n### File Structure\n\n```bash\nRaspberry_pi_telegram_bot/\n│\n├── handlers\n├── utils\n├── main.py              # Main bot script\n├── config.py           # Sample configuration file\n├── requirements.txt    # Python dependencies\n├── README.md           # This README file\n└── LICENSE             # License file\n```\n\n### Contributing\n\nContributions are welcome! Please fork this repository and submit a pull request with your improvements or bug fixes.\n\n### License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/GraveEaterMadison/Raspberry_pi_telegram_bot/blob/main/LICENSE) file for details.\n\n### Acknowledgements\n\nThis project was inspired by various online resources and tutorials that guide the creation of Raspberry Pi-based Telegram bots.\n\nYou can add custom commands by creating new handlers in the handlers/ directory.\n\nDeveloped with ❤️ by [GraveEaterMadison](https://github.com/GraveEaterMadison)\n```vbnet\n\nYou can copy and paste this content into your `README.md` file under the relevant sections. Let me know if you need further adjustments!\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGraveEaterMadison%2FRaspberry_pi_telegram_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGraveEaterMadison%2FRaspberry_pi_telegram_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGraveEaterMadison%2FRaspberry_pi_telegram_bot/lists"}