Skip to content

Installation

Tessel is a single download: the tessel command (which includes the IDE and its own linker) and the runtime library that apps are built with. You don’t need anything else: no Xcode, no Visual Studio, no Rust or LLVM.

In Terminal:

Terminal window
curl -fsSL https://github.com/alexiusacademia/tessel/releases/latest/download/install.sh | sh

This installs Tessel into ~/.tessel/bin and adds that folder to your PATH. Open a new terminal window afterwards.

Tessel runs on Macs with Apple silicon (M1 or later), macOS 11 or newer.

Terminal window
brew install alexiusacademia/tessel/tessel

brew upgrade tessel updates it, and so does tessel update (which runs Homebrew). Homebrew has only the latest version; a project can still use another with tessel pin.

In PowerShell:

Terminal window
irm https://github.com/alexiusacademia/tessel/releases/latest/download/install.ps1 | iex

This installs Tessel into %LOCALAPPDATA%\Tessel\bin and adds it to your PATH. Open a new terminal afterwards.

Tessel runs on 64-bit Windows 10 and 11.

In a terminal:

Terminal window
curl -fsSL https://github.com/alexiusacademia/tessel/releases/latest/download/install.sh | sh

This installs Tessel into ~/.tessel/bin and adds that folder to your PATH (in ~/.bashrc, ~/.zshrc or ~/.profile, for your shell). Open a new terminal afterwards.

Tessel runs on 64-bit Linux, on PCs (x86-64) and ARM64 computers, with glibc 2.34 or newer: Ubuntu 22.04, Debian 12, Fedora 35, RHEL 9 (and Rocky and Alma 9), or anything newer. It builds programs that run on older systems too, from glibc 2.28 (see For Linux). It needs no compiler: its own linker is inside it.

The IDE and the apps you build use your desktop’s windows (X11 or Wayland), GPU driver and fonts, which every desktop Linux has.

Terminal window
tessel --version

Then make a file called hello.tsl:

fn main() {
print("Hello, Tessel!")
}

and run it:

Terminal window
tessel run hello.tsl
Hello, Tessel!

Next, build your first app, or type tessel in a folder to open the Tessel IDE.

The installers download from the repository’s GitHub releases. To install by hand, download the package for your system from the newest release:

SystemPackage
macOS (Apple silicon)tessel-<version>-macos-arm64.tar.gz
Windows (64-bit)tessel-<version>-windows-x64.zip
Linux (x86-64)tessel-<version>-linux-x64.tar.gz
Linux (ARM64)tessel-<version>-linux-arm64.tar.gz

Unpack it into a folder and add the folder to your PATH. Each release also has a SHA256SUMS file to check the download against. (Releases up to 0.15.1 are in https://storage.googleapis.com/tessel-releases/<version>/; the installers and tessel update find them there too.)

On macOS, tessel is signed with a Developer ID and notarized by Apple, so it runs even when downloaded with a web browser.

Keep libtessel_runtime.a (tessel_runtime.lib on Windows) in the same folder as tessel, and on Linux and Windows the sdk folder too: every app you build is linked with them.

Terminal window
tessel update

Downloads the latest release and replaces your installation with it. The download is checked against the release’s checksums before anything is changed, so an interrupted or damaged download leaves your installation as it was. Apps you’ve already built aren’t affected; rebuild them to use the new version.

  • tessel update --check only says whether a newer version exists.
  • tessel update v0.1.2 installs that version instead, newer or older, for example to go back after an update.

The Tessel IDE checks for a newer version when it opens, and shows an Update button in its toolbar when there is one.

tessel update came with Tessel 0.1.3. To get it from an older version, run the install command above once more.

So that installations can be counted, Tessel sends a small message to stats.syncster.dev:

  • when it’s installed, and when it changes version (the install scripts and tessel update send this);
  • at most once a day, when it’s used: the first tessel command of the day says that this installation is in use.

Each message holds:

  • a random id made on your computer the first time (kept in the stats file in Tessel’s folder), which names this installation and not you;
  • the version of Tessel, and the version before it on an update;
  • the system (macOS, Windows or Linux) and the processor’s kind (arm64 or x86_64).

Nothing else is sent: not your name or your computer’s, not your files or your code, not which commands you run or what your programs do. Your address reaches the server with the message, as with any request on the internet; the count doesn’t record it. The programs and apps you build with Tessel send nothing.

You’re told about this once: by the install script, or by the first tessel command in a terminal after an update brings it. Nothing is reported about use before that.

To turn it off for good:

Terminal window
tessel telemetry off

tessel telemetry says what’s reported and whether it’s on, and tessel telemetry on turns it back on. Setting TESSEL_NO_STATS=1 (or DO_NOT_TRACK=1) in the environment turns it off for the commands that see it, the install command included:

Terminal window
curl -fsSL https://github.com/alexiusacademia/tessel/releases/latest/download/install.sh | TESSEL_NO_STATS=1 sh

Automated builds (where CI is set) report nothing.

Set TESSEL_VERSION before running the installer:

Terminal window
curl -fsSL https://github.com/alexiusacademia/tessel/releases/latest/download/install.sh | TESSEL_VERSION=v0.1.0 sh

Delete ~/.tessel (macOS and Linux) or %LOCALAPPDATA%\Tessel (Windows), and remove the PATH line the installer added to ~/.zshrc (macOS), your shell’s startup file (Linux: ~/.bashrc, ~/.zshrc or ~/.profile) or your user Path variable (Windows).