docs: add examples directory with basic usage

Add examples/basic/main.py demonstrating how to use the Python SDK to interact with hawk daemon.

Co-authored-by: CommandCodeBot <noreply@commandcode.ai>

Author: Patel230

examples/basic/main.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+"""Basic example of using the Hawk SDK."""
+
+from hawk import HawkClient
+
+def main():
+    with HawkClient() as client:
+        # Health check
+        health = client.health()
+        print(f"Hawk daemon: version={health.version}, sessions={health.sessions}")
+
+        # Chat
+        response = client.chat("Explain what a decorator is in Python")
+        print(f"Response: {response.response}")
+
+        # Streaming
+        print("\nStreaming response:")
+        with client.chat_stream("Write a haiku about code") as stream:
+            for event in stream.events():
+                print(event.data, end="", flush=True)
+        print()
+
+if __name__ == "__main__":
+    main()