README.md

June 24, 2026 · View on GitHub

Spice Logo

Spice Programming Language

Compiler and standard library for the Spice programming language.

Latest release Docker pulls CI status CodeQL status ASAN status License Discord server

This is the home repo of the Spice programming language. Spice is a compiled language which sets a focus on performance and practicality. It is considered as a systems language, which means it is especially useful to write cli tools or device drivers. Spice supports cross-compilation to all target platforms, listed below.

If you like Spice, please consider a GitHub star! ⭐

:warning:The compiler of the Spice language is still in alpha stages and under development. Please note that code may behave differently in the future or even break due to the volatility of the compiler.

Documentation

Please visit the documentation at spicelang.com.
We also have a Spice playground where you can try things: spice.compiler-explorer.com
Code coverage can be found at coverage.spicelang.com.

Supported host systems & file downloads

There are downloadable packages available for all supported platforms:

Platformamd64arm64
Alpine (apk)downloaddownload
CentOS (rpm)downloaddownload
Debian (deb)downloaddownload
Fedora (rpm)downloaddownload
Raspbian (deb)downloaddownload
Ubuntu (deb)downloaddownload
Windows Installer (msi)download-
Windows Portable (zip)download-
MacOS / Darwin (tar.gz)downloaddownload

Setup guide for contributors

Clone the project

git clone https://github.com/spicelang/spice.git
cd spice

Setup dev environment

There is a batch/shell script called dev-setup to help you with that. It will do the following things:

  • Make sure you have all dependencies
  • Clone and build the required LLVM version with the required settings to the llvm subdirectory
  • Download all required third-party libs to the lib subdirectory
  • Build Spice for the first time into the build subdirectory

Use this command to run it:

python dev-setup.py # Linux/macOS/Windows

Re-build Spice

There is also a batch/shell script to rebuild Spice. Use the following command to run it:

python build.py # Linux/macOS/Windows

You can find the build output in the build subdirectory.

Available target platforms

Currently, Spice only offers stable support for linux/x86_64, linux/aarch64, windows/x86_64, darwin/x86_64, darwin/aarch64 and webassembly. But you can try to compile to the following architectures without any stability promises:

aarch64, amdgpu, armv5, armv6, armv7, mips, nvptx, powerpc, riscv, webassembly, x86, x86_64

Contribute to the project

If you want to contribute to this project, please ensure you comply with the contribution guidelines.

© ChilliBits 2021-2026