> 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/resources/changelog.md).

# Changelog

Released versions of the public `telys` package, newest first. Telys is in public beta; the on-disk format is versioned separately as `FORMAT_VERSION` so storage can evolve without breaking data. Pin a specific version:

```bash
pipx install 'telys==0.1.0b2'   # or: pip install 'telys==0.1.0b2'
```

## Releases

| Version   | Channel     | On-disk format       | Highlights                                                           |
| --------- | ----------- | -------------------- | -------------------------------------------------------------------- |
| `0.1.0b2` | Public beta | `FORMAT_VERSION = 1` | MCP registry ownership marker carried onto PyPI; `server.json` fixes |
| `0.1.0b1` | Public beta | `FORMAT_VERSION = 1` | Initial public beta — SDK, CLI, MCP server, signed runtime           |

Exact release dates are omitted where not recorded; both shipped during the 2026 public beta.

## 0.1.0b2

The current release. A packaging and Model Context Protocol update on top of `0.1.0b1`; no breaking changes to the SDK surface.

* **MCP registry ownership marker.** The published package carries the registry ownership marker (`server.json`) through to PyPI, so the Telys MCP server is claimable and verifiable in the MCP registry.
* **`server.json` schema fixes.** The server description is trimmed to the registry's limit (100 characters) so the manifest validates.
* **No API changes.** Public exports, CLI commands, and the five MCP tools are unchanged from `0.1.0b1`; code written against `0.1.0b1` runs unmodified.

Install:

```bash
pipx install telys
telys version        # telys 0.1.0b2 (format v1)
```

## 0.1.0b1

The initial public beta — the first release of Telys as an installable package.

* **Public SDK.** The `telys` facade with `create_collection` / `open_collection`, the `Collection` ingest/query/tune/persist API, `Eq` filtering, and `scope_key` for composing partition keys.
* **Embedders** in `telys.embedding`: the deterministic lexical family (`AlgentaBigramEmbedder`, `AlgentaMultigramEmbedder`) and `CallableEmbedder` for bring-your-own vectors, with `EmbeddingProfile` space identity.
* **CLI** (`telys`): `login`, `version`, `runtime` (status / install / verify), `serve`, `mcp` (install / uninstall / status), and `mem`.
* **MCP server**: the stdio server exposing five tools — `telys_search`, `telys_add`, `telys_create_collection`, `telys_list_collections`, `telys_stats`.
* **Signed runtime**: the closed native runtime, downloaded per platform and verified offline before it is trusted, plus the `telys.verify` API and embedded release/license public keys.
* **Serving**: `telys serve` with `RemoteTelys` / `connect` over a Unix socket or TCP (TCP requires an access token).

## Compatibility notes

* **Python**: `requires-python >= 3.10`; classifiers list 3.10 through 3.13. The wheel is pure-Python (`py3-none-any`) and the runtime loads via `ctypes`, so it also runs on 3.14. See [Python version support](/operations/python-version-support.md).
* **Platforms**: the hosted runtime installer supports `macos-arm64`, `linux-x86_64`, and `linux-arm64` (experimental). Windows is supported via WSL2; Intel macOS is not yet supported. See [Supported platforms](/operations/supported-platforms.md).
* **Dependencies**: `numpy >= 1.24` and `cryptography >= 42`. The closed runtime is an optional extra (`telys[runtime]`), not a hard dependency.
* **`telys runtime update`** is a stub in this line: it prints "not implemented yet" and exits `2`. Update by reinstalling — see [Upgrade Telys](/operations/upgrading.md).

## See also

* [Roadmap](/resources/roadmap.md) — planned, not-yet-shipped directions.
* [SDK API index](/reference/sdk-api-index.md) — the full current surface.
* [Upgrade Telys](/operations/upgrading.md) — how to move between versions.


---

# 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/resources/changelog.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.