Install

Install Musi with Script or Cargo

Install Rust and libffi first. Then use the install script or a local Cargo install. Both install music and musi into Cargo's bin directory.

Learn Community

Rust

Rust 1.87 or newer

Builds the musi and music command tools.

libffi

System dev package

Needed for code that calls C.

Git

Any recent Git install

Downloads and updates project code.

Install Script

Pick one install command. The scripts download the repository, then install both command tools with cargo install.

curl -fsSL https://raw.githubusercontent.com/musi-lang/musi/main/install.sh | sh

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/musi-lang/musi/main/install.ps1 | iex"

Cargo Install

Use this when you already cloned the repository and want a local install.

git clone https://github.com/musi-lang/musi.git
cd musi
cargo install --locked --force --path crates/music
cargo install --locked --force --path crates/musi

Quick Start

musi init hello
cd hello
musi check
musi test

Command Map · Commands

Use musi for a project most of the time. Use music when you want one file or one built file.

Musi command reference
Use for	Command	Description
Project	`musi check`	Check the current project.
Project	`musi build`	Build the current project entry.
Project	`musi run`	Run the current project entry.
Project	`musi test`	Discover and run *.test.ms files.
One file	`music check index.ms`	Check one file and what it imports.
One file	`music build index.ms`	Build one .seam file from one source file.
One file	`music run index.seam`	Run one built .seam file.