{"id":28932173,"url":"https://github.com/kytta/raspi_tgbot","last_synced_at":"2026-04-24T12:05:22.856Z","repository":{"id":97424983,"uuid":"316801266","full_name":"kytta/raspi_tgbot","owner":"kytta","description":"Utilitary Telegram Bot for Raspberry Pi","archived":false,"fork":false,"pushed_at":"2024-08-24T21:11:52.000Z","size":121,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-24T22:24:25.546Z","etag":null,"topics":["raspberry-pi","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":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kytta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"NickKaramoff","liberapay":"NickKaramoff","custom":"paypal.me/NickKaramoff"}},"created_at":"2020-11-28T18:52:39.000Z","updated_at":"2024-08-24T22:24:28.902Z","dependencies_parsed_at":"2023-03-13T16:13:59.319Z","dependency_job_id":null,"html_url":"https://github.com/kytta/raspi_tgbot","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/kytta/raspi_tgbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kytta%2Fraspi_tgbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kytta%2Fraspi_tgbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kytta%2Fraspi_tgbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kytta%2Fraspi_tgbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kytta","download_url":"https://codeload.github.com/kytta/raspi_tgbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kytta%2Fraspi_tgbot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261320613,"owners_count":23140943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["raspberry-pi","telegram-bot"],"created_at":"2025-06-22T16:09:13.132Z","updated_at":"2026-04-24T12:05:22.851Z","avatar_url":"https://github.com/kytta.png","language":"Python","funding_links":["https://github.com/sponsors/NickKaramoff","https://liberapay.com/NickKaramoff","paypal.me/NickKaramoff"],"categories":[],"sub_categories":[],"readme":"# raspi_tgbot\n\n[![Latest release](https://badgen.net/github/release/NickKaramoff/raspi_tgbot/stable)][latest-release]\n![Python 3.6-3.9 required](https://badgen.net/badge/python/3.6%20|%203.7%20|%203.8%20|%203.9/3776AB)\n\nUtilitary Telegram Bot for Raspberry Pi\n\nThis bot can\n\n- display it's global IP address (`/ip`)\n\n## Prerequisities\n\n- Python 3.6 or newer\n  - make sure your `python3` executable points to the correct version  \n    Tip: use [pyenv][pyenv] to simplify Python version management\n- [Poetry][poetry] (strongly recommended, but not required)\n\n## Install\n\n1. Clone the repository and enter the downloaded folder\n\n   ```sh\n   # you can also download the archive from github manually\n   git clone https://github.com/NickKaramoff/raspi_tgbot.git\n   cd raspi_tgbot\n   ```\n\n2. Create poetry env and install the dependencies\n\n   ```sh\n   poetry env use python3\n   poetry install --no-dev\n   ```\n\n   - if you're not using Poetry:\n\n     ```sh\n     pip install -r requirements.txt\n     ```\n     \n3. Create the `.env` file with the following settings\n\n   ```dotenv\n   BOT_TOKEN=??? # replace with your bot token\n   ALLOWED_IDS=1234567,87654321 # comma-separated list of user ids\n   ```\n\n   - you get the bot token when you create a bot with [BotFather][botfather]\n   - you can get user IDs of user by forwarding their messages to [GetIDs Bot][getidsbot]\n\n3. _(optional)_ Create a systemd service file in\n   `/etc/systemd/system/raspi_tgbot.service` with the following content:\n\n   ```ini\n   [Unit]\n   Description=Start raspi_tgbot\n\n   [Service]\n   Type=simple\n   WorkingDirectory=/path/to/raspi_tgbot\n   User=your_user_name\n   ExecStart=/path/to/poetry run raspi-bot\n   Restart=on-failure\n\n   [Install]\n   WantedBy=multi-user.target\n   ```\n\n   Then enable and run the service:\n\n   ```sh\n   sudo systemctl enable raspi_tgbot\n   sudo systemctl start raspi_tgbot\n   ```\n\n[botfather]: https://t.me/BotFather\n[getidsbot]: https://t.me/getidsbot\n[latest-release]: https://github.com/NickKaramoff/raspi_tgbot/releases/latest\n[poetry]: https://python-poetry.org/\n[pyenv]: https://github.com/pyenv/pyenv\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkytta%2Fraspi_tgbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkytta%2Fraspi_tgbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkytta%2Fraspi_tgbot/lists"}