Installation

Python toolchain

Requires Python 3.10 or later.

pip install tigris-ml

This pulls in all Python dependencies automatically. pip picks a wheel for your platform:

Platform	Wheel	tigris run
Linux x86-64 and ARM64, glibc 2.28 or newer	native (manylinux_2_28)	yes
macOS 11 or newer, x86-64 and ARM64	native	yes
Windows x86-64	native	yes
musl Linux (Alpine), Windows ARM64, 32-bit ARM Linux, older glibc	pure Python	with your own host library

Native wheels bundle the portable C runtime as a host library, so tigris run can execute compiled plans on your machine. The pure Python wheel has every other command: analyze, compile, codegen, export, inspect and zoo. There run and analyze --trace stop with “Bundled host runtime is unavailable”, analyze reports slow traffic as not measured, and compile writes its plan without first loading it with the runtime’s loader. To get all of that, build the host library from the runtime sources and set TIGRIS_HOST_LIBRARY to it; see Using your own host library. No native runtime is downloaded separately during installation or execution.

Development install

Clone the repo and install with dev extras for testing:

git clone https://github.com/raws-labs/tigris.git
cd tigris
pip install -e ".[dev]"

The [dev] extra adds pytest and onnxruntime (used for reference output validation).

Verify

tigris --version

This also prints the host runtime version and where it comes from, for example tigris, version X.Y.Z (runtime X.Y.Z; bundled), or (runtime unavailable) on the pure wheel without an override. Compiler and runtime release as a pair with the same version number; each plan still records its own schema, and each runtime states which plan schemas it accepts.

C runtime

The runtime is a self-contained C project built with CMake as C11. It has no external dependencies and needs no package manager. The portable harness that tigris codegen generates is C99.

git clone https://github.com/raws-labs/tigris-runtime.git
cd tigris-runtime
cmake -B build && cmake --build build

Run the self-contained test suite:

ctest --test-dir build --output-on-failure

Platform notes

Platform	Status	Notes
Linux (x86_64, aarch64)	Supported	Primary development platform
macOS (Apple Silicon, Intel)	Supported
Windows (x86-64)	Supported for the Python toolchain	The native wheel includes the host runtime. Building the C runtime for firmware from Windows is untested; WSL is recommended.

Next step

Ready to deploy? Follow the Quickstart.