refactor: make Redis an optional dependency with better error handling

- Move redis and orjson to optional dependencies under [redis] extra
- Add clear ImportError messages guiding users to install with [redis] extra
- Reduce base package size by making Redis dependencies opt-in

Author: yvesemmanuel

contributing/samples/open_memory/README.md

@@ -14,7 +14,7 @@ for ADK agents using the community package.
 ### 1. Install Dependencies
 
 ```bash
-pip install google-adk google-adk-community
+pip install google-adk-community[redis]
 ```
 
 ### 2. Set Up OpenMemory Server

contributing/samples/redis_session_service/README.md

@@ -13,7 +13,7 @@ This sample demonstrates how to use Redis as a session storage backend for ADK a
 ### 1. Install Dependencies
 
 ```bash
-pip install google-adk google-adk-community
+pip install google-adk-community[redis]
 ```
 
 ### 2. Set Up Redis Server
@@ -109,15 +109,15 @@ async def get_health():
     return {"status": "ok"}
 
 # Run the server
-uvicorn.run(app, host="0.0.0.0", port=8080)
+uvicorn.run(app, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
 ```
 
 ### Direct RedisSessionService Usage
 
 You can also use `RedisSessionService` directly without FastAPI:
 
 ```python
-from google.adk_community.sessions import RedisSessionService
+from google.adk_community.sessions.redis_session_service import RedisSessionService
 from google.adk.runners import Runner
 from google.adk.errors.already_exists_error import AlreadyExistsError
 from google.adk.agents import Agent

pyproject.toml

@@ -28,9 +28,7 @@ dependencies = [
   "google-genai>=1.21.1, <2.0.0", # Google GenAI SDK
   "google-adk", # Google ADK
   "httpx>=0.27.0, <1.0.0", # For OpenMemory service
-  "redis >= 7.0.0", # Redis for session storage
   # go/keep-sorted end
-  "orjson>=3.11.4",
 ]
 dynamic = ["version"]
 
@@ -41,9 +39,13 @@ changelog = "https://github.com/google/adk-python-community/blob/main/CHANGELOG.
 documentation = "https://google.github.io/adk-docs/"
 
 [project.optional-dependencies]
+redis = [
+  "redis>=7.0.0", # Redis for session storage
+  "orjson>=3.11.4", # Fast JSON serialization for Redis
+]
 test = [
-    "pytest>=8.4.2",
-    "pytest-asyncio>=1.2.0",
+  "pytest>=8.4.2",
+  "pytest-asyncio>=1.2.0",
 ]
 
 
@@ -72,8 +74,8 @@ build-backend = "flit_core.buildapi"
 
 [dependency-groups]
 dev = [
-    "pytest>=8.4.2",
-    "pytest-asyncio>=1.2.0",
+  "pytest>=8.4.2",
+  "pytest-asyncio>=1.2.0",
 ]
 
 

src/google/adk_community/sessions/redis_session_service.py

@@ -20,11 +20,18 @@
 import uuid
 from typing import Any, Optional
 
-import orjson
-import redis.asyncio as redis
-from redis.crc import key_slot
 from typing_extensions import override
 
+try:
+    import orjson
+    import redis.asyncio as redis
+    from redis.crc import key_slot
+except ImportError as exc:
+    raise ImportError(
+        "redis and orjson are required to use RedisSessionService. "
+        "Install it with: pip install google-adk-community[redis]"
+    ) from exc
+
 from google.adk.events.event import Event
 from google.adk.sessions.base_session_service import (
     BaseSessionService,