From a32a051e32c3df80c5da42a4a0bf12475cbf0077 Mon Sep 17 00:00:00 2001
From: Lakshman Patel <Lakshmanp230@gmail.com>
Date: Wed, 22 Jul 2026 05:50:17 +0530
Subject: [PATCH] docs(python-sdk): add pre-release notice and source
 installation instructions

---
 README.md | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 03051d9..8940b71 100644
--- a/README.md
+++ b/README.md
@@ -29,9 +29,23 @@ the same API surface on each.
 
 ## Installation
 
-```bash
-pip install hawk-sdk
-```
+> **⚠️ Pre-release — not yet published to PyPI.**
+>
+> `hawk-sdk` is under active development and has not yet been published to
+> the Python Package Index. Installing from PyPI will fail until a stable
+> release is tagged. In the meantime, install directly from source:
+>
+> ```bash
+> git clone https://github.com/GrayCodeAI/hawk-sdk-python.git
+> cd hawk-sdk-python
+> pip install -e .
+> ```
+>
+> Once the first stable release is tagged, the standard install will work:
+>
+> ```bash
+> pip install hawk-sdk   # available after first stable release
+> ```
 
 ## Quick Start