1 files changed, 19 insertions, 0 deletions
diff --git a/packages/sdk/python/examples/basic_usage.py b/packages/sdk/python/examples/basic_usage.py
new file mode 100644
index 000000000..0d8349959
--- /dev/null
+++ b/packages/sdk/python/examples/basic_usage.py
@@ -0,0 +1,19 @@
+# Basic usage example (placeholder)
+# After generating the client, this should reflect actual client entrypoints.
+
+try:
+    from opencode_ai import client  # type: ignore
+except Exception:  # pragma: no cover
+    client = None
+
+
+def main() -> None:
+    if client is None:
+        print("Client not generated yet. Run the generator first:")
+        print("    uv run python packages/sdk/python/scripts/generate.py")
+        return
+    print("Replace this with real example code once the client is generated.")
+
+
+if __name__ == "__main__":
+    main()