Start

Getting started

Install Sun, create a source file, and use the verified CLI.

01

Install

Released Linux and Windows binaries have official installers. macOS currently builds from source.

Terminal
# Linux x86-64
curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/tamadeu/sun/main/install.sh | sh

# Build from source (Rust 1.85+)
git clone https://github.com/tamadeu/sun.git
cd sun
cargo test
cargo install --path crates/sun-cli
02

CLI commands

  • sun new [NAME] creates a source file (default: hello.sun).
  • sun run <FILE> executes with the interpreter.
  • sun check <FILE> parses and validates without executing.
  • sun lex <FILE> prints the token stream.
  • sun repl starts a persistent interactive session.
  • sun compile <FILE> [-o|--output <OUTPUT>] builds through LLVM/Clang.
  • sun studio <FILE> [--check] opens Studio; studio-session is an internal protocol command.
03

Create and run

Terminal
sun new hello.sun
sun check hello.sun
sun run hello.sun