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

# Uninstall

Uninstalling has two parts: removing the `telys` package, and — for a clean slate — removing the on-disk state under `$TELYS_HOME` (`~/.telys` by default). Removing the package leaves your collections, credentials, and the installed runtime in place, so a later reinstall picks up where you left off. Removing `$TELYS_HOME` deletes all of that permanently.

{% hint style="danger" %}
`$TELYS_HOME` holds **your collections** along with cached credentials, the device key, and the runtime. Deleting it is irreversible — back up any collections you want to keep first.
{% endhint %}

## Uninstall steps

{% stepper %}
{% step %}

#### Remove the package

Use the tab matching your install method.

{% tabs %}
{% tab title="pipx" icon="terminal" %}

```bash
pipx uninstall telys
```

{% endtab %}

{% tab title="pip" icon="python" %}

```bash
pip uninstall telys
```

{% endtab %}
{% endtabs %}

This removes the `telys` command and the SDK. It does **not** touch `$TELYS_HOME`.
{% endstep %}

{% step %}

#### (Optional) Clear on-disk state

To remove every trace of Telys — collections, cached credentials, the device key, and the installed runtime — delete the state directory:

```bash
rm -rf ~/.telys
```

If you relocated state with `TELYS_HOME`, remove that path instead:

```bash
rm -rf "$TELYS_HOME"
```

{% endstep %}
{% endstepper %}

## Expected result

`telys` is no longer on your `PATH` — running it reports command not found:

```
$ telys version
zsh: command not found: telys
```

If you also removed `$TELYS_HOME`, the directory is gone:

```
$ ls ~/.telys
ls: /Users/you/.telys: No such file or directory
```

If you kept `$TELYS_HOME`, your collections and credentials remain, and a future `pipx install telys` finds them again.

{% hint style="info" %}
Unsure what `$TELYS_HOME` contains? See [On-disk layout](/operations/on-disk-layout.md) for the full file tree, and back up collections first with [Snapshots & persistence](/working-with-data/snapshots-and-persistence.md).
{% endhint %}

## Next steps

* [On-disk layout](/operations/on-disk-layout.md) — exactly what removing `~/.telys` deletes.
* Next: [Install Telys](/start-here/install.md) — reinstall whenever you are ready.


---

# 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/operations/uninstalling.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.