Install Temper

For individual users — someone who wants the temper CLI on their own machine, against a
hosted or self-hosted deployment.

By the end of this playbook you will have the temper binary installed and on your PATH,
ready to run temper init and connect to an instance. No Rust toolchain, no system package
manager, no homebrew tap is required.

Prerequisites

A supported platform: macOS (Apple Silicon), Linux (x86_64), or Windows (x86_64). For
other platforms (Linux arm64, Intel Mac, Windows arm64), see
Building from source below.

A deployment to point at. If someone else runs the instance, ask them for the URL. If
you are standing it up yourself, see Self-host Temper.

Quick install

macOS and Linux

curl -fsSL https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.ps1 | iex

If PowerShell warns about the execution policy, run:

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.ps1 | iex"

What the installer does

Detects your OS and CPU architecture.

Queries GitHub for the latest release tag.

Downloads the matching archive (a .tar.gz on macOS/Linux, .zip on Windows) plus its
SHA256 checksum file.

Verifies the checksum.

macOS/Linux only: downloads the release's per-file manifest and checks every extracted
file (temper, the bundled libonnxruntime, LICENSE) against it. A mismatch aborts
before your existing install is touched. See
Release Verification for what this check does and
does not prove.

Extracts the archive into:

macOS/Linux: ~/.local/share/temper/ (respects $XDG_DATA_HOME)

Windows: %LOCALAPPDATA%\Programs\temper\

Creates a temper entry on your PATH:

macOS/Linux: symlinks ~/.local/bin/temper → the extracted binary

Windows: appends the install directory to your user PATH

The archive contains temper[.exe], a bundled libonnxruntime for the local embedding
pipeline (used server-side; CLI ingestion routes through the cloud API), and a copy of the
project LICENSE.

Pinning to a specific version

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.sh | sh -s -- --version v0.1.0

# Windows
$script = irm https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.ps1
& ([scriptblock]::Create($script)) -Version v0.1.0

Don't want to pipe to `sh`?

Download the script, read it, then run it:

curl -fsSL -o /tmp/install-temper.sh https://raw.githubusercontent.com/tasker-systems/temper/main/scripts/install/install.sh
less /tmp/install-temper.sh         # inspect
sh /tmp/install-temper.sh           # run

Or grab the release tarball directly from
github.com/tasker-systems/temper/releases
and unpack it wherever you like.

Upgrading

Run the installer again — it overwrites the previous install in place.

On macOS/Linux, a curl-script install can also self-update:

temper update

temper update verifies the release before installing and works for curl-script installs on
macOS/Linux. For the verification it performs, see
Release Verification; for the full flag reference, see
temper update.

Uninstalling

macOS / Linux

rm -rf "${XDG_DATA_HOME:-$HOME/.local/share}/temper"
rm -f "${XDG_BIN_HOME:-$HOME/.local/bin}/temper"

Windows

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\temper"
# Then manually remove the install dir from your user PATH via:
#   rundll32.exe sysdm.cpl,EditEnvironmentVariables

Building from source

If you are on a platform we don't ship binaries for (Linux arm64, Intel Mac, Windows arm64)
or you want a custom build, clone the repo and cargo install:

git clone https://github.com/tasker-systems/temper
cd temper
cargo install --path crates/temper-cli --locked --features embed,extract

You'll need:

A Rust toolchain (install via rustup)

A C++ compiler (for transitive deps)

ONNX Runtime installed on your system if you want local embedding support. On macOS,
brew install onnxruntime suffices.

Troubleshooting

"temper: command not found" after install (macOS/Linux)

Your shell's PATH doesn't include ~/.local/bin. Add it:

# bash
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc

# zsh
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc

# fish
fish_add_path ~/.local/bin

Then open a new terminal.

Windows: "temper : The term 'temper' is not recognized"

Restart your terminal. If the problem persists, log out of Windows and back in (or reboot)
so the updated user PATH propagates.

Windows: SmartScreen warning

The temper.exe binary is currently unsigned. On first run, you may see a SmartScreen
"Windows protected your PC" dialog. Click More info → Run anyway.

ONNX Runtime not found

The installer bundles libonnxruntime next to the temper binary for the embedding
pipeline. If you see a library-load error, file an issue at
https://github.com/tasker-systems/temper/issues with the output of:

temper --version
ls -la ~/.local/share/temper/     # macOS / Linux
dir %LOCALAPPDATA%\Programs\temper # Windows

Next: initialize the CLI

The installer's exit message points at temper --help, but the command you actually want
next is temper init — it writes your config and points the CLI at an instance:

temper init

Answer "hosted" if you are connecting to temperkb.io, or provide your instance URL for a
self-hosted deployment. Then continue with Authenticate to sign in and
request access.

Install Temper

Prerequisites#

Quick install#

macOS and Linux#

Windows (PowerShell)#

What the installer does#

Pinning to a specific version#

Don't want to pipe to sh?#

Upgrading#

Uninstalling#

macOS / Linux#

Windows#

Building from source#

Troubleshooting#

"temper: command not found" after install (macOS/Linux)#

Windows: "temper : The term 'temper' is not recognized"#

Windows: SmartScreen warning#

ONNX Runtime not found#

Next: initialize the CLI#

Further reading#