> 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/cli/version.md).

# telys version

Reference for telys version — how it prints the installed SDK version and the on-disk format version, and how to read each part.

Print the installed Telys version and the on-disk format version. Use it to confirm which build you are running and whether a collection from another install is format-compatible.

## Synopsis

```
telys version
```

Takes no arguments; exits `0` whenever the SDK is importable.

## Output

```bash
telys version
```

```
telys 0.1.15 (format v1)
```

The line has two parts:

| Part            | Source                 | Meaning                                                                                        |
| --------------- | ---------------------- | ---------------------------------------------------------------------------------------------- |
| `telys <ver>`   | `telys.__version__`    | The installed distribution version, read from package metadata. This release reports `0.1.15`. |
| `(format v<N>)` | `telys.FORMAT_VERSION` | The on-disk format contract for collections. Currently `1`.                                    |

Both values are importable from the SDK:

```python
from telys import __version__, FORMAT_VERSION

print(__version__)      # "0.1.15"
print(FORMAT_VERSION)   # 1
```

## Running from a source checkout

`__version__` reads the installed distribution's metadata. In a source tree that was never installed as a wheel, there is no metadata to read and the version falls back to a sentinel:

```
telys 0.0.0+source (format v1)
```

{% hint style="info" %}
`0.0.0+source` means you are running the SDK from a checkout rather than an installed package. Run `pipx install telys` (or `pip install telys`) to get a versioned build. `FORMAT_VERSION` is unaffected — it is a code constant, not metadata.
{% endhint %}

## Exit codes

| Code | Meaning                               |
| ---- | ------------------------------------- |
| `0`  | Version printed.                      |
| `2`  | Usage error (an unexpected argument). |

## See also

* [Upgrade Telys](https://docs.telys.ai/operations/upgrading.md) — moving between versions.
* [Verify your install](https://docs.telys.ai/start-here/verify-install.md) — confirm the runtime as well as the SDK.
* [telys runtime](https://docs.telys.ai/cli/runtime.md) — check the installed runtime, not just the SDK.
