Important
Migration complete and services back online. Database contains incomplete entries until refactor is finished.
- Jan 1 '26
Project requires Node.js and pnpm to run. After installing Node, it is recommended to use NVM (installation guide) to manage Node versions. To set the Node version used by the project, run nvm use from root and follow the prompts, especially if that version has not been installed yet.
No other system level dependencies are needed.
This project uses dotenv to manage environment-specific settings. Rename the .env.example file in the bot directory to .env and enter in the necessary values listed inside the file. If you do not have a token yet, check out this guide.
Warning
Keep the Discord token to yourself at all costs.
When STATIC_BUCKET is configured, the bot loads PowerCord Data autocomplete
blobs from S3 into memory and answers Discord autocomplete locally. If the cache
is not ready or a refresh fails before any cache is loaded, the bot falls back to
the public HTTP autocomplete API configured by API_BASE_URL.
The bot exposes GET /live for process liveness and GET /health for readiness.
Readiness returns 200 only while the Discord client is connected and ready;
otherwise it returns 503. Better Stack heartbeats follow the same readiness
signal so startup or gateway failures are not reported as healthy.
In the root directory of the project enter the following commands. This will install all dependencies and begin the dev instance.
pnpm install
pnpm devTo run the Discord bot or web client individually, run from the root:
pnpm dev:bot
pnpm dev:web