From 74b94935074111fb9b1d70f9d077af97fd670727 Mon Sep 17 00:00:00 2001
From: maxkahan <maxkahan94@gmail.com>
Date: Wed, 14 Oct 2026 15:05:38 +0200
Subject: [PATCH 1/2] docs: add deprecation notice to README

---
 README.md | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 25b97ce..ffec2e2 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,5 @@
-> **Note:** [`getstream`](https://github.com/GetStream/stream-py) is the new full-product SDK for Stream, covering Chat, Video, Moderation, and Feeds with long-term support.
->
-> **`stream-chat` is now in maintenance mode.** It will continue to receive critical fixes and requested features, so it is safe to keep using. However, we encourage existing users to migrate when convenient and strongly recommend that new projects start with `getstream`.
->
-> Check out the [Migration Guide](https://github.com/GetStream/stream-py/blob/221d9f15bd5f93ce2a83bb54ecd5a62e6c563da6/docs/migration-from-stream-chat-python/README.md) for side-by-side examples covering common use cases.
+> [!WARNING]
+> **`stream-chat-python` is deprecated.** New projects should use [`stream-py`](https://github.com/GetStream/stream-py) (PyPI `getstream`), which covers Chat, Video, Moderation and Feeds. To move existing code, see the [migration guide](https://github.com/GetStream/stream-py/tree/main/docs/migration-from-stream-chat-python).
 
 # Official Python SDK for [Stream Chat](https://getstream.io/chat/)
 

From 5d7d4c5eeada3fb90190a75e327a232595debdc5 Mon Sep 17 00:00:00 2001
From: Max Kahan <max.kahan@getstream.io>
Date: Mon, 19 Oct 2026 15:48:54 +0200
Subject: [PATCH 2/2] docs: make the deprecation notice prominent and mark the
 SDK as legacy

---
 README.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index ffec2e2..4eb2691 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,18 @@
-> [!WARNING]
-> **`stream-chat-python` is deprecated.** New projects should use [`stream-py`](https://github.com/GetStream/stream-py) (PyPI `getstream`), which covers Chat, Video, Moderation and Feeds. To move existing code, see the [migration guide](https://github.com/GetStream/stream-py/tree/main/docs/migration-from-stream-chat-python).
+> [!CAUTION]
+> ## ⚠️ This is a legacy SDK. It is deprecated.
+>
+> 🚫 **Do not start new projects with `stream-chat-python`.**
+>
+> ✅ **Use [`stream-py`](https://github.com/GetStream/stream-py) (PyPI `getstream`) instead.** It covers Chat, Video, Moderation and Feeds in one SDK.
+>
+> 🔁 **Already using `stream-chat-python`?** Follow the [migration guide](https://github.com/GetStream/stream-py/tree/main/docs/migration-from-stream-chat-python) to move your code.
 
-# Official Python SDK for [Stream Chat](https://getstream.io/chat/)
+# Legacy Python SDK for [Stream Chat](https://getstream.io/chat/)
 
 [![build](https://github.com/GetStream/stream-chat-python/workflows/build/badge.svg)](https://github.com/GetStream/stream-chat-python/actions) [![PyPI version](https://badge.fury.io/py/stream-chat.svg)](http://badge.fury.io/py/stream-chat) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/stream-chat.svg) [![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
 
 <p align="center">
-    <img src="./assets/logo.svg" width="50%" height="50%">
-</p>
-<p align="center">
-    Official Python API client for Stream Chat, a service for building chat applications.
+    Legacy Python API client for Stream Chat, a service for building chat applications.
     <br />
     <a href="https://getstream.io/chat/docs/"><strong>Explore the docs »</strong></a>
     <br />