agent-repl-chat


Nameagent-repl-chat JSON
Version 0.2.0 PyPI version JSON
download
home_pageNone
SummaryA beautiful terminal chat interface for OpenAI agents and DSPy Modules
upload_time2025-07-10 13:20:05
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT
keywords agents chat cli dspy openai repl terminal
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # agent-repl-chat

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

## Installation

Install from PyPI:

```bash
pip install agent-repl-chat
```

Or install in development mode using uv:

```bash
uv pip install -e .
```

## Usage

```python
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:
   ```bash
   git clone https://github.com/yourusername/agent-repl-chat.git
   cd agent-repl-chat
   ```

2. Install in development mode:
   ```bash
   uv pip install -e .
   ```

3. Run the example:
   ```bash
   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](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 
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "agent-repl-chat",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "agents, chat, cli, dspy, openai, repl, terminal",
    "author": null,
    "author_email": "Facundo Goiriz <facundogoiriz@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/92/57/da3b357502c9a730b6c48337c336762f710760f81538ece5a2130bb5faab/agent_repl_chat-0.2.0.tar.gz",
    "platform": null,
    "description": "# agent-repl-chat\n\nA beautiful terminal chat interface for OpenAI agents with rich markdown support and an elegant UI.\n\n## Installation\n\nInstall from PyPI:\n\n```bash\npip install agent-repl-chat\n```\n\nOr install in development mode using uv:\n\n```bash\nuv pip install -e .\n```\n\n## Usage\n\n```python\nfrom repl_chat import start_chat\nfrom agents import Agent\n\n# Create your agent\nagent = Agent(\n    name=\"My Assistant\",\n    instructions=\"You are a helpful assistant that provides clear and concise answers.\",\n    model=\"gpt-4.1-mini\"\n)\n\n# Start the chat interface\nstart_chat(agent)\n```\n\n## Features\n\n- \ud83c\udfa8 Beautiful terminal interface with rich markdown rendering\n- \ud83d\udd04 Conversation continuity with response threading\n- \u2328\ufe0f Interactive commands:\n  - `q`, `quit`, or `exit` - Quit the chat\n  - `n` or `new` - Start a new conversation\n- \ud83e\udd16 Works with any OpenAI Agent configuration\n- \u26a1 Async support for responsive interactions\n\n## Requirements\n\n- Python 3.11+\n- openai-agents\n- prompt-toolkit\n- rich\n\n## Development\n\nThe package follows Python packaging best practices with a `src/` layout for clean imports and development workflows.\n\n### Setup for Development\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/agent-repl-chat.git\n   cd agent-repl-chat\n   ```\n\n2. Install in development mode:\n   ```bash\n   uv pip install -e .\n   ```\n\n3. Run the example:\n   ```bash\n   uv run example.py\n   ```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Changelog\n\n### v0.1.1 (2025-01-03)\n- Updated README example to use `gpt-4.1-mini` model\n- Enhanced project metadata and documentation\n\n### v0.1.0 (2025-01-03)\n- Initial release\n- Beautiful terminal chat interface\n- Rich markdown support\n- Conversation continuity\n- Interactive commands (quit, new chat)\n- Async support for responsive interactions ",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A beautiful terminal chat interface for OpenAI agents and DSPy Modules",
    "version": "0.2.0",
    "project_urls": null,
    "split_keywords": [
        "agents",
        " chat",
        " cli",
        " dspy",
        " openai",
        " repl",
        " terminal"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "bb720eca23486a094be1fddd4930b90ea0e08495e6e21b99e974941258c96082",
                "md5": "95e34863328a37a3ae1159cbdd88eae8",
                "sha256": "ad737080a9ac014ef38d0b0286e07e20c0163c722cd233ef6269da8cf79da2ab"
            },
            "downloads": -1,
            "filename": "agent_repl_chat-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "95e34863328a37a3ae1159cbdd88eae8",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 5840,
            "upload_time": "2025-07-10T13:20:04",
            "upload_time_iso_8601": "2025-07-10T13:20:04.493552Z",
            "url": "https://files.pythonhosted.org/packages/bb/72/0eca23486a094be1fddd4930b90ea0e08495e6e21b99e974941258c96082/agent_repl_chat-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9257da3b357502c9a730b6c48337c336762f710760f81538ece5a2130bb5faab",
                "md5": "93bb95e928c9295d0855cf68f4b98211",
                "sha256": "0e391132e0f0e34203cfbd19314429e8b6a962c309ea492cb973562d1cbcfd86"
            },
            "downloads": -1,
            "filename": "agent_repl_chat-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "93bb95e928c9295d0855cf68f4b98211",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 110957,
            "upload_time": "2025-07-10T13:20:05",
            "upload_time_iso_8601": "2025-07-10T13:20:05.800503Z",
            "url": "https://files.pythonhosted.org/packages/92/57/da3b357502c9a730b6c48337c336762f710760f81538ece5a2130bb5faab/agent_repl_chat-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-10 13:20:05",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "agent-repl-chat"
}
        
Elapsed time: 0.60933s