{"id":18644489,"url":"https://github.com/khivus/today-holiday-tgbot","last_synced_at":"2025-11-05T02:30:27.603Z","repository":{"id":169899003,"uuid":"644607842","full_name":"khivus/today-holiday-tgbot","owner":"khivus","description":"Какой сегодня праздник бот.","archived":false,"fork":false,"pushed_at":"2023-12-08T17:09:04.000Z","size":129,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-12-08T18:26:08.325Z","etag":null,"topics":["aiogram","telegram-bot","tgbot"],"latest_commit_sha":null,"homepage":"https://t.me/Kakoy_Prazdnik_bot","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/khivus.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}},"created_at":"2023-05-23T22:05:17.000Z","updated_at":"2023-12-20T16:33:00.405Z","dependencies_parsed_at":"2023-09-29T22:05:18.547Z","dependency_job_id":"37a2f8b3-fbfa-424e-9fcd-96d58861a88c","html_url":"https://github.com/khivus/today-holiday-tgbot","commit_stats":null,"previous_names":["sosnoviybor/today-holiday-tgbot","khivus/today-holiday-tgbot"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khivus%2Ftoday-holiday-tgbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khivus%2Ftoday-holiday-tgbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khivus%2Ftoday-holiday-tgbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khivus%2Ftoday-holiday-tgbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khivus","download_url":"https://codeload.github.com/khivus/today-holiday-tgbot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239449544,"owners_count":19640532,"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":["aiogram","telegram-bot","tgbot"],"created_at":"2024-11-07T06:12:25.070Z","updated_at":"2025-11-05T02:30:27.557Z","avatar_url":"https://github.com/khivus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram Holiday Bot\r\n\r\nA Telegram bot built using aiogram==3.0.0b7 and other modules listed in the `requirements.txt` file. The bot sends a daily list of today's holidays at specified hours and includes various other cool features.\r\nYou can use last version of bot [there](https://t.me/Kakoy_Prazdnik_bot).\r\n\r\n## Features\r\n\r\n- Daily holiday updates\r\n- List of tomorrow's holidays\r\n- Search holidays by day and month or name\r\n- Personalized settings\r\n- Admin command features \r\n\r\n## Installation\r\n\r\n1. Clone the repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/khivus/today-holiday-tgbot.git\r\n   cd today-holiday-tgbot\r\n   ```\r\n\r\n2. Install dependencies:\r\n\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n3. Set up your Telegram bot token:\r\n\r\n   - Create a new bot on Telegram using [BotFather](https://core.telegram.org/bots#botfather).\r\n   - Copy the generated token.\r\n   - Create a `.env` file in the project root and add your token:\r\n\r\n     ```\r\n     API_TOKEN=your_token_here\r\n     ```\r\n\r\n## Usage\r\n\r\nRun the bot using the following command on Linux:\r\n\r\n```bash\r\nAPI_TOKEN=\u003cyour_token\u003e python3 -m src\r\n```\r\nor using PowerShell:\r\n\r\n```bash\r\n$env:API_TOKEN = \"\u003cyour_token\u003e\"\r\npython -m src\r\n```\r\n\r\n## Configuration\r\n\r\nAdjust the bot settings in the `config.py` file:\r\nMake sure to configure the desired timezone and other settings within the `constants.py` file.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhivus%2Ftoday-holiday-tgbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhivus%2Ftoday-holiday-tgbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhivus%2Ftoday-holiday-tgbot/lists"}