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

# Support

Where to get help with Telys — the contact form, the accounts portal, and this documentation site — plus what to include so we can help fast.

Telys is generally available. This page lists the ways to get help and what to attach so a first reply is useful.

## Where to get help

| Channel         | Use it for                                                             | Link                                         |
| --------------- | ---------------------------------------------------------------------- | -------------------------------------------- |
| Contact form    | Bugs, questions, licensing, enterprise — anything with account details | [telys.ai/contact](https://telys.ai/contact) |
| Accounts portal | Sign-in, subscription, device management                               | [accounts.thyn.ai](https://accounts.thyn.ai) |
| Documentation   | How-tos, references, troubleshooting                                   | [docs.telys.ai](https://docs.telys.ai)       |

## Try troubleshooting first

Many issues have a documented fix. Before filing, skim [Troubleshooting](https://docs.telys.ai/troubleshooting/overview.md) — it covers [install & runtime](https://docs.telys.ai/troubleshooting/install-and-runtime.md), [license & login](https://docs.telys.ai/troubleshooting/license-and-login.md), [signature verification](https://docs.telys.ai/troubleshooting/signature-verification.md), [poor recall](https://docs.telys.ai/troubleshooting/search-and-recall.md), [dimension mismatches](https://docs.telys.ai/troubleshooting/dimension-mismatches.md), and [MCP client](https://docs.telys.ai/troubleshooting/mcp-client.md) problems.

## File a good bug report

Use the [contact form](https://telys.ai/contact) with the details below — it keeps account and license details private.

{% hint style="warning" %}
Never include secrets. Do not paste API keys, license tokens (`login_license.jwt`), or access tokens into an issue. Redact `$TELYS_API_KEY`, `$TELYS_TOKEN`, `$TELYS_ACCESS_TOKEN`, and `$TELYS_LICENSE` before sharing logs.
{% endhint %}

Include the essentials so we can reproduce:

{% stepper %}
{% step %}

#### Capture your versions

Run these and paste the output.

```bash
telys version           # e.g. telys 0.1.15 (format v1)
telys runtime status    # 0 = ready, 1 = not installed
python3 --version
```

{% endstep %}

{% step %}

#### Confirm the runtime is trusted

A verification failure explains a whole class of errors.

```bash
telys runtime verify
```

{% endstep %}

{% step %}

#### Describe what happened

State your OS and architecture (for example `macos-arm64` or `linux-x86_64`), the exact command or code you ran, the full error text, and what you expected. A minimal snippet that reproduces the problem beats a description.
{% endstep %}
{% endstepper %}

## What you will get back

A pointer to the fix or the relevant docs page, a request for more detail, or — for a confirmed bug — confirmation that we have logged it. Licensing and subscription questions are handled via the [contact form](https://telys.ai/contact) and the [accounts portal](https://accounts.thyn.ai).

## Next steps

* [Resources & links](https://docs.telys.ai/resources/resources.md) — every official Telys link in one place.
* [FAQ](https://docs.telys.ai/resources/faq.md) — the fastest answers to common questions.
* [Troubleshooting](https://docs.telys.ai/troubleshooting/overview.md) — self-serve fixes.
