Byte Heist is a site where you can test your coding skills by solving challenges in as few bytes as possible.
The site will be similar to sites like code.golf, anarchy golf, and the late week.golf. Some unique features will include:
- Challenges will have a finite run time, probably around 6 months. After this time all solutions will be made public.
- A highly customizable judging system that will allow things like restricted source challenges, alternate scoring systems, self referential challenges etc. Though I also hope to have a good selection of basic code golf challenges too.
- Easily upload and collaborate on challenges via the interface. Built in ways to vote on challenges, give feedback, suggest test cases etc.
- There will be curated challenges that contribute to a global leaderboard, but you can also create private challenges to play with your friends, or to use for C.M.C.s etc.
Byte Heist conists of two main projects
- The lang runner provides an isolated environment for langugaes, it runs inside docker/podman
- The main server provides the frontend. It should be able to run directly inside Linux or WSL.
- Windows might work, but is untested
docker compose upmake restart-runnerFirst create a .env.local file with the following contents:
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
# The discord integration is optional, it should work fine without these vars set
DISCORD_WEBHOOK_URL=
DISCORD_TOKEN=
DISCORD_CHANNEL_ID=
Then create the datbase structure: (The database runs via the docker compose)
# Setup the development database
cargo install sqlx-cli --no-default-features --features rustls,postgres
sqlx migrate runFirst, update the typescript definitions: (Optional, but allows the challenge editor to work)
npm install # install typescript compiler
make ts-build-runnerThis creates typescript definition files used for the challenge ditor.
Now run Vite to build the JS:
npx viteThis should just run in the background as long as you are working on the main server.
Finally, you can start the main server:
cargo run --bin main-server
Ensure the postgres is running since it checks the schema at compile time.
Now you should be able to visit Byte Heist at http://localhost:3001