{"id":29771572,"url":"https://github.com/lizardbyte/support-bot","last_synced_at":"2026-02-14T21:16:44.630Z","repository":{"id":38175333,"uuid":"371464507","full_name":"LizardByte/support-bot","owner":"LizardByte","description":"Discord bot to help manage the LizardByte discord server.","archived":false,"fork":false,"pushed_at":"2025-08-14T12:46:53.000Z","size":545,"stargazers_count":4,"open_issues_count":4,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-14T14:19:19.974Z","etag":null,"topics":["bot","discord","discord-bot","docker","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LizardByte.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},"funding":{"github":["LizardByte"],"patreon":"LizardByte","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/ReenigneArcher"]}},"created_at":"2021-05-27T18:13:25.000Z","updated_at":"2025-08-14T12:20:18.000Z","dependencies_parsed_at":"2023-02-17T00:16:08.699Z","dependency_job_id":"ed87d888-3a28-440f-a4ea-ff15bf85a8af","html_url":"https://github.com/LizardByte/support-bot","commit_stats":null,"previous_names":[],"tags_count":86,"template":false,"template_full_name":null,"purl":"pkg:github/LizardByte/support-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LizardByte%2Fsupport-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LizardByte%2Fsupport-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LizardByte%2Fsupport-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LizardByte%2Fsupport-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LizardByte","download_url":"https://codeload.github.com/LizardByte/support-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LizardByte%2Fsupport-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270482414,"owners_count":24591347,"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","status":"online","status_checked_at":"2025-08-14T02:00:10.309Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","discord","discord-bot","docker","python"],"created_at":"2025-07-27T06:40:35.215Z","updated_at":"2026-01-02T17:15:55.308Z","avatar_url":"https://github.com/LizardByte.png","language":"Python","readme":"# support-bot\n[![GitHub Workflow Status (CI)](https://img.shields.io/github/actions/workflow/status/lizardbyte/support-bot/ci.yml.svg?branch=master\u0026label=CI%20build\u0026logo=github\u0026style=for-the-badge)](https://github.com/LizardByte/support-bot/actions/workflows/ci.yml?query=branch%3Amaster)\n[![Codecov](https://img.shields.io/codecov/c/gh/LizardByte/support-bot.svg?token=900Q93P1DE\u0026style=for-the-badge\u0026logo=codecov\u0026label=codecov)](https://app.codecov.io/gh/LizardByte/support-bot)\n\nSupport bot written in python to help manage LizardByte communities. The current focus is Discord and Reddit, but other\nplatforms such as GitHub discussions/issues might be added in the future.\n\n\n## Overview\n\n### Discord Slash Commands\n\n| command  | description                                              |\n|----------|----------------------------------------------------------|\n| /help    | Return help message, for a list of all possible commands |\n\n\n## Instructions\n\n### Discord\n\n* Setup an application at [discord developer portal](https://discord.com/developers/applications).\n* On `Bot` page enabled these:\n  * Presence Intent\n  * Server Members Intent\n  * Copy the `Token`\n\n### Reddit\n\n* Set up an application at [reddit apps](https://www.reddit.com/prefs/apps/).\n  * The redirect uri should be https://localhost:8080\n  * Take note of the `client_id` and `client_secret`\n \n### Environment Variables\n\n* Add the following as environment variables or in a `.env` file (use `sample.env` as an example).  \n  :exclamation: if using Docker these can be arguments.  \n  :warning: Never publicly expose your tokens, secrets, or ids.  \n\n| variable                         | required | default                                              | description                                                                                |\n|----------------------------------|----------|------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| DATA_REPO                        | False    | `https://github.com/LizardByte/support-bot-data`     | Repository to store persistent data. This repository should be private!                    |\n| DATA_REPO_BRANCH                 | False    | `master`                                             | Branch to store persistent data.                                                           |\n| DISCORD_BOT_TOKEN                | True     | `None`                                               | Token from Bot page on discord developer portal.                                           |\n| DISCORD_CLIENT_ID                | True     | `None`                                               | Discord OAuth2 client id.                                                                  |\n| DISCORD_CLIENT_SECRET            | True     | `None`                                               | Discord OAuth2 client secret.                                                              |\n| DISCORD_GITHUB_STATUS_CHANNEL_ID | True     | `None`                                               | Channel ID to send GitHub status updates to.                                               |\n| DISCORD_REDDIT_CHANNEL_ID        | True     | `None`                                               | Channel ID to send Reddit post updates to.                                                 |\n| DISCORD_REDIRECT_URI             | False    | `https://localhost:8080/discord/callback`            | The redirect uri for OAuth2. Must be publicly accessible.                                  |\n| DISCORD_SPONSORS_CHANNEL_ID      | True     | `None`                                               | Channel ID to send sponsorship updates to.                                                 |\n| GIT_USER_EMAIL                   | True     | `None`                                               | Email address for git commits.                                                             |\n| GIT_USER_NAME                    | True     | `None`                                               | Username for git commits.                                                                  |\n| GIT_TOKEN                        | True     | `None`                                               | GitHub personal access token. Must have `repo` write access. Falls back to `GITHUB_TOKEN`. |\n| GITHUB_CLIENT_ID                 | True     | `None`                                               | GitHub OAuth2 client id.                                                                   |\n| GITHUB_CLIENT_SECRET             | True     | `None`                                               | GitHub OAuth2 client secret.                                                               |\n| GITHUB_REDIRECT_URI              | False    | `https://localhost:8080/github/callback`             | The redirect uri for OAuth2. Must be publicly accessible.                                  |\n| GITHUB_TOKEN                     | True     | `None`                                               | GitHub personal access token. Must have `read:org`                                         |\n| GITHUB_WEBHOOK_SECRET_KEY        | True     | `None`                                               | A secret value to ensure webhooks are from trusted sources.                                |\n| GRAVATAR_EMAIL                   | False    | `None`                                               | Gravatar email address for bot avatar.                                                     |\n| PRAW_CLIENT_ID                   | True     | `None`                                               | `client_id` from reddit app setup page.                                                    |\n| PRAW_CLIENT_SECRET               | True     | `None`                                               | `client_secret` from reddit app setup page.                                                |\n| PRAW_SUBREDDIT                   | True     | `None`                                               | Subreddit to monitor (reddit user should be moderator of the subreddit)                    |\n| REDDIT_USERNAME                  | True     | `None`                                               | Reddit username                                                                            |\n| REDDIT_PASSWORD                  | True     | `None`                                               | Reddit password                                                                            |\n| SUPPORT_COMMANDS_REPO            | False    | `https://github.com/LizardByte/support-bot-commands` | Repository for support commands.                                                           |\n| SUPPORT_COMMANDS_BRANCH          | False    | `master`                                             | Branch for support commands.                                                               |\n\n### Start\n\n```bash\npython -m src\n```\n\n* Invite bot to server:\n  * `https://discord.com/api/oauth2/authorize?client_id=\u003cthe client id of the bot\u003e\u0026permissions=8\u0026scope=bot%20applications.commands`\n","funding_links":["https://github.com/sponsors/LizardByte","https://patreon.com/LizardByte","https://paypal.me/ReenigneArcher"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flizardbyte%2Fsupport-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flizardbyte%2Fsupport-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flizardbyte%2Fsupport-bot/lists"}