Install

One line through sharpie, a release tarball, or a build from source.

Through sharpie

sharpie is the version manager for W#, in the mould of rustup and juliaup. It is the recommended way in, because it is also the only way that makes upgrading and per-project pinning possible later.

curl -fsSL https://raw.githubusercontent.com/sinisterMage/sharpie/main/install.sh | sh
export PATH="$HOME/.sharpie/bin:$PATH"
sharpie install stable

The installer prints that PATH line with the right directory already in it, so you can copy it from your terminal rather than from here. Put it in your shell’s profile to make it stick.

Then check that everything answers:

sharpie show
wsharp --help
ingot --help

Piping a script into a shell deserves an explanation, so here is what that one does. It needs only uname, tar and one of curl or wget. It works out your platform triple from uname -s and uname -m, follows the redirect on sharpie’s releases/latest to find the newest version, downloads one tarball and its published .sha256 sidecar, and refuses to continue if it cannot check the digest: it will not install from an unverified download even if you have no sha256sum. It then copies a single binary into ~/.sharpie/bin and hands over to sharpie init.

Two environment variables change what it does. SHARPIE_HOME says where to install, and SHARPIE_VERSION pins a version instead of taking the newest. You need SHARPIE_VERSION if you have wget but not curl, because finding the latest version is a redirect that only curl is asked to follow.

Upgrading sharpie is running the same line again. It drops a new binary in and init rewrites the proxies as copies of it, which is why there is no self update verb.

From a release tarball

If you would rather not pipe a script into a shell, take the toolchain directly. Releases are published on GitHub, one tarball per platform with a .sha256 beside it.

version=0.1.1
triple=x86_64-unknown-linux-gnu

curl -fsSLO "https://github.com/sinisterMage/WSharp/releases/download/v${version}/wsharp-${version}-${triple}.tar.gz"
curl -fsSLO "https://github.com/sinisterMage/WSharp/releases/download/v${version}/wsharp-${version}-${triple}.tar.gz.sha256"
sha256sum -c "wsharp-${version}-${triple}.tar.gz.sha256"
tar xzf "wsharp-${version}-${triple}.tar.gz"

What comes out is a directory, not one binary:

wsharp-0.1.1-x86_64-unknown-linux-gnu/
├── wsharp
├── ingot
├── lib/libwsharp_start.a
├── README.md
└── LICENSE

The archive matters. wsharp build links your program against it, and wsharp looks for it beside itself and under ../lib, so moving wsharp out of that directory and onto your PATH on its own will break build while leaving run and check working. Put the whole directory somewhere and add its top level to PATH, or let sharpie handle it.

ingot finds wsharp beside itself before consulting PATH, for the same reason.

From source

You need Rust 1.95 or newer and a C toolchain, because rustc shells out to cc to link.

git clone https://github.com/sinisterMage/WSharp
cd WSharp
cargo test --workspace
cargo run -p wsharp-cli -- run examples/status.ws

On a bare NixOS box there is no cc on PATH, so the repository provides a dev shell:

nix-shell                         # rustc and cargo from the system, cc from nixpkgs
nix-shell --run "cargo run -p wsharp-cli -- run examples/status.ws"

ingot is not built by cargo. It is a W# program, bootstrapped by the compiler you just built:

cargo run -p wsharp-cli -- build --module ingot/main -o ingot

Platforms

Three, for both the compiler and sharpie:

Windows is missing on purpose rather than by omission. The compiler builds and links there, but fs.mkdir_all reports success without creating the last component of a path, so ingot install fails for any package with a src/ directory. Shipping that would be shipping a toolchain whose package manager does not work.

Architectures other than x86-64 and aarch64 do not build at all: the collector reads the frame pointer with inline assembly, and everything else gets a compile_error!.

Next

Getting started is a first program and the three commands that act on it.

Last changed 8 September 2026. Improve this page