> ## Documentation Index > Fetch the complete documentation index at: https://docs.typesafe.ai/llms.txt > Use this file to discover all available pages before exploring further. # Quick start > Prefer to just dive in? Here's everything you need to get started immediately. ## Try it: the Playground 1. **Open the [Playground](https://console.typesafe.ai/playground)** and log in. 2. **Paste any text** as the state. ```plaintext title="Sample state" theme={null} Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP. ``` 3. **Add a question.** Try a Noul: `"Does this message express urgency?"` ```json theme={null} { "urgency": { "type": "noul", "instructions": "Does this message express urgency?" } } ``` 4. **Add more questions.** Mix Noul, Choice, and Score in one call and see all results at once. ## Call it: the API 1. **Get your API key** from the [dashboard](https://console.typesafe.ai/settings/keys) 2. **Make a POST request** to the API endpoint 3. **Review the [API Reference](/api)** for all the details. ```http theme={null} POST https://api.typesafe.ai/v1/systemone Authorization: Bearer Content-Type: application/json ``` ### Sample cURL command ```bash theme={null} curl -X POST https://api.typesafe.ai/v1/systemone \ -H "Authorization: Bearer $TYPESAFE_API_KEY" \ -H "Content-Type: application/json" \ -d @- <<'EOF' { "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.", "model": "jev-latest", "questions": { "urgency": { "type": "noul", "instructions": "Does this message express urgency?" } } } EOF ``` ### Request body ```json theme={null} { "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.", "model": "jev-latest", "questions": { "department": { "type": "choice", "instructions": "Which team should handle this", "criteria": { "billing": "Payment or subscription issues", "technical": "Bugs or integration problems", "sales": "Pricing or account questions" } }, "frustration": { "type": "score", "instructions": "How frustrated the customer appears", "criteria": [ "Calm, just stating facts", "Frustrated but civil", "Very angry, strong language" ] }, "is_urgent": { "type": "noul", "instructions": "The message conveys urgency or time-sensitivity" } } } ``` ### Response body ```json theme={null} { "model": "jev-latest", "answers": { "department": { "type": "choice", "choice": "technical", "probabilities": { "billing": 0.159, "technical": 0.84, "sales": 0.001 }, "confidence": 0.596 }, "frustration": { "type": "score", "score": 1.035, "legend": { "0": "Calm, just stating facts", "1": "Frustrated but civil", "2": "Very angry, strong language" }, "confidence": 0.842 }, "is_urgent": { "type": "noul", "noul": 0.999 } }, "usage": { "input_tokens": 312, "output_tokens": 48 } } ``` See the [API Reference](/api) for all the details. ## Code it: the Python SDK 1. **Install the SDK** (requires Python >= 3.10). ```bash title="With pip" theme={null} pip install typesafe-sdk ``` ```bash title="With uv" theme={null} uv add typesafe-sdk ``` 2. **Use the SDK.** The client reads `TYPESAFE_API_KEY` from the environment and calls `jev-latest` by default. ```python theme={null} from typesafe_sdk import Choice, Noul, Score, TypeSafeClient client = TypeSafeClient() ticket = "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP." response = client.system_one( state=ticket, questions={ "department": Choice( instructions="Which team should handle this", criteria={ "billing": "Payment or subscription issues", "technical": "Bugs or integration problems", "sales": "Pricing or account questions", }, ), "frustration": Score( instructions="How frustrated the customer appears", criteria=[ "Calm, just stating facts", "Frustrated but civil", "Very angry, strong language", ], ), "is_urgent": Noul( instructions="The message conveys urgency or time-sensitivity", ), }, ) print(response.answers["department"].choice) # "technical" print(response.answers["frustration"].score) # 1.035 print(response.answers["is_urgent"].noul) # 0.999 ``` See [client SDKs](/sdk) for installation options and detailed usage. ## Vibe it: the agent skill 1. **[Install the TypeSafe skill](/agent-skill#installation)** using the Claude Code plugin or `npx skills add typesafe-ai/skills --skill typesafe-ai`. You can also [read SKILL.md on GitHub](https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md). Run these two commands in your terminal: ```bash theme={null} claude plugin marketplace add typesafe-ai/skills claude plugin install typesafe@typesafe-ai ``` ```bash theme={null} npx skills add typesafe-ai/skills --skill typesafe-ai ``` Choose your agent when prompted. Installation is project-local by default; add `-g` to install globally. Paste this prompt into your coding agent: ```text wrap theme={null} Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project. ``` 2. **Tell your coding agent** to use the TypeSafe skill as you build! ```plaintext title="Coding agent prompt" theme={null} Let's build a simple CLI that uses the TypeSafe API to evaluate a set of supplied documents on multiple dimensions. Use the TypeSafe skill to understand how to use the TypeSafe API and how to structure the system. Ask me questions about what kinds of documents I want to evaluate and on what dimensions. ``` See the [Agent Skill](/agent-skill) page for more details.