{"id":17024485,"url":"https://github.com/aitorres/dogpicsbot","last_synced_at":"2025-03-22T17:31:05.601Z","repository":{"id":46098077,"uuid":"198008691","full_name":"aitorres/dogpicsbot","owner":"aitorres","description":"A simple Telegram bot that sends random dog pictures.","archived":false,"fork":false,"pushed_at":"2024-09-01T17:50:07.000Z","size":584,"stargazers_count":9,"open_issues_count":5,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-15T07:25:39.862Z","etag":null,"topics":["api","bot","dog-pictures","hacktoberfest","telegram","telegram-api","telegram-api-bot","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/aitorres.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2019-07-21T03:43:40.000Z","updated_at":"2024-09-01T17:50:09.000Z","dependencies_parsed_at":"2023-01-20T09:01:35.808Z","dependency_job_id":"13fd224d-976d-477c-a73e-6d5607dbb438","html_url":"https://github.com/aitorres/dogpicsbot","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdogpicsbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdogpicsbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdogpicsbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdogpicsbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aitorres","download_url":"https://codeload.github.com/aitorres/dogpicsbot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244994967,"owners_count":20544251,"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":["api","bot","dog-pictures","hacktoberfest","telegram","telegram-api","telegram-api-bot","telegram-bot"],"created_at":"2024-10-14T07:25:46.059Z","updated_at":"2025-03-22T17:31:05.592Z","avatar_url":"https://github.com/aitorres.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dog Pics Bot\n\nA simple Telegram bot that sends random dog pictures (and more!).\n\nYou can test the bot on Telegram, just click here: [@DogPicsBot](https://t.me/dogpicsbot).\n\nCurrently on [v3.1.1](https://github.com/aitorres/dogpicsbot/releases/tag/v3.1.1). For more information about versions and changes, refer to the [changelog](CHANGELOG.md).\n\n## Requirements\n\nThe bot runs on **Python 3** (officially supporting Python 3.10 to 3.13), and depends on packages listed on the `requirements.txt` file.\n\nFor ease of use, use [`poetry`](https://python-poetry.org/) to install dependencies with the following command:\n\n```bash\npoetry install\n```\n\n## Installation\n\nSimply clone this repository, install the requirements with `poetry` then set a new environment variable named `DPB_TG_TOKEN` with your Telegram bot API token. If you don't have a valid token, [check out this guide](https://core.telegram.org/bots).\n\nYou can also optionally set a new environment variable named `DPB_SAD_MESSAGE_RESPONSE_PROBABILITY` with a float value between 0 and 1, to potentially limit how often the bot will respond with dog pictures to sad messages.\n\nNote that one feature (sending dog pictures freely through group chats on certain trigger words) requires the bot's Privacy Mode to be **disabled** (this can be done through @BotFather).\n\n## Usage\n\nRun the following command on a command line. It will keep the polling thread running (therefore keeping your bot alive) until you kill the process.\n\n```bash\npoetry run python bot.py\n```\n\n## Test\n\nUnit tests for the bot are found in the [tests.py](tests.py) file. You can run them with verbose output after setting up your local environment, including the 80% coverage check that is expected of the repository, with the following command:\n\n```bash\npoetry run pytest\n```\n\n## What's next\n\nThe next features to be developed are:\n\n- Let the dog detect and reply to images that contain dogs in them ([reference](https://towardsdatascience.com/a-dog-detector-and-breed-classifier-4feb99e1f852))\n- Replying \"intelligently\" to messages relating to dogs (e.g. emotions)\n- Explore the use of other dog pics APIs\n- And more!\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nAll contributions that involve changing the codebase should either include or update [tests](tests.py), and make sure that all tests pass before changes can be merged to the `master` branch.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitorres%2Fdogpicsbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faitorres%2Fdogpicsbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitorres%2Fdogpicsbot/lists"}