Skip to content

rafaelpierre/openai-agents-redis

Repository files navigation

🤖 OpenAI Agents Redis

Python 3.13+ License: MIT Redis OpenAI

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

Demo

Demo Video

✨ 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

# Using uv (recommended)
uv add openai-agents-redis

# Using pip
pip install openai-agents-redis

Basic Usage

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
⚡️ uv
🦾 OpenAI Agents SDK (optional)
🔑 OpenAI API Key (optional)

Running Tests

# 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!

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages