Install minc

One command installs the toolchain into ~/.minc (%USERPROFILE%\.minc on Windows) and adds it to your PATH:

The installer verifies checksums, offers to install the VS Code extension when VS Code is present, and runs without admin rights.

What gets installed

• minc: the compiler, one executable for every target
• minc-lsp, minc-dbg: language server and debugger
• libminc: the compiler as an embeddable library, for JIT and hot reload
• lib/: the standard library as .mc source modules
• editor/: the VS Code extension (.vsix)
• LANGUAGE.md, DEBUGGING.md, AGENTS.md: the language reference, the debugging guide, and guidance for AI coding agents
• minc_update: updates the install in place

Getting started

$ minc --version
$ git clone https://github.com/SpacesOfPlay/minc-samples
$ cd minc-samples
$ minc run hello.mc
Hello, world! 🎉

Examples and benchmarks live in the minc-samples repo (MIT). See the Language Reference for full documentation.

Updating

Run the update script installed next to the compiler:

minc_update

Uninstalling

Removes the toolchain directory, the PATH entry, and the VS Code extension:

powershell -c "irm minc.dev/uninstall.ps1 | iex"     # Windows
curl -fsSL https://minc.dev/uninstall | bash         # macOS / Linux

Manual download

Unpack the archive, then run the bundled setup.cmd (Windows) or source setup.sh (macOS / Linux) to add it to your PATH. Each release carries SHASUMS256.txt to check the download against.

The arm64 builds, and the arm64 programs minc generates, need ARMv8.1 or later. Every Apple Silicon Mac, AWS Graviton2 and later, and Android devices from about 2018 on qualify.

Support minc

minc is freeware, free for everyone including commercial use. If it is useful to you, pay what you want (€10 or more) or donate on Ko-fi. Payment is voluntary.