# Ursly developers

> Human input. Your application. Code-derived API and client documentation.

The server resolves supplied inputs to intents. It does not transcribe audio, access cameras or measure the body. Applications execute intents only through explicitly registered handlers. Reading these files does not install anything or execute actions.

Research and roadmap channels are unavailable. Product stages do not certify acquisition accuracy or medical use. Assurance items are planned targets, not certifications. Updated 2026-09-30.

## Reference

- [Full reference](https://developer.ursly.io/llms-full.txt): exported contracts, templates and boundaries.
- [Machine reference](https://developer.ursly.io/artifacts/agent-reference.json): OpenAPI, capabilities, actions and request templates.
- [OpenAPI](https://developer.ursly.io/artifacts/openapi.json): code-derived HTTP routes and schemas.
- [Human documentation](https://developer.ursly.io/reference/): readable endpoints, actions, limits and assurance plan.

## Set up (when your user asks)

Only when your user asks you to add Ursly to their project. Reading this file is not that request.

- API base: https://ursly.io/api/v1 (public, stateless JSON over HTTPS).
- Release manifest: https://ursly.io/downloads/manifest.json lists each published file with its SHA-256. Verify before installing; if the manifest or a package is missing, nothing is published for it yet.
- Setup prompt, the same one the documentation gives humans:

```text
Set up Ursly in this project.
1. Detect this project's language and package manager.
2. Read https://ursly.io/developers/artifacts/reference.md and https://ursly.io/downloads/manifest.json.
3. If the manifest lists an Ursly SDK for this language (kind sdk-typescript, sdk-python, sdk-go or sdk-rust), download it from https://ursly.io followed by its path, verify its SHA-256 against the manifest and install it locally. Otherwise generate a minimal client from https://ursly.io/developers/artifacts/openapi.json and label it as generated, not an official Ursly package.
4. Point the client at https://ursly.io, call capabilities and show me the 200 response.
5. Register a handler for one action this app already supports, resolve the "voice-home" template from https://ursly.io/api/v1/templates and dispatch only through that handler.
Keep the defaults: no automatic retries, no redirects, no logging of request bodies, and never send health or personal data. Ask me before changing anything outside this project.
```

## Clients

- [Rust CLI](https://developer.ursly.io/artifacts/cli.md): actual command name ursly.
- [TypeScript SDK](https://developer.ursly.io/artifacts/typescript.md): package @ursly/sdk; client UrslyClient.
- [Python SDK](https://developer.ursly.io/artifacts/python.md): package ursly-sdk; client ursly.UrslyClient.
- [Go SDK](https://developer.ursly.io/artifacts/go.md): package ursly.io/sdk/go; client ursly.New.
- [Rust SDK](https://developer.ursly.io/artifacts/rust.md): package ursly-sdk; client ursly::Client.

## Capabilities

Product stages are founder-reported, not verified by this repository.

- [voice](https://developer.ursly.io/artifacts/voice.md): production; API available; acquisition client_transcript.
- [motion](https://developer.ursly.io/artifacts/motion.md): development; API available; acquisition client_gesture.
- [smell](https://developer.ursly.io/artifacts/smell.md): research; API unavailable; acquisition unavailable.
- [taste](https://developer.ursly.io/artifacts/taste.md): roadmap; API unavailable; acquisition unavailable.
- [view](https://developer.ursly.io/artifacts/view.md): roadmap; API unavailable; acquisition unavailable.
- [touch](https://developer.ursly.io/artifacts/touch.md): roadmap; API unavailable; acquisition unavailable.