get it running
Install ScalaScript.
One launcher, then every .ssc file is an executable. Today the
supported route is a build from source — one JDK, one command. Prebuilt binaries and a
Coursier channel are on the way.
01Requirements
The standard runtime is deliberately light.
- Java 21+ — the only hard requirement for the standard
sscruntime.scalac/javacare not needed. - sbt — needed only to build the launcher from source (the step below). scala-sbt.org
- Node.js optional — only for the JavaScript backend. nodejs.org
- Scala CLI optional — only for tools-tier
ssc-toolscommands, never for plainssc.
02Build from source
The supported install today. Clone, build the launcher, and bin/ssc is ready.
# clone the repository
git clone https://github.com/sergey-scherbina/scalascript
cd scalascript
# build + stage the local bin/ launchers (uses sbt)
./install.sh --dev
This assembles the thin runtime jar and writes bin/ssc (plus
ssc-tools, ssc-standard, and friends). Put bin/ on your
PATH, or call bin/ssc directly.
./setup.sh first — it installs Scala CLI and checks the JDK before
./install.sh --dev builds the launcher.03Run a document
A .ssc file is Markdown you can compile. Run one straight to output.
$ ssc run examples/hello.ssc
Hello, world!
# or package it for a target
$ ssc build-jvm greeter.ssc -o greeter.jar
$ ssc run --bytecode ask.ssc # native VM lane
The same source lowers to the JVM, JavaScript, WebAssembly, Rust, Swift, and a self-hosted native VM — you pick the backend at build time. See the getting-started guide and the user guide.
04Prebuilt native binaries coming soon
CI already compiles GraalVM native images for three platforms. A standalone release channel to download them is not published yet — build from source (step 02) for now.
| Platform | Artifact | Status |
|---|---|---|
| Linux · x86-64 | ssc-linux-x86_64 | built in CI |
| macOS · Apple Silicon | ssc-macos-arm64 | built in CI |
| macOS · Intel | ssc-macos-x86_64 | built in CI |
cs install ssc --channel … and a releases.scalascript.io download
server are planned, not yet live. When a release is published, this page is where the
one-line install will land.