{"id":15042215,"url":"https://github.com/kkrypt0nn/python-discord-bot-template","last_synced_at":"2026-01-23T18:03:22.247Z","repository":{"id":35337563,"uuid":"172687216","full_name":"kkrypt0nn/Python-Discord-Bot-Template","owner":"kkrypt0nn","description":"🐍 A simple template to start to code your own and personalized Discord bot in Python","archived":false,"fork":false,"pushed_at":"2025-09-12T17:40:54.000Z","size":224,"stargazers_count":1013,"open_issues_count":0,"forks_count":349,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-09-12T19:57:30.841Z","etag":null,"topics":["discord","discord-automation","discord-bot","discord-bot-template","discord-py","discord-server","discord-slash-commands","discordapp","discordbot","hacktoberfest","krypton","python","python-bot","python-discord-bot","python-discord-bot-template","slash-commands","user-discord"],"latest_commit_sha":null,"homepage":"https://krypton.ninja","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kkrypt0nn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":["kkrypt0nn"],"patreon":null,"open_collective":null,"ko_fi":"kkrypt0nn","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://buymeacoffee.com/kkrypt0nn"]}},"created_at":"2019-02-26T10:12:10.000Z","updated_at":"2025-09-12T17:39:57.000Z","dependencies_parsed_at":"2024-07-14T11:41:05.154Z","dependency_job_id":"7df69e0b-1ae9-46f0-9732-9383c4d9254a","html_url":"https://github.com/kkrypt0nn/Python-Discord-Bot-Template","commit_stats":null,"previous_names":[],"tags_count":38,"template":true,"template_full_name":null,"purl":"pkg:github/kkrypt0nn/Python-Discord-Bot-Template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkrypt0nn%2FPython-Discord-Bot-Template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkrypt0nn%2FPython-Discord-Bot-Template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkrypt0nn%2FPython-Discord-Bot-Template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkrypt0nn%2FPython-Discord-Bot-Template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kkrypt0nn","download_url":"https://codeload.github.com/kkrypt0nn/Python-Discord-Bot-Template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkrypt0nn%2FPython-Discord-Bot-Template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28697425,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"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":["discord","discord-automation","discord-bot","discord-bot-template","discord-py","discord-server","discord-slash-commands","discordapp","discordbot","hacktoberfest","krypton","python","python-bot","python-discord-bot","python-discord-bot-template","slash-commands","user-discord"],"created_at":"2024-09-24T20:46:59.926Z","updated_at":"2026-01-23T18:03:22.241Z","avatar_url":"https://github.com/kkrypt0nn.png","language":"Python","readme":"# Python Discord Bot Template\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/xj6y5ZaTMr\"\u003e\u003cimg src=\"https://img.shields.io/discord/1358456011316396295?logo=discord\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/kkrypt0nn/Python-Discord-Bot-Template/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/kkrypt0nn/Python-Discord-Bot-Template\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/kkrypt0nn/Python-Discord-Bot-Template/commits/main\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/kkrypt0nn/Python-Discord-Bot-Template\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/kkrypt0nn/Python-Discord-Bot-Template/blob/main/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/github/license/kkrypt0nn/Python-Discord-Bot-Template\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/kkrypt0nn/Python-Discord-Bot-Template\"\u003e\u003cimg src=\"https://img.shields.io/github/languages/code-size/kkrypt0nn/Python-Discord-Bot-Template\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://conventionalcommits.org/en/v1.0.0/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits\u0026logoColor=white\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e [!NOTE]\n\u003e This project is in a **feature-freeze mode**, please read more about it [here](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues/112). It can be summed up in a few bullet points:\n\u003e \n\u003e * The project **will** receive bug fixes\n\u003e * The project **will** be updated to make sure it works with the **latest** discord.py version\n\u003e * The project **will not** receive any new features, **unless one of the following applies**:\n\u003e   * A new feature is added to Discord and it would be beneficial to have it in the template\n\u003e   * A feature got a breaking change, this fits with the same point that the project will **always** support the latest discord.py version\n\nThis repository is a template that everyone can use for the start of their Discord bot.\n\nWhen I first started creating my Discord bot it took me a while to get everything setup and working with cogs and more.\nI would've been happy if there were any template existing. However, there wasn't any existing template. That's why I\ndecided to create my own template to let **you** guys create your Discord bot easily.\n\nPlease note that this template is not supposed to be the best template, but a good template to start learning how\ndiscord.py works and to make your own bot easily.\n\nIf you plan to use this template to make your own template or bot, you **have to**:\n\n- Keep the credits, and a link to this repository in all the files that contains my code\n- Keep the same license for unchanged code\n\nSee [the license file](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/blob/master/LICENSE.md) for more\ninformation, I reserve the right to take down any repository that does not meet these requirements.\n\n## Support\n\nBefore requesting support, you should know that this template requires you to have at least a **basic knowledge** of\nPython and the library is made for **advanced users**. Do not use this template if you don't know the\nbasics or some advanced topics such as OOP or async. [Here's](https://pythondiscord.com/pages/resources) a link for resources to learn python.\n\nIf you need some help for something, do not hesitate to create an issue over [here](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues), but don't forget the read the [frequently asked questions](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/wiki/Frequently-Asked-Questions) before.\n\nAll the updates of the template are available [here](UPDATES.md).\n\n## Disclaimer\n\nSlash commands can take some time to get registered globally, so if you want to test a command you should use\nthe `@app_commands.guilds()` decorator so that it gets registered instantly. Example:\n\n```py\n@commands.hybrid_command(\n  name=\"command\",\n  description=\"Command description\",\n)\n@app_commands.guilds(discord.Object(id=GUILD_ID)) # Place your guild ID here\n```\n\nWhen using the template you confirm that you have read the [license](LICENSE.md) and comprehend that I can take down\nyour repository if you do not meet these requirements.\n\n## How to download it\n\nThis repository is now a template, on the top left you can simply click on \"**Use this template**\" to create a GitHub\nrepository based on this template.\n\nAlternatively you can do the following:\n\n- Clone/Download the repository\n  - To clone it and get the updates you can definitely use the command\n    `git clone`\n- Create a Discord bot [here](https://discord.com/developers/applications)\n- Get your bot token\n- Invite your bot on servers using the following invite:\n  https://discord.com/oauth2/authorize?\u0026client_id=YOUR_APPLICATION_ID_HERE\u0026scope=bot+applications.commands\u0026permissions=PERMISSIONS (\n  Replace `YOUR_APPLICATION_ID_HERE` with the application ID and replace `PERMISSIONS` with the required permissions\n  your bot needs that it can be get at the bottom of a this\n  page https://discord.com/developers/applications/YOUR_APPLICATION_ID_HERE/bot)\n\n## How to set up\n\nTo set up the token you will have to make use of the [`.env.example`](.env.example) file; you should rename it to `.env` and replace the `YOUR_BOT...` content with your actual values that match for your bot.\n\nAlternatively you can simply create a system environment variable with the same names and their respective value.\n\n## How to start\n\n### The _\"usual\"_ way\n\nTo start the bot you simply need to launch, either your terminal (Linux, Mac \u0026 Windows), or your Command Prompt (\nWindows)\n.\n\nBefore running the bot you will need to install all the requirements with this command:\n\n```\npython -m pip install -r requirements.txt\n```\n\nAfter that you can start it with\n\n```\npython bot.py\n```\n\n\u003e **Note**: You may need to replace `python` with `py`, `python3`, `python3.11`, etc. depending on what Python versions you have installed on the machine.\n\n### Docker\n\nSupport to start the bot in a Docker container has been added. After having [Docker](https://docker.com) installed on your machine, you can simply execute:\n\n```\ndocker compose up -d --build\n```\n\n\u003e **Note**: `-d` will make the container run in detached mode, so in the background.\n\n## Issues or Questions\n\nIf you have any issues or questions of how to code a specific command, you can:\n\n- Join my Discord server [here](https://discord.gg/xj6y5ZaTMr)\n- Post them [here](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues)\n\nMe or other people will take their time to answer and help you.\n\n## Versioning\n\nWe use [SemVer](http://semver.org) for versioning. For the versions available, see\nthe [tags on this repository](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/tags).\n\n## Built With\n\n- [Python 3.12.9](https://www.python.org/)\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE.md](LICENSE.md) file for details\n","funding_links":["https://github.com/sponsors/kkrypt0nn","https://ko-fi.com/kkrypt0nn","https://buymeacoffee.com/kkrypt0nn"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkrypt0nn%2Fpython-discord-bot-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkkrypt0nn%2Fpython-discord-bot-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkrypt0nn%2Fpython-discord-bot-template/lists"}