A Discord bot that renders Typst code.
Built with poise so it has all the goodies like edit tracking, typing status, and automatic help generation.
The bot uses two binaries:
bot: connects to Discord and processes messagesworker: receives requests, interacts with Typst, responds
bot will automatically spawn worker, so you only need to run bot.
To set up the working environment, create a directory with the following items:
fonts: Copied from the repo.Make sure you have Git LFS set up so the fonts are downloaded properly.The fonts no longer use LFS due to GitHub's new transfer limits.worker: The worker binary, copied/hardlinked from the target directory after building.bot: The bot binary, copied/hardlinked from the target directory after building. (This doesn't need to be in this directory, but having everything in one place simplifies things.)db.sqlite: You can justtouchthis, but the bot needs to be able to write to it.
To run, CD into this directory, set DISCORD_TOKEN to your bot token, set CACHE_DIRECTORY and DB_PATH to suitable locations, and run the bot binary (not the worker binary that's also in the directory).
There is a Dockerfile and docker-compose.yml for running the bot inside a Docker container.
To set up the bot with Docker, create a .env file like the following:
DISCORD_TOKEN=YourBotTokenHere
and start the container with docker compose up -d.
Here is a link you can use to invite a public instance run by @frozolotl: https://discord.com/oauth2/authorize?client_id=1183804211264225301&permissions=3072&scope=bot
AGPL. Use ?source to get a link to the source from deployments of the bot.