From d32616043a8d45d34eda4256c29be85308a507c5 Mon Sep 17 00:00:00 2001
From: smaramwbc <145447586+smaramwbc@users.noreply.github.com>
Date: Fri, 22 May 2026 08:51:31 +0100
Subject: [PATCH] docs: note the running-server prerequisite in the README

Add a callout before Install: the SDK is a thin client for a running Statewave server, with a link to the Getting Started guide for setting one up.
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index e03b0a7..039c51a 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,12 @@ Statewave Python SDK — memory runtime for AI agents and applications. The Type
 >
 > 📋 **Issues & feature requests:** [statewave/issues](https://github.com/smaramwbc/statewave/issues) (centralized tracker)
 
+> **New to Statewave?** This SDK is a thin client for a running **Statewave
+> server**. If you don't have one yet, the
+> [Getting Started guide](https://github.com/smaramwbc/statewave-docs/blob/main/getting-started.md)
+> brings one up with Docker Compose in about 5 minutes. Every example below
+> assumes a server reachable at `http://localhost:8100`.
+
 ## Install
 
 ```bash