Skip to content

Installing Tycho

StefanVonRanda edited this page Aug 4, 2026 · 3 revisions

Installing Tycho

A C compiler (cc) and make — that's the whole toolchain. The transpiler is a single dependency-free C file.

git clone https://github.com/StefanVonRanda/tycho
cd tycho
make                                  # builds ./tychoc
./tychoc examples/hello.ty && ./examples/hello
what is your name: Ada
hello Ada

That's it. The tutorial picks up from here: Tutorial — from hello-world to a real program in about an hour.

Optional extras

Everything below is optional; Tycho builds and runs without any of it:

  • pkg-config plus a system library for the FFI-backed corelib modules (like core:http). Those modules skip cleanly when the library is absent.
  • A Go toolchain for the cross-language benchmarks under bench/ (also skipped cleanly when absent).

Platform notes

  • Builds and self-hosts on any unix-like OS — developed and gated on Debian (x86-64), and benchmarked on macOS (Apple Silicon).
  • No native Windows, but WSL is fine.
  • On macOS: xcode-select --install first. Apple's AddressSanitizer ships no LeakSanitizer, so that half of the sanitizer build is skipped there (the rest still runs).

Verifying the build

make ci runs the whole gate locally — the test suite, the sanitizer builds, the corelib, the concurrency/FFI/fuzz lanes, the performance guard and the spec check. It takes about twenty minutes and needs no cloud service. A quick smoke is make ci N=0, which skips the slow fuzz lanes.

Clone this wiki locally