https://github.com/rafaelpierre/openai-agents-redis

Native OpenAI Agents SDK session management implementation using Redis as the persistence layer.
https://github.com/rafaelpierre/openai-agents-redis

agents artificial-intelligence llama llama-cpp multiagent-systems ollama openai openai-agents-sdk redis

Last synced: 2 months ago
JSON representation

Native OpenAI Agents SDK session management implementation using Redis as the persistence layer.

• Host: GitHub
• URL: https://github.com/rafaelpierre/openai-agents-redis
• Owner: rafaelpierre
• License: mit
• Created: 2025-07-21T16:02:02.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-08-05T12:42:41.000Z (2 months ago)
• Last Synced: 2025-08-05T14:39:36.570Z (2 months ago)
• Topics: agents, artificial-intelligence, llama, llama-cpp, multiagent-systems, ollama, openai, openai-agents-sdk, redis
• Language: Python
• Homepage: https://pypi.org/project/openai-agents-redis/
• Size: 74.2 KB
• Stars: 5
• Watchers: 0
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🤖 OpenAI Agents Redis

[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Redis](https://img.shields.io/badge/redis-%23DD0031.svg?style=flat&logo=redis&logoColor=white)](https://redis.io/)

[![OpenAI](https://img.shields.io/badge/OpenAI-GPT-green.svg)](https://openai.com/)

> Native [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/) session management implementation using [Redis](https://redis.io) as the persistence layer.

## Demo



    

        

    



## ✨ Features

- 🧠 **Intelligent Agents**: Built on OpenAI's powerful Agents SDK

- ⚡ **Redis Integration**: Lightning-fast caching and persistent storage

- 🔄 **Conversation Memory**: Maintain context across interactions

## 🚀 Quick Start

### Installation

```bash

# Using uv (recommended)

uv add openai-agents-redis

# Using pip

pip install openai-agents-redis

```

### Basic Usage

```python

from agents_redis.session import RedisSession

session = RedisSession(

    session_id=session_id, #Use your own logic to generate a session_id

    redis_url="redis://localhost:6379",

)

# Your code for defining an Agent

# ...

# Starting the runner passing the session

result = Runner.run_streamed(

    starting_agent=current_agent, input=agent_input, context=current_context, session=session

)

```

## Development

### Testing Requirements

🐳 [Docker](https://www.docker.com/) 


⚡️ [uv](https://astral.sh/uv) 


🦾 [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/) (optional) 


🔑 OpenAI API Key (optional) 


### Running Tests

```bash

# Run all tests

uv run pytest

# Run with coverage

uv run pytest --cov

```

## 📋 Roadmap

- [ ] Storing conversation context

- [ ] Full text search

- [ ] Vector similarity search & Hybrid Search

- [ ] Built-in monitoring dashboard

---



  Made with ❤️ by Rafael





  ⭐ Star us on GitHub!