diff --git a/fastapi_startkit/src/fastapi_startkit/ai/__init__.py b/fastapi_startkit/src/fastapi_startkit/ai/__init__.py
index dbf4c85e..e0bfc154 100644
--- a/fastapi_startkit/src/fastapi_startkit/ai/__init__.py
+++ b/fastapi_startkit/src/fastapi_startkit/ai/__init__.py
@@ -1,3 +1,12 @@
+"""FastAPI Startkit AI package.
+
+.. warning::
+
+    The AI package is under active development. APIs may change without notice
+    as we experiment with the best integration patterns. Use with caution in
+    production.
+"""
+
 from .agent import Agent
 from .pipeline import Middleware
 from .audio import Audio, AudioResponse