commit 4e2be3e8ed9edaedcb1ae6ea514caa0883f969c2
Author: danielgafni <danielgafni16@gmail.com>
Date:   Sat Sep 12 00:34:32 2026 +0300

    :tada: initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..361a3bc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# TypeSafe AI Python SDK
+
+Python SDK for [TypeSafe AI](https://typesafe.ai).
+
+## Quickstart
+
+Install the SDK:
+
+```
+uv add typesafe-sdk
+```
+
+Set `TYPESAFE_API_KEY` in your environment, then instantiate and use the client:
+
+```python
+from typesafe_sdk import Choice, TypeSafeClient
+
+with TypeSafeClient() as client:
+    response = client.system_one(
+        state={"document": "I was charged twice. Please fix this ASAP."},
+        questions={
+            "category": Choice(
+                instructions="What is this ticket about?",
+                criteria={"billing": None, "technical": None, "other": None},
+            ),
+        },
+    )
+
+print(response.choices["category"].choice)
+```
+
+learn what TypeSafe is, what it can do, and how to use it in [TypeSafe docs](https://docs.typesafe.ai/).
+
+## Documentation
+
+Learn more in [SDK docs](https://docs.typesafe.ai/sdk/python/).