Add Docker Compose setup for Agent Memory Server

Added infrastructure to run Agent Memory Server for notebooks and CI:

1. docker-compose.yml:
   - Redis Stack (with RedisInsight)
   - Agent Memory Server with health checks

2. .env.example:
   - Template for required environment variables
   - OpenAI API key configuration

3. Updated README.md:
   - Comprehensive setup instructions
   - Docker Compose commands
   - Step-by-step guide for running notebooks

4. Updated CI workflow:
   - Start Agent Memory Server in GitHub Actions
   - Wait for service health checks
   - Set environment variables for notebooks
   - Show logs on failure for debugging

This allows users to run 'docker-compose up' to get all required
services, and CI will automatically start the memory server for
notebook tests.

Author: abrookins

.github/workflows/test.yml

@@ -87,9 +87,14 @@ jobs:
 
     services:
       redis:
-        image: redis:8.0-M03
+        image: redis/redis-stack:latest
         ports:
           - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
 
     steps:
       - uses: actions/checkout@v3
@@ -99,6 +104,30 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
+      # Start Agent Memory Server
+      - name: Start Agent Memory Server
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          docker run -d \
+            --name agent-memory-server \
+            --network host \
+            -e REDIS_URL=redis://localhost:6379 \
+            -e OPENAI_API_KEY=$OPENAI_API_KEY \
+            -e LOG_LEVEL=info \
+            redis/agent-memory-server:latest
+
+          # Wait for memory server to be ready
+          echo "Waiting for Agent Memory Server to be ready..."
+          for i in {1..30}; do
+            if curl -f http://localhost:8000/health 2>/dev/null; then
+              echo "Agent Memory Server is ready!"
+              break
+            fi
+            echo "Waiting... ($i/30)"
+            sleep 2
+          done
+
       - name: Create and activate venv
         run: |
           python -m venv venv
@@ -114,7 +143,14 @@ jobs:
         env:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           COHERE_API_KEY: ${{ secrets.COHERE_API_KEY }}
+          AGENT_MEMORY_URL: http://localhost:8000
+          REDIS_URL: redis://localhost:6379
         run: |
           echo "Testing notebook: ${{ matrix.notebook }}"
           source venv/bin/activate
           pytest --nbval-lax --disable-warnings "${{ matrix.notebook }}"
+
+      - name: Show Agent Memory Server logs on failure
+        if: failure()
+        run: |
+          docker logs agent-memory-server

python-recipes/context-engineering/.env.example

@@ -0,0 +1,12 @@
+# OpenAI API Key (required for LLM operations)
+OPENAI_API_KEY=your-openai-api-key-here
+
+# Redis Configuration
+REDIS_URL=redis://localhost:6379
+
+# Agent Memory Server Configuration
+AGENT_MEMORY_URL=http://localhost:8000
+
+# Optional: Redis Cloud Configuration
+# REDIS_URL=redis://default:password@your-redis-cloud-url:port
+

python-recipes/context-engineering/README.md

@@ -86,26 +86,47 @@ These modules are designed to be imported in notebooks and used as building bloc
 
 ## Getting Started
 
-1. **Set up the environment**: Install required dependencies
-2. **Run the reference agent**: Start with the complete implementation
-3. **Explore the notebooks**: Work through the educational content
-4. **Experiment**: Modify and extend the agent for your use cases
+### Prerequisites
 
-## Prerequisites
-
-- Python 3.8+
-- Redis 8 (local or cloud)
+- Python 3.10+
+- Docker and Docker Compose (for running Redis and Agent Memory Server)
 - OpenAI API key
 - Basic understanding of AI agents and vector databases
 
-## Quick Start
+### Quick Start
+
+#### 1. Start Required Services
+
+The notebooks and reference agent require Redis and the Agent Memory Server to be running:
+
+```bash
+# Navigate to the context-engineering directory
+cd python-recipes/context-engineering
+
+# Copy the example environment file
+cp .env.example .env
+
+# Edit .env and add your OpenAI API key
+# OPENAI_API_KEY=your-key-here
+
+# Start Redis and Agent Memory Server
+docker-compose up -d
+
+# Verify services are running
+docker-compose ps
+
+# Check Agent Memory Server health
+curl http://localhost:8000/health
+```
+
+#### 2. Set Up the Reference Agent
 
 ```bash
 # Navigate to the reference agent directory
-cd python-recipes/context-engineering/reference-agent
+cd reference-agent
 
 # Install dependencies
-pip install -r requirements.txt
+pip install -e .
 
 # Generate sample course data
 python -m redis_context_course.scripts.generate_courses
@@ -117,6 +138,31 @@ python -m redis_context_course.scripts.ingest_courses
 python -m redis_context_course.cli
 ```
 
+#### 3. Run the Notebooks
+
+```bash
+# Install Jupyter
+pip install jupyter
+
+# Start Jupyter
+jupyter notebook notebooks/
+
+# Open any notebook and run the cells
+```
+
+### Stopping Services
+
+```bash
+# Stop services but keep data
+docker-compose stop
+
+# Stop and remove services (keeps volumes)
+docker-compose down
+
+# Stop and remove everything including data
+docker-compose down -v
+```
+
 ## Learning Path
 
 1. Start with **Section 1** notebooks to understand core concepts

python-recipes/context-engineering/docker-compose.yml

@@ -0,0 +1,41 @@
+version: '3.8'
+
+services:
+  redis:
+    image: redis/redis-stack:latest
+    container_name: redis-context-engineering
+    ports:
+      - "6379:6379"
+      - "8001:8001"  # RedisInsight
+    environment:
+      - REDIS_ARGS=--save 60 1 --loglevel warning
+    volumes:
+      - redis-data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  agent-memory-server:
+    image: redis/agent-memory-server:latest
+    container_name: agent-memory-server
+    ports:
+      - "8000:8000"
+    environment:
+      - REDIS_URL=redis://redis:6379
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      - LOG_LEVEL=info
+    depends_on:
+      redis:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 30s
+
+volumes:
+  redis-data:
+