# Thalovant Docs

> Thalovant connects local clients to hosted voice-assistant hubs.
> A **hub** receives a question and answers it; a **client** is the phone,
> speaker, or program that sends it; **access rules** decide what each client may do.

Every page below is also available as Markdown: append `.md` to its URL.
The whole site as one file is at /llms-full.txt.

## Start here

Read these first. The setup guide is the only page a new reader needs.

- [Welcome to Thalovant](https://docs.thalovant.com/) (~1621 tokens): Build assistants, agents, and apps with Thalovant hubs, skills, SDKs, MCP, and connected devices. Explore public hubs or manage a private workspace.
- [First Setup](https://docs.thalovant.com/start/first-successful-setup/) (~1567 tokens): New to Thalovant? Set up one hub and one client, then ask it a question out loud.
- [Free Tier](https://docs.thalovant.com/start/free-tier/) (~1731 tokens): Start on the Free tier with public hubs, one connection, one memory item, 100 intents a day, and clear limits before upgrading.
- [Glossary](https://docs.thalovant.com/start/glossary/) (~1702 tokens): Plain-language definitions for the main Thalovant terms.
- [Hosted Hubs and Local Devices](https://docs.thalovant.com/start/hosted-and-local/) (~913 tokens): Choose a Thalovant setup by understanding hosted hubs, local voice clients, Home Assistant, and what still needs an internet connection.
- [Kids and Families](https://docs.thalovant.com/start/kids-and-families/) (~842 tokens): Thalovant accounts are for adults. Children use kid-labelled hubs that keep no transcripts or memory, or a kids' profile on the Family plan.
- [Private Beta Guide](https://docs.thalovant.com/start/private-beta/) (~1040 tokens): Know what to expect, what Thalovant measures, how to get help, and how to leave the invitation-only private beta.
- [What is Thalovant?](https://docs.thalovant.com/start/what-is-thalovant/) (~1207 tokens): A platform for assistants, agents, and apps. Learn how hubs, skills, connected clients, and private workspaces fit together, and choose your first step.

## Using the console

The screens in the Thalovant console and what each one owns.

- [Access rules](https://docs.thalovant.com/concepts/access-rules/) (~1531 tokens): Understand how access rules link clients to hubs and keep access clear.
- [Connections](https://docs.thalovant.com/concepts/clients/) (~2231 tokens): Understand Thalovant connections, setup links, private files, access choices, and live status.
- [What Can My Hub Be Asked?](https://docs.thalovant.com/concepts/hub-intents/) (~3632 tokens): List every intent a hub answers, with the sentences a person says, from a connected client and without an API token.
- [Hubs](https://docs.thalovant.com/concepts/hubs/) (~1793 tokens): Understand what a Thalovant hub is, what it owns, and how public and private hubs differ.
- [Will it speak my language?](https://docs.thalovant.com/concepts/languages/) (~943 tokens): What actually decides which language Thalovant understands and answers in, and how to check before you commit.
- [Runtime](https://docs.thalovant.com/concepts/runtime/) (~912 tokens): Understand shared skill settings such as language, location, and speech.
- [Skills](https://docs.thalovant.com/concepts/skill-sets/) (~2071 tokens): Understand how hubs get abilities through shared or separate skills.
- [Topology](https://docs.thalovant.com/concepts/topology/) (~1085 tokens): See which clients are live, stale, or missing on each hub, and find out why one is not showing or not connecting.
- [Add a Skill to a Hub](https://docs.thalovant.com/manage/add-a-skill-to-a-hub/) (~3560 tokens): Install, update, or remove a skill on one hub from the app, the API, the SDKs, the CLI, or MCP, without restarting the hub.
- [Add Your Own Skill](https://docs.thalovant.com/manage/add-your-own-skill/) (~1040 tokens): Install a skill you wrote — from a public or private Git repository or a Python package — into one skill set in a few clicks.
- [Configure Runtime](https://docs.thalovant.com/manage/configure-runtime/) (~1121 tokens): Change runtime language, location, speech defaults, and blocked skills safely.
- [Connect a Client](https://docs.thalovant.com/manage/connect-a-client/) (~1624 tokens): Create one Thalovant connection, send a setup link, and verify the first heartbeat.
- [Create a Hub](https://docs.thalovant.com/manage/create-a-hub/) (~1156 tokens): Create a private or public hub, choose skills, add public details, and review launch settings.
- [Link Home Assistant](https://docs.thalovant.com/manage/home-assistant/) (~2580 tokens): Let your Thalovant devices control your home through Home Assistant, from the Thalovant integration in HACS, with nothing to open on your network.
- [Install Thalovant Voice](https://docs.thalovant.com/manage/install-thalovant-voice/) (~1190 tokens): Install Thalovant Voice on macOS, Windows, Linux, or headless Linux before pairing.
- [Update a skill, a runtime, or a hub](https://docs.thalovant.com/manage/manage-updates/) (~986 tokens): A skill update, a runtime update, and a hub update are three different things. This page says which one you want.
- [Analytics](https://docs.thalovant.com/workspace/analytics/) (~3362 tokens): Read Thalovant usage analytics, demand signals, geography, client posture, and hub activity.
- [Billing and Plans](https://docs.thalovant.com/workspace/billing-and-plans/) (~3053 tokens): Compare Home and Work plans, prices, trials, annual renewal, limits, and how to withdraw, cancel, or get a public hub reviewed.
- [Dashboard](https://docs.thalovant.com/workspace/dashboard/) (~982 tokens): Read your workspace's health card, plan and spend, keys, recent changes, updates, and fleet health.
- [Devices](https://docs.thalovant.com/workspace/devices/) (~1197 tokens): What Thalovant knows about your organisation's devices, who can change them, and what happens when one is repaired or sold on.
- [Limits and what they mean](https://docs.thalovant.com/workspace/limits/) (~1248 tokens): Every allowance a Thalovant plan controls, what happens when you reach one, and how to change or cancel a plan.
- [Memory](https://docs.thalovant.com/workspace/memory/) (~1023 tokens): Use private Daily Desk memory without confusing it with public hub previews.
- [Public Hubs](https://docs.thalovant.com/workspace/public-hubs/) (~1729 tokens): Browse shared hub listings, starter prompts, audience guidance, and public connection paths.
- [Team Workspace](https://docs.thalovant.com/workspace/team-workspace/) (~745 tokens): Prepare a shared workspace with plan rules, help ownership, and a clear first setup.

## Building on it

SDKs in eight languages, the MCP server, and writing your own skills.

- [Developer Docs](https://docs.thalovant.com/developers/) (~2938 tokens): Build a voice skill, or connect your app to a Thalovant hub with an SDK.
- [Actions and Exact Inputs](https://docs.thalovant.com/developers/actions-and-exact-inputs/) (~811 tokens): Send structured actions, button selections, barcodes, QR values, and typed codes through SDK clients.
- [AI Disclosure](https://docs.thalovant.com/developers/ai-disclosure/) (~1037 tokens): Every Thalovant client must tell people they are talking to an AI at first contact. Get the ai_disclosure text from the API and show or speak it.
- [Events and Rich Output](https://docs.thalovant.com/developers/events-rich-output/) (~967 tokens): Handle Thalovant speech replies, display items, policy events, and normalized SDK responses.
- [Home Plan Developers](https://docs.thalovant.com/developers/home-developer-access/) (~929 tokens): What developers get on the Home and Family plans, the personal-use terms, the token and rate limits, and when to move to a Work plan.
- [Hub Endpoints](https://docs.thalovant.com/developers/hub-endpoints/) (~1440 tokens): Use WSS, HTTPS, and MQTT over TLS hub endpoints so SDK clients can connect without installing a desktop app.
- [Identity Files](https://docs.thalovant.com/developers/identity-files/) (~2196 tokens): Store Thalovant client credentials, endpoint defaults, protocol flags, and broker credentials for SDK use.
- [MCP Server](https://docs.thalovant.com/developers/mcp/) (~8354 tokens): Connect Claude, Codex, Cursor, and other MCP clients to Thalovant hubs through the published Thalovant MCP server.
- [MQTT](https://docs.thalovant.com/developers/mqtt/) (~2197 tokens): Connect Thalovant SDKs or a custom MQTT client over TLS with per-client broker credentials, scoped topics, and encrypted frames.
- [Operations](https://docs.thalovant.com/developers/operations/) (~350 tokens): Follow an API command from acceptance to completion, and handle delays or failures.
- [Provision Hubs](https://docs.thalovant.com/developers/provisioning/) (~5890 tokens): Discover marketplace skills, then create a runtime group and a hub, install a skill, and release it from code.
- [SDK Functions](https://docs.thalovant.com/developers/sdk-functions/) (~3910 tokens): Copy-paste Thalovant SDK examples for control-plane calls, identities, runtime requests, events, and context.
- [Client identities and protocols](https://docs.thalovant.com/developers/sdk-functions/client-identities/) (~1541 tokens): Create a client identity, load it back, and see which protocols it can use.
- [Events, context, and diagnostics](https://docs.thalovant.com/developers/sdk-functions/events-and-context/) (~1648 tokens): Wait for one event or stream many, build request context, and check a connection.
- [Finding and provisioning hubs](https://docs.thalovant.com/developers/sdk-functions/finding-hubs/) (~3176 tokens): List hubs, read one, create one, update it, and follow the operation that results.
- [Signing in and creating a client](https://docs.thalovant.com/developers/sdk-functions/signing-in/) (~3961 tokens): Create an API client, sign in with a password, a browser, a device, or a token.
- [Talking to a hub](https://docs.thalovant.com/developers/sdk-functions/talking-to-a-hub/) (~4365 tokens): Connect, ask, list what it understands, and send utterances, actions, and codes.
- [SDK origins](https://docs.thalovant.com/developers/sdk-origins/) (~1045 tokens): Request and review browser origins before web SDK calls reach Thalovant API routes.
- [SDKs](https://docs.thalovant.com/developers/sdks/) (~4649 tokens): Choose a Thalovant SDK and connect an app, service, device, or agent to a hub.
- [.NET SDK](https://docs.thalovant.com/developers/sdks/dotnet/) (~6195 tokens): Install the Thalovant .NET SDK for C# services and Unity apps that connect to a hub.
- [Embedded C Library](https://docs.thalovant.com/developers/sdks/embedded-c/) (~3510 tokens): Build a C99 device client for Thalovant hubs with your own MQTT or WebSocket transport.
- [Go SDK](https://docs.thalovant.com/developers/sdks/go/) (~6302 tokens): Install the Thalovant Go SDK for services, gateways, CLIs, and long-running agents.
- [Kotlin SDK](https://docs.thalovant.com/developers/sdks/kotlin/) (~6003 tokens): Install the Thalovant Kotlin SDK for JVM services and Android apps that connect to a hub.
- [Node SDK](https://docs.thalovant.com/developers/sdks/node/) (~6520 tokens): Install the Thalovant Node SDK for JavaScript services, scripts, bots, and agents.
- [Python SDK](https://docs.thalovant.com/developers/sdks/python/) (~8744 tokens): Install the Thalovant Python SDK for agents, services, CLIs, notebooks, and test clients.
- [Rust SDK](https://docs.thalovant.com/developers/sdks/rust/) (~6637 tokens): Install the Thalovant Rust SDK for strict clients, embedded work, and reliable services.
- [Swift SDK](https://docs.thalovant.com/developers/sdks/swift/) (~6146 tokens): Install the Thalovant Swift SDK for iOS, macOS, and Linux apps that connect to a hub.
- [Sessions and Context](https://docs.thalovant.com/developers/sessions-context/) (~1060 tokens): Pass stable session, user, device, and trace context through Thalovant SDK requests.
- [What SkillKit Gives You](https://docs.thalovant.com/developers/skillkit-capabilities/) (~1565 tokens): Find SkillKit helpers by task, from what you want the skill to do to the call that does it and the page that explains it.
- [Keep Your Skill Responsive](https://docs.thalovant.com/developers/skillkit-runtime/) (~3041 tokens): Use SkillKit for cached resources, varied sounds, bounded service calls, background refresh, and optional persistence without copying the plumbing.
- [Build an Educational Quiz](https://docs.thalovant.com/developers/skillkit-tutorial/) (~3630 tokens): Build Pocket Quiz with SkillKit in three short lessons: a first reply, two languages, then a game with sounds and a score per player. Then ship it.
- [Status Stream](https://docs.thalovant.com/developers/status-stream/) (~787 tokens): Resume ordered hub, client, ACL, and runtime condition updates from a durable server-sent event cursor.
- [Writing a Skill](https://docs.thalovant.com/developers/writing-a-skill/) (~11710 tokens): Start a Thalovant skill with SkillKit, then find practical help with language, conversations, tests, packaging, and installation.

## When something is wrong

Symptom-first. Start from what you can see or hear.

- [Get Support](https://docs.thalovant.com/account/get-support/) (~1537 tokens): Prepare a useful Thalovant support request for Discord, bugs, feature ideas, or private follow-up.
- [Help](https://docs.thalovant.com/help/) (~783 tokens): Choose the fastest Thalovant help path from a visible problem, limit, support request, or bug report.
- [Find Your Way](https://docs.thalovant.com/help/find-your-way/) (~945 tokens): Use search, Help and resources, and page context to reach the right Thalovant guide quickly.
- [Known Limits](https://docs.thalovant.com/help/known-limits/) (~2088 tokens): Understand a hub limit reached message and check Thalovant plan, connection, runtime, support, and safety limits before changing setup.
- [Troubleshooting Decision Tree](https://docs.thalovant.com/troubleshooting/decision-tree/) (~1139 tokens): Choose the next troubleshooting page from one symptom.
- [Something is wrong](https://docs.thalovant.com/troubleshooting/symptom-index/) (~1585 tokens): Start from what you can see or hear, and open the one page that owns it.

## Account and trust

Sign-in, tokens, audit, and where your voice goes.

- [API Tokens](https://docs.thalovant.com/account/api-tokens/) (~2393 tokens): Create scoped, expiring API tokens for scripts and agents, and approve device sign-in requests on the activate page.
- [Audit](https://docs.thalovant.com/account/audit/) (~1089 tokens): Review account actions, sign-ins, sessions, and a support-safe history packet without exposing secrets.
- [Profile and Security](https://docs.thalovant.com/account/profile-security/) (~2136 tokens): Manage your identity, security, account export, retention, and deletion.
- [Sign In and Account Access](https://docs.thalovant.com/account/sign-in-and-account-access/) (~1375 tokens): Create an account, sign in, recover access, and complete two-step verification safely.
- [Withdraw or Cancel a Plan](https://docs.thalovant.com/account/withdraw-and-cancel/) (~1503 tokens): Withdraw from a new Thalovant contract within 14 days, or cancel a plan at any time, with or without signing in, and get an immediate email receipt.
- [Where your voice goes](https://docs.thalovant.com/trust/) (~1054 tokens): What happens to the sound of your voice, hop by hop, and which parts never leave the device.

## Everything else

Release notes and worked examples.

- [Page Not Found](https://docs.thalovant.com/404/) (~31 tokens): The requested Thalovant documentation page could not be found.
- [Scenario Playbook](https://docs.thalovant.com/examples/scenarios/) (~1691 tokens): Follow a public hub scenario or explore named Thalovant scenarios with decisions, steps, and success checks.
- [Legal Documents](https://docs.thalovant.com/legal/) (~799 tokens): Find the Thalovant terms, privacy policy, business terms, DPA, withdrawal information, AI safety protocol, and the current legal document version.
- [Release Notes](https://docs.thalovant.com/updates/release-notes/) (~7552 tokens): Track Thalovant product, SDK, MCP, and documentation changes and find the relevant upgrade guidance.
- [Easter Eggs](https://docs.thalovant.com/use/easter-eggs/) (~1422 tokens): Discover playful space computers, friendly dragons, secret codes and retro sounds with Thalovant Easter Eggs.