Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Upgrade

Upgrade the Telys SDK with pipx or pip, re-verify the signed runtime, and confirm the new version.

Upgrade Telys by upgrading the Python package: pipx upgrade telys or pip install -U telys. An SDK upgrade leaves your credentials, collections, and the installed runtime under $TELYS_HOME untouched. If a release expects a newer runtime or a refreshed license, telys tells you, and you re-verify.

Upgrade steps

1

Note your current version

telys version

This prints telys <version> (format v<N>), for example telys 0.1.15 (format v1). Record it to confirm the change afterward.

2

Upgrade the package

Use the tab matching your install method.

pipx upgrade telys
pip install -U telys
3

Re-verify the runtime

Confirm the signed runtime still verifies against the new SDK:

telys runtime verify

If verification reports the runtime missing or out of date, reinstall it:

telys runtime install
4

Re-authenticate if prompted

If a command reports an expired or missing license, sign in again:

telys login

Add --plan telys_pro if you are on a commercial plan.

5

Confirm the new version

telys version

Expected result

telys version reports the newer release, and telys runtime verify succeeds:

telys 0.1.15 (format v1)
runtime VERIFIED  [macos-arm64]  /Users/you/.telys/runtime/macos-arm64
  artifacts: libty_runtime.dylib, libame_kernel.dylib, telys_manifest.json
  license: tier=developer exp=1788500000

Your collections under $TELYS_HOME open as before. The format version in parentheses is the on-disk format the SDK expects; if it is unchanged across the upgrade, no migration is needed.

If telys version still shows the old number, your shell is resolving a stale telys on PATH. Run pipx list (pipx) or which telys (pip) to find which environment provides the command.

Next steps

Last updated

Was this helpful?