https://github.com/tibynx/orion
✨ Discord bot for moderation, utilities, and user engagement.
https://github.com/tibynx/orion
administration bot discord discord-bot discord-py moderation python utility webhook
Last synced: about 2 months ago
JSON representation
✨ Discord bot for moderation, utilities, and user engagement.
- Host: GitHub
- URL: https://github.com/tibynx/orion
- Owner: tibynx
- License: mit
- Created: 2025-11-03T08:46:02.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2026-05-16T11:30:33.000Z (about 2 months ago)
- Last Synced: 2026-05-16T13:36:49.739Z (about 2 months ago)
- Topics: administration, bot, discord, discord-bot, discord-py, moderation, python, utility, webhook
- Language: Python
- Homepage:
- Size: 163 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ✨ Orion
Orion is a Discord server management and utility bot that provides various administrative and convenience features for Discord server owners and moderators.
## Features
* Message and thread management
* Manage webhooks
* Send messages as the bot or using a webhook
* Play audio files in voice channels
* Customize bot presence and activity
* Restrict commands using Discord's permission system
## Setup
### Prerequisites
1. Create an application on the [Discord Developer Portal](https://discord.com/developers/applications)
- Click "New Application" and give it a name.
- Note down the Application ID for later.
- Go to the "Bot" tab and click "Add Bot".
- Under "TOKEN", click "Copy" to copy your bot token. (You might need to reset it to see it.)
> [!NOTE]
> This bot intended to be used in only one server at a time. If you want to use it in multiple servers, you will need to create another bot with different bot tokens.
2. Enable developer mode in Discord to copy IDs
- Go to User Settings > Advanced > Developer Mode and enable it.
- You can now right-click on users, roles, channels, etc., and select "Copy ID" to get their IDs.
3. Invite the bot to a Discord server
- You can use the premade link in the usage section.
Now choose one of the following methods to run the bot!
### Docker
1. Pull the latest image from Docker Hub
```sh
docker pull tibynx/orion:latest
```
2. Run the container with the required environment variables and volume mounts
- See the configuration section below for details! Only required options are included in this example.
- Change `/path/to/logs` to a directory on your host where you want to store the logs.
```sh
docker run -d \
--name=orion \
-e BOT_TOKEN=your_bot_token_here \
-v /path/to/logs:/app/logs \
tibynx/orion:latest
```
### Source
1. Clone the repository and install all dependencies. Make sure you have at least Python 3.14 installed!
```sh
git clone https://github.com/tibynx/orion.git
cd orion/
pip install -r requirements.txt
```
2. Copy `.env.example` to `.env` and configure your settings.
- See the configuration section below for details!
- Do not share your `.env` file publicly!
3. Invite the bot to a Discord server
- You can use the premade link in the usage section.
4. Run `python main.py` to start the bot.
### Configuration
| Variable | Description |
|:-------------:|------------------------------------------------------------|
| BOT_TOKEN | Your bot token. Do not share this with anyone! |
| SUCCESS_EMOJI | (Optional) The emoji the bot will use to indicate success. |
| ERROR_EMOJI | (Optional) The emoji the bot will use in indicate issues. |
## Usage
After setting up, invite your bot to a server using this premade link! It already contains the proper permissions. Replace `` with your bot's appication ID.
```sh
https://discord.com/oauth2/authorize?client_id=&permissions=120796048384&integration_type=0&scope=bot+applications.commands
```
> [!TIP]
> You can restrict commands to specific roles/users and channels using Discord's Integrations menu inside the Server Settings.
### Mentioning Users and Roles
Due to Discord limitations, you cannot directly mention users or roles in the bot's response. However, you can use their IDs to create mentions. You'll need to enable Developer Mode in Discord to copy user and role IDs. To enable Developer Mode, go to User Settings > Advanced > Developer Mode.
If you want to mention `@everyone` or `@here`, simply write them in your message. But if you want to mention roles or specific users, you need to use their IDs in the following format: `<@&ROLE_ID>` for roles and `<@USER_ID>` for users.
### Pinging mentions
For convenience, you can choose to ping the mentions by ticking the options in the message modal. The bot will not mention `@everyone` or `@here` by default.
### Using emojis
Emojis can be either a Unicode emoji (e.g., ✨) or a custom emoji in the format `` (e.g., ``). The bot must be in the server where the custom emoji is from or added to the bot on the Discord Developer Portal to use it.
### Formatting code blocks and text
Just like normal messages, you can format your text using Markdown syntax. You can make text **bold**, *italic*, ~~strikethrough~~, etc. The bot message will be formatted accordingly, but there is no preview.