REDIS_SETUP.md

# Redis Setup Guide for Chat Agent

## Why Redis is Used

The chat agent uses Redis for several performance and scalability benefits:

1. **Session Caching** - Fast access to frequently used session data
2. **Chat History Caching** - Quick retrieval of recent messages
3. **Rate Limiting** - Distributed rate limiting across multiple app instances
4. **User Session Tracking** - Managing multiple sessions per user

## Error 10061 Explanation

**Error 10061 connecting to localhost:6379** means:
- Port 6379 is Redis's default port
- No Redis server is running on your machine
- The application can't connect to Redis for caching

## Installation Options

### Option 1: Windows Native Installation

1. **Download Redis for Windows:**
   - Visit: https://github.com/microsoftarchive/redis/releases
   - Download the latest `.msi` installer
   - Run the installer and follow the setup wizard

2. **Start Redis:**
   ```cmd

   # Redis should start automatically after installation

   # Or manually start it:

   redis-server

   ```

3. **Verify Installation:**
   ```cmd

   redis-cli ping

   # Should return: PONG

   ```

### Option 2: Using Chocolatey (Windows)

```cmd

# Install Chocolatey first if you don't have it

# Then install Redis:

choco install redis-64



# Start Redis

redis-server



# Test connection

redis-cli ping

```

### Option 3: Using Docker (Recommended)

```bash

# Pull and run Redis container

docker run -d -p 6379:6379 --name redis redis:alpine



# Verify it's running

docker ps



# Test connection

docker exec -it redis redis-cli ping

```

### Option 4: WSL/Linux

```bash

# Update package list

sudo apt update



# Install Redis

sudo apt install redis-server



# Start Redis service

sudo systemctl start redis-server



# Enable auto-start on boot

sudo systemctl enable redis-server



# Test connection

redis-cli ping

```

## Configuration

### Environment Variables

Create a `.env` file in your project root:

```env

# Redis Configuration

REDIS_URL=redis://localhost:6379/0

REDIS_HOST=localhost

REDIS_PORT=6379

REDIS_DB=0

REDIS_PASSWORD=



# For production with password:

# REDIS_URL=redis://:password@localhost:6379/0

# REDIS_PASSWORD=your-secure-password

```

### Testing Configuration

For testing without Redis, set:

```env

REDIS_URL=None

```

Or use the testing configuration which automatically disables Redis.

## Running Without Redis

The application is designed to work without Redis, but with reduced performance:

### What Works Without Redis:
- ✅ All API endpoints function normally
- ✅ Session management (database-only)
- ✅ Chat history (database-only)
- ✅ Language context management
- ✅ Authentication and authorization

### What's Affected Without Redis:
- ⚠️ **Performance**: Slower session and message retrieval
- ⚠️ **Rate Limiting**: Uses in-memory storage (not distributed)
- ⚠️ **Caching**: No caching layer, all requests hit the database
- ⚠️ **Scalability**: Cannot scale across multiple app instances

### Performance Impact:
- Session retrieval: ~50-100ms slower per request
- Chat history: ~100-200ms slower for large histories
- Rate limiting: Resets when app restarts

## Production Recommendations

### Redis Configuration for Production:

1. **Use a dedicated Redis instance**
2. **Enable password authentication**
3. **Configure persistence** (RDB + AOF)
4. **Set up monitoring**
5. **Use Redis Cluster** for high availability

### Example Production Config:

```env

# Production Redis with authentication

REDIS_URL=redis://:your-secure-password@redis-server:6379/0

REDIS_PASSWORD=your-secure-password



# Connection pool settings

REDIS_MAX_CONNECTIONS=20

REDIS_SOCKET_TIMEOUT=5

REDIS_SOCKET_CONNECT_TIMEOUT=5

```

## Troubleshooting

### Common Issues:

1. **"Connection refused" (Error 10061)**
   - Redis server is not running
   - Wrong host/port configuration
   - Firewall blocking the connection

2. **"Authentication failed"**
   - Wrong password in REDIS_URL

   - Redis configured with auth but no password provided



3. **"Connection timeout"**

   - Network issues

   - Redis server overloaded

   - Wrong host address



### Debug Commands:



```bash

# Check if Redis is running

redis-cli ping



# Check Redis info

redis-cli info



# Monitor Redis commands

redis-cli monitor



# Check specific database

redis-cli -n 0 keys "*"

```



## Development vs Production



### Development (Local):

```env

REDIS_URL=redis://localhost:6379/0
```



### Testing (No Redis):

```env

REDIS_URL=None

```

### Production (Managed Redis):
```env

REDIS_URL=redis://:password@your-redis-host:6379/0

```

## Cloud Redis Services

For production, consider managed Redis services:

- **AWS ElastiCache**
- **Google Cloud Memorystore**
- **Azure Cache for Redis**
- **Redis Cloud**
- **DigitalOcean Managed Redis**

These provide:
- Automatic backups
- High availability
- Monitoring and alerts
- Security and compliance
- Automatic scaling

## Summary

The **Error 10061** occurs because Redis is not installed or running. You have three options:

1. **Install Redis** (recommended for development/production)
2. **Use Docker** to run Redis (easiest setup)
3. **Run without Redis** (works but with performance impact)

The application gracefully handles Redis being unavailable and will continue to function using database-only operations.