Metadata-Version: 2.4
Name: praisonai-ui
Version: 1.3.0rc2
Summary: Modern AI Agent Chat Interface for PraisonAI
License: Apache-2.0 license
Keywords: LLM,Agents,gen ai,chat ui,chatbot ui,openai,copilot,langchain,conversational ai,praisonai,multi-agent
Author: praison
Requires-Python: >=3.9,<4.0.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: aiofiles (>=23.1.0,<24.0.0)
Requires-Dist: asyncer (>=0.0.7,<0.0.8)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: dataclasses_json (>=0.6.7,<0.7.0)
Requires-Dist: fastapi (>=0.110.1,<0.113)
Requires-Dist: filetype (>=1.2.0,<2.0.0)
Requires-Dist: httpx (>=0.23.0)
Requires-Dist: lazify (>=0.4.0,<0.5.0)
Requires-Dist: literalai (==0.0.623)
Requires-Dist: nest-asyncio (>=1.6.0,<2.0.0)
Requires-Dist: numpy (>=1.26,<2.0)
Requires-Dist: packaging (>=23.1,<24.0)
Requires-Dist: pydantic (>=1,<3)
Requires-Dist: pyjwt (>=2.8.0,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
Requires-Dist: python-multipart (>=0.0.9,<0.0.10)
Requires-Dist: python-socketio (>=5.11.0,<6.0.0)
Requires-Dist: starlette (>=0.37.2,<0.38.0)
Requires-Dist: syncer (>=2.0.3,<3.0.0)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Requires-Dist: uptrace (>=1.22.0,<2.0.0)
Requires-Dist: uvicorn (>=0.25.0,<0.26.0)
Requires-Dist: watchfiles (>=0.20.0,<0.21.0)
Project-URL: Repository, https://github.com/MervinPraison/PraisonAI-UI
Description-Content-Type: text/markdown

# PraisonAI UI

**Modern AI Agent Interface for PraisonAI**

[![PyPI - Downloads](https://img.shields.io/pypi/dm/praisonai-ui)](https://pypi.org/project/praisonai-ui/)
[![GitHub Contributors](https://img.shields.io/github/contributors/MervinPraison/PraisonAI-UI)](https://github.com/MervinPraison/PraisonAI-UI/graphs/contributors)

PraisonAI UI is a powerful, modern chat interface designed for AI agent interactions. Built for the [PraisonAI](https://github.com/MervinPraison/PraisonAI) multi-agent framework.

## Features

- **Multi-Agent Support** - Seamlessly interact with multiple AI agents
- **Tool Call Visualization** - See agent tool calls and their results in real-time
- **Streaming Responses** - Real-time streaming of agent responses
- **Session Management** - Persistent sessions with history
- **Run Timeline** - Visual timeline of agent runs and traces
- **Modern UI** - Clean, responsive interface built with React

## Installation

```sh
pip install praisonai-ui
praisonai run app.py
```

Or run directly:

```sh
praisonai run app.py -w
```

## Quick Start

### With PraisonAI Agents

```python
from praisonaiagents import Agent
from praisonai.chat import start_chat_server

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant."
)

# Start the chat UI with your agent
start_chat_server(agent=agent, port=8000)
```

### Standalone Mode

```sh
praisonai chat
```

This starts the chat interface at `http://localhost:8000`.

## Key Features

- **Multi Modal chats** - Support for text, images, and files
- **Chain of Thought visualization** - See agent reasoning steps
- **Data persistence** - Save and restore chat sessions
- **Authentication** - Built-in auth support
- **Tool Integration** - Visualize tool calls and results

## Integration with PraisonAI

PraisonAI UI integrates seamlessly with the PraisonAI agent framework:

```python
from praisonaiagents import Agent, Task, PraisonAIAgents

# Define your agents
researcher = Agent(name="Researcher", role="Research specialist")
writer = Agent(name="Writer", role="Content writer")

# Create tasks
research_task = Task(description="Research the topic", agent=researcher)
write_task = Task(description="Write the article", agent=writer)

# Run with chat UI
agents = PraisonAIAgents(agents=[researcher, writer], tasks=[research_task, write_task])
```

## Documentation

Full documentation is available at [docs.praison.ai](https://docs.praison.ai).

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](.github/CONTRIBUTING.md) for guidelines.

## License

This project is licensed under the [Apache 2.0](LICENSE) license.

**Based on [Chainlit](https://github.com/Chainlit/chainlit)** - An open-source async Python framework for building conversational AI applications.

