agent-repl-chat

A beautiful terminal chat interface for OpenAI agents with rich markdown support and an elegant UI.

Installation

Install from PyPI:

pip install agent-repl-chat

Or install in development mode using uv:

uv pip install -e .

Usage

from repl_chat import start_chat
from agents import Agent

# Create your agent
agent = Agent(
    name="My Assistant",
    instructions="You are a helpful assistant that provides clear and concise answers.",
    model="gpt-4.1-mini"
)

# Start the chat interface
start_chat(agent)

Features

• 🎨 Beautiful terminal interface with rich markdown rendering
• 🔄 Conversation continuity with response threading
• ⌨️ Interactive commands:
  • q, quit, or exit - Quit the chat
  • n or new - Start a new conversation
• 🤖 Works with any OpenAI Agent configuration
• ⚡ Async support for responsive interactions

Requirements

• Python 3.11+
• openai-agents
• prompt-toolkit
• rich

Development

The package follows Python packaging best practices with a src/ layout for clean imports and development workflows.

Setup for Development

1. Clone the repository:

   git clone https://github.com/yourusername/agent-repl-chat.git
   cd agent-repl-chat
   

2. Install in development mode:

   uv pip install -e .
   

3. Run the example:

   uv run example.py
   

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

v0.1.1 (2025-01-03)

• Updated README example to use gpt-4.1-mini model
• Enhanced project metadata and documentation

v0.1.0 (2025-01-03)

• Initial release
• Beautiful terminal chat interface
• Rich markdown support
• Conversation continuity
• Interactive commands (quit, new chat)
• Async support for responsive interactions