> For the complete documentation index, see [llms.txt](https://docs.telys.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telys.ai/operations/supported-platforms.md).

# Supported platforms

Reference for the platforms the Telys signed runtime supports, plus the reach of the pure-Python SDK.

Telys has two layers with different portability. The public SDK (`telys`) is **pure Python** — a `py3-none-any` wheel that installs anywhere a supported Python runs. The **signed native runtime** that executes collection operations is a platform-specific binary, shipped for a fixed set of targets. This page covers that runtime.

## Runtime platform matrix

| `platform_tag()` | OS / architecture    | Runtime  | `lib_ext` | Status            |
| ---------------- | -------------------- | -------- | --------- | ----------------- |
| `macos-arm64`    | macOS, Apple Silicon | Yes      | `dylib`   | Supported         |
| `linux-x86_64`   | Linux, x86-64        | Yes      | `so`      | Supported         |
| `linux-arm64`    | Linux, ARM64         | Yes      | `so`      | Experimental      |
| `macos-x86_64`   | macOS, Intel         | No       | `dylib`   | Not yet supported |
| Windows          | Windows, x86-64      | Via WSL2 | `dll`     | Use WSL2          |

`platform_tag()` returns `<os>-<arch>`; the library extension follows the OS (`dylib`, `so`, `dll`). The runtime installs under `runtime/<platform_tag>/` — see [On-disk layout](https://docs.telys.ai/operations/on-disk-layout.md).

## Platform notes

{% tabs %}
{% tab title="macOS" icon="apple" %}
**Apple Silicon (`macos-arm64`) is fully supported.** Install and sign in:

```bash
pipx install telys
telys login
telys runtime verify
```

**Intel Macs (`macos-x86_64`) are not yet supported.** The SDK installs and imports, and the offline `telys.verify` APIs work, but collection operations report that no runtime is installed for this platform.
{% endtab %}

{% tab title="Linux" icon="linux" %}
**`linux-x86_64` is fully supported.** **`linux-arm64` is experimental** — it installs and runs, but validate it for your workload before relying on it in production.

```bash
pipx install telys
telys login
telys runtime status
```

{% endtab %}

{% tab title="Windows" icon="windows" %}
There is no native Windows runtime. Run Telys inside **WSL2**, which presents as `linux-x86_64` — a fully supported target. Install and use it exactly as on Linux.

```bash
# inside your WSL2 shell
pipx install telys
telys login
```

{% endtab %}
{% endtabs %}

## SDK vs runtime

This distinction matters when planning a deployment:

* **The SDK is portable.** `pip install telys` / `pipx install telys` succeeds on any OS and architecture with a supported Python, because the wheel is pure Python. You can `import telys`, build embedding profiles, and call the `telys.verify` functions without a runtime.
* **Collection operations need the runtime.** Creating, ingesting into, or searching a collection loads the signed native runtime via ctypes, and that binary exists only for the supported platforms above. The `Algenta*` embedders additionally need the native kernel.

{% hint style="info" %}
On an unsupported platform, `telys runtime status` returns non-zero and any collection call raises `RuntimeNotInstalled`. To verify a release manifest or a license offline, the SDK alone is enough. See [The signed runtime & trust model](https://docs.telys.ai/understand-telys/signed-runtime-trust.md).
{% endhint %}

## See also

* [Python version support](https://docs.telys.ai/operations/python-version-support.md) — the Python versions Telys runs on.
* [On-disk layout](https://docs.telys.ai/operations/on-disk-layout.md) — where the per-platform runtime is installed.
* [Platform-specific issues](https://docs.telys.ai/troubleshooting/platform-specific.md) — fixes for common per-OS problems.

## Next steps

* [Install Telys](https://docs.telys.ai/start-here/install.md) — set up the SDK and runtime on a supported platform.
* Next: [Verify your install](https://docs.telys.ai/start-here/verify-install.md) to confirm the runtime is ready.
