Skip to content
@basalt-rs

Basalt

A suite of applications for hosting and participating in local programming competitions.
README.md

alt text

Basalt is a free and open source suite of programs for creating, hosting, and participating in local programming competitions.

Documentation for usage of Basalt can be found at https://basalt-rs.github.io

Community

We're actively looking for more community members and contributors to the project! Feel free to join the Discord and inquire for more information. We also have GitHub issues in our repositories that anyone is welcome to solve.

Stack

  • Rust
  • React (Next.js) + Tauri
  • Docker

Components

Basalt is comprised of a handful of core pieces:

  • Server
    • basalt-server [Source] [API Documentation] - Server runtime for Basalt competitions
    • leucite [Source] [Crate] [Docs] - Sandboxed environment for running commands
    • erudite [Source] [Docs] - Parallel test runner that uses leucite for sandboxing
  • Client [Source] [Docs]
    • Web Application (NextJS)
    • Desktop Application (Tauri + Web Application)
    • Web Bundler provides an embeddable instance of the Web Application in Rust
  • CLI [Source] [Docs]

To stay organized, we have logically separate repositories and libraries that account for required functionality. Leucite for example is a library we created to easily create sandboxed execution environments.

Popular repositories Loading

  1. leucite leucite Public

    A wrapper crate around rust-landlock that provides useful abstractions and utilities

    Rust 4 2

  2. basalt basalt Public

    Application for managing and competing in programming competitions

    TypeScript 4 3

  3. basalt-server basalt-server Public

    Server runtime for Basalt competitions

    Rust 3

  4. erudite erudite Public

    A library for running sandboxed tests in parallel in any language.

    Rust 1 1

  5. basalt-cli basalt-cli Public

    Cli tool for creating and running the docker containers for hosting a basalt competition

    Rust 1

  6. nix-pi-base nix-pi-base Public

    Base configuration for building a purpose-built OS image based on NixOS

    Nix 1

Repositories

Showing 10 of 14 repositories
  • basalt-server Public

    Server runtime for Basalt competitions

    basalt-rs/basalt-server’s past year of commit activity
    Rust 3 GPL-3.0 0 17 (2 issues need help) 6 Updated Feb 25, 2026
  • basalt Public

    Application for managing and competing in programming competitions

    basalt-rs/basalt’s past year of commit activity
    TypeScript 4 GPL-3.0 3 39 (5 issues need help) 6 Updated Feb 21, 2026
  • bedrock Public

    The fundamental configurations for everything basalt

    basalt-rs/bedrock’s past year of commit activity
    Rust 0 Apache-2.0 0 11 (2 issues need help) 7 Updated Feb 21, 2026
  • leucite Public

    A wrapper crate around rust-landlock that provides useful abstractions and utilities

    basalt-rs/leucite’s past year of commit activity
    Rust 4 2 3 (3 issues need help) 0 Updated Jan 2, 2026
  • erudite Public

    A library for running sandboxed tests in parallel in any language.

    basalt-rs/erudite’s past year of commit activity
    Rust 1 1 1 (1 issue needs help) 0 Updated Dec 19, 2025
  • basalt-cli Public

    Cli tool for creating and running the docker containers for hosting a basalt competition

    basalt-rs/basalt-cli’s past year of commit activity
    Rust 1 0 5 (1 issue needs help) 2 Updated Nov 11, 2025
  • tap Public

    Official Basalt Homebrew Tap

    basalt-rs/tap’s past year of commit activity
    0 0 0 0 Updated Nov 7, 2025
  • examples Public

    Basalt example configurations with containerized builds

    basalt-rs/examples’s past year of commit activity
    0 0 0 0 Updated Sep 28, 2025
  • basalt-nix Public

    Nix-based, immutable deployment target for Basalt primarily targetting the Raspberry Pi platform

    basalt-rs/basalt-nix’s past year of commit activity
    Nix 0 0 0 0 Updated Sep 21, 2025
  • nix-pi-base Public

    Base configuration for building a purpose-built OS image based on NixOS

    basalt-rs/nix-pi-base’s past year of commit activity
    Nix 1 0 0 0 Updated Sep 21, 2025
View all repositories