{"id":21477552,"url":"https://github.com/5ht2/taro-bot","last_synced_at":"2025-07-15T10:33:35.249Z","repository":{"id":37387423,"uuid":"412236549","full_name":"5HT2/taro-bot","owner":"5HT2","description":"A fast, scalable and easily expandable Discord bot","archived":false,"fork":false,"pushed_at":"2024-06-13T15:34:04.000Z","size":808,"stargazers_count":11,"open_issues_count":19,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-19T18:12:16.621Z","etag":null,"topics":["arikawa","discord","discord-bot","go","golang"],"latest_commit_sha":null,"homepage":"https://frogg.ie/invite-taro-bot","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/5HT2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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":{"custom":["https://payy.lv"]}},"created_at":"2021-09-30T21:41:00.000Z","updated_at":"2024-06-13T15:34:08.000Z","dependencies_parsed_at":"2023-02-05T15:10:10.776Z","dependency_job_id":"f965884b-efa4-44da-97c3-7f8badae84d2","html_url":"https://github.com/5HT2/taro-bot","commit_stats":{"total_commits":618,"total_committers":6,"mean_commits":103.0,"dds":"0.27022653721682843","last_synced_commit":"a5e4d151b360286442598a507ab342108e47e78e"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5HT2%2Ftaro-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5HT2%2Ftaro-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5HT2%2Ftaro-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5HT2%2Ftaro-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/5HT2","download_url":"https://codeload.github.com/5HT2/taro-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226033243,"owners_count":17563126,"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":["arikawa","discord","discord-bot","go","golang"],"created_at":"2024-11-23T11:14:15.238Z","updated_at":"2024-11-23T11:14:15.734Z","avatar_url":"https://github.com/5HT2.png","language":"Go","funding_links":["https://payy.lv"],"categories":[],"sub_categories":[],"readme":"# taro-bot\n\n[![](https://img.shields.io/badge/discord%20bot-invite!-5865F2?logo=discord\u0026logoColor=white)](https://discord.com/oauth2/authorize?client_id=893216230410952785\u0026permissions=278404582464\u0026scope=bot)\n[![CodeFactor](https://img.shields.io/codefactor/grade/github/5HT2/taro-bot?logo=codefactor\u0026logoColor=white)](https://www.codefactor.io/repository/github/5HT2/taro-bot)\n[![CodeQL](https://github.com/5HT2/taro-bot/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/5HT2/taro-bot/actions/workflows/codeql-analysis.yml)\n[![docker-build](https://github.com/5HT2/taro-bot/actions/workflows/docker-build.yml/badge.svg)](https://github.com/5HT2/taro-bot/actions/workflows/docker-build.yml)\n\nA Discord bot built in Go and Arikawa.\n\n**Notable features:**\n- Strict arg parsing and selection\n- Automatic error handling via friendly messages given to the user :)\n- Asynchronous event handling with concurrency-safe configs\n- Fully-fledged plugin support\n\n**A feature (plugin) is able to:**\n- Return comprehensive commands, with [info support such as aliases and descriptions](https://github.com/5HT2/taro-bot/blob/99b929ac18d583a38a332405b45dd53d57143b17/plugins/base/base.go#L19).\n- Return \"auto responses\", with [flexible message matching to call Go code](https://github.com/5HT2/taro-bot/blob/99b929ac18d583a38a332405b45dd53d57143b17/plugins/tenor-delete/tenor-delete.go#L28).\n- Return scheduled jobs, to be [called at an interval](https://github.com/5HT2/taro-bot/blob/99b929ac18d583a38a332405b45dd53d57143b17/plugins/vintagestory/vintagestory.go#L30).\n- Register event handlers to Discord's gateway, such as [when a reaction is added to a message](https://github.com/5HT2/taro-bot/blob/99b929ac18d583a38a332405b45dd53d57143b17/plugins/starboard/starboard.go#L123).\n\n**All bot features are plugins**, and can be enabled or disabled on demand, with hot-reloading being added soon ([#8](https://github.com/5HT2/taro-bot/issues/8)).\n\nMore information about using and creating plugins is described in the [plugin documentation](https://github.com/5HT2/taro-bot/blob/master/plugins).\n\n## Usage\n\n```\ngit clone git@github.com:5HT2/taro-bot.git \u0026\u0026 cd taro-bot\nmake\n./taro\n```\n\nYou can also do `./update.sh` to run or update the Docker image, provided you have Docker installed.\n\n#### Config\n\nThis is the simplest example of the `config/config.json` file, you only need `bot_token` to be set.\n\n```json\n{\n    \"bot_token\": \"bot token goes here\"\n}\n```\n\nYou can also create a `config/plugins.json`, to select which plugins will be loaded.\nThis is optional, and a default (curated) will load if you do not set it, or if you add `\"default\"` to the list.\n\n```json\n{\n    \"loaded_plugins\": [\"example\", \"leave-join-msg\"]\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5ht2%2Ftaro-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F5ht2%2Ftaro-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5ht2%2Ftaro-bot/lists"}