docs / guide / The Cajeta Guide

Chapters — 1. Installation
  1. Introduction
  2. 0. Introduction
  3. 1. Installation
  4. 2. Kick the tires
  5. 3. Your first project
  6. 4. Running your application
  7. 5. Debugging
  8. 6. Keywords
  9. 7. Comments
  10. 8. Native types
  11. 9. Type kinds
  12. 10. Allocation
  13. 11. Ownership & borrowing
  14. 12. Control flow
  15. 13. Strings & formatting
  16. 14. Templates & wildcards
  17. 15. Lambdas & captures
  18. 16. Operator overloading
  19. 17. Inheritance
  20. 18. Annotations & synthesis
  21. 19. DI & aspects
  22. 20. Error handling
  23. 21. Reflection
  24. 22. Differentiation
  25. 23. Code coverage
  26. 23. Profiling
  27. 24. Notebooks
  28. 25. Writing XPU Kernels

01 — Installation

Two ways in: cvm (the toolchain manager) or building from source.

With cvm

cvm installs and switches Cajeta toolchains the way rustup does for Rust. It lives in tools/cvm, and ships as a prebuilt binary with every release.

Get cvm

No cvm binary shipped with v0.46.3. Build it from source — see tools/cvm — or use the latest release.

Use cvm

cvm install latest      # download, verify checksum, install, activate
cvm default <version>   # switch the active toolchain
cvm which               # show the cvm home + active shim
cvm doctor              # diagnose the environment cvm sees

Toolchains install under ~/.cajeta/versions/<version>/; the active cajeta shim goes on your PATH. cvm self update updates cvm itself.

From source

git clone https://github.com/jklappenbach/cajeta.git
cd cajeta
./setup.sh     # toolchain prerequisites (LLVM, ANTLR, CMake, Ninja)
./build.sh     # builds the compiler

The binary lands at build/src/cajeta. On Windows use setup.cmd and build.cmd.

Verify

$ cajeta --version
cajeta 0.8.0 (8190ee59)

Any version string means you’re installed. Platform packages (.deb, .rpm, .msi, macOS bundles) are on the roadmap; today it’s cvm or source.

Next: Kick the tires.

Source: docs/guide/01-installation.md · 1 min · 153 words