thymia Documentation

This page tells your coding agent exactly where to look so it gets current answers instead of plausible-sounding ones.

Where agents should look — in order

llms.txt and llms-full.txt

Every page on this site is indexed at:

docs.thymia.ai/llms.txt — table of contents
docs.thymia.ai/llms-full.txt — full content

Fetch one of these first so the agent has the full map of the docs before drilling in.

Raw Markdown for any page

Append .md to any docs URL to get a clean Markdown version — no HTML, no navigation chrome. For example:

Page: docs.thymia.ai/helios/quickstart
Markdown: docs.thymia.ai/helios/quickstart.md

This is the cheapest way to load a single page into context.

The OpenAPI spec

For endpoint shapes, request and response schemas, and auth details, the OpenAPI spec is authoritative: api.thymia.ai/openapi.json.

Drop-in `AGENTS.md` for your repo

If you are building on thymia, add an AGENTS.md (or .cursorrules, or CLAUDE.md) to your repo so every coding agent that opens the project picks up the same guidance:

1 # Working with the thymia API
2 
3 Base URL: https://api.thymia.ai
4 Docs: https://docs.thymia.ai
5 
6 Before writing any code that calls thymia:
7 
8 1. Fetch https://docs.thymia.ai/llms.txt to find the relevant page,
9    then fetch that page with a `.md` suffix for clean Markdown.
10 2. For endpoint shapes, fetch https://api.thymia.ai/openapi.json — do not
11    guess field names, enum values, or status codes.
12 
13 Model-specific guides:
14 - Helios (real-time wellbeing): https://docs.thymia.ai/helios/quickstart.md
15 - Apollo (clinical depression/anxiety): https://docs.thymia.ai/apollo/quickstart.md
16 - Sentinel (voice-agent safety): https://docs.thymia.ai/sentinel/overview.md
17 
18 Rules:
19 - Company name is lowercase — "thymia", not "Thymia".
20 - Audio must meet the format requirements in the model's integration guide —
21   check before transcoding.
22 - Results are returned asynchronously via polling; do not assume a
23   synchronous response.