| .github | ||
| src | ||
| .env.example | ||
| .gitignore | ||
| bun.lock | ||
| CLAUDE.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| eslint.config.js | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
|
|
KernixDiscord Bot for Nerds. |
The purpose of this bot
I created this bot for tech-focused Discord servers. It includes the standard moderation commands you'd expect, along with fun and useful utilities aimed at developers and enthusiasts.
Roadmap
- Add RSS feed tracking
- Add optional AI command
- Improve moderation system
- Add warn system
- Add action logging to user-configured channel
- Add message delete/edit logging
- Add customizable welcome messages
- Add webpage with OAuth for users to change configuration, and other features
Running
Linux
Docker
You will need the following:
Download the Docker Compose file:
curl -L -O https://github.com/LittleT6109/Kernix/releases/latest/download/docker-compose.yml
or
wget -O https://github.com/LittleT6109/Kernix/releases/latest/download/docker-compose.yml
Create .env using .env.example as a template, then add your bot credentials.
Start the Docker container:
docker compose up -d
Edit kernix/config.toml to match your needs, then restart the bot.
docker compose down
docker compose up -d
Bun
You will need the following:
- Bun
- Git
- NodeJS
Clone the repository:
git clone https://github.com/LittleT6109/Kernix
cd Kernix
Install dependencies:
bun i
Build the bot:
bun run build
Create .env using .env.example as a template, then add your bot credentials.
Run the bot:
bun run start
Edit dist/data/config.toml to match your needs, then restart the bot.
Windows
Docker Compose CLI is only available on Linux, so you must use the Bun method here.
You will need the following:
- Bun
- Git
- NodeJS
Clone the repository:
git clone https://github.com/LittleT6109/Kernix
cd Kernix
Install dependencies:
bun i
Build the bot:
bun run build
Create .env using .env.example as a template, then add your bot credentials.
Run the bot:
bun run start
Edit dist/data/config.toml to match your needs, then restart the bot.
Getting Bot Credentials
- Go to https://discord.com/developers/applications
- Create a new application
- Copy the Application ID into
.env.local - Open the Bot tab and reset the token, copy it
- Add the token to
.env.local