> 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

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.0b2 (format v1)
```

The line has two parts:

| Part            | Source                 | Meaning                                                                                      |
| --------------- | ---------------------- | -------------------------------------------------------------------------------------------- |
| `telys <ver>`   | `telys.__version__`    | The installed distribution version, read from package metadata. This beta reports `0.1.0b2`. |
| `(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.0b2"
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](/operations/upgrading.md) — moving between versions.
* [Verify your install](/start-here/verify-install.md) — confirm the runtime as well as the SDK.
* [telys runtime](/cli/runtime.md) — check the installed runtime, not just the SDK.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.telys.ai/cli/version.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.