Install

Install Musi with Script or Cargo

Install Rust and libffi first, then choose a script bootstrap or a local cargo install. Both paths install music and musi into Cargo's bin directory.

Learn Community

Rust

Rust 1.87 or newer

Builds both package and direct-mode tooling.

libffi

System development package

Required for current foreign-function flow.

Git

Any recent Git install

Retrieves and updates project source.

Install Script

Pick one bootstrap command. The scripts download the repository archive, then install both binaries 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

Prefer this when you already cloned the repository and want an explicit 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 · Current Commands

Use package commands most of the time. Use direct commands when you want one file or one artifact.

Musi command reference
Lane	Command	Description
Package	`musi check`	Check the current package.
Package	`musi build`	Build the resolved package entry.
Package	`musi run`	Run the package entry.
Package	`musi test`	Discover and run *.test.ms files.
Direct	`music check index.ms`	Check one direct source graph.
Direct	`music build index.ms`	Emit one direct .seam artifact.
Direct	`music run index.seam`	Run compiled bytecode directly.