Metadata-Version: 2.4
Name: grafi-dev
Version: 0.0.3
Summary: Run a grafi Assistant locally with a live workflow graph & trace viewer
Author-email: Craig Li <craig@binome.dev>
Requires-Python: <3.13,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.115.12
Requires-Dist: grafi>=0.0.12
Requires-Dist: typer>=0.15.3
Requires-Dist: uvicorn>=0.34.2
Dynamic: license-file

# Graphite Dev

Graphite Dev provides a local assistant runtime with visual workflow tracing. The tool must be executed from the project root directory to function properly.

## Installation

```bash
pip install grafi-dev
```

## Usage

```bash
grafi-dev <path to your assistant instance>
```

Or run from source:

```bash
python -m grafi_dev.cli <path to your assistant instance>
```

This will automatically open a webpage displaying the Graphite interface.

![starting_age](/assets/start_page.png)

The highlighted components show the main interface elements:

**Header**: Displays the current conversation ID and assistant request ID, with a "New Conversation" button to start fresh sessions.

**Main Panel**:

- **Left**: Visual workflow representation showing the execution flow
- **Right**: Detailed information including events, conversation data, and flow history
  - **Info Tab**: Shows the detailed information of the workflow or selected components
  - **Event Tab**: Shows all the event of the workflow or selected components
  - **History Tab**: Shows complete conversation history across all assistant request IDs.

**Message Input**: Located at the bottom, allows you to send messages directly to the Graphite assistant.

![demo-gif](/assets/grafi-dev-demo.gif)

## Feature

- Run any assistant and inspect its workflow in the browser
- Live node execution and event trace
- Interactive web UI for reviewing conversations and workflow details

## Development

To start the server from source

```bash
python -m grafi_dev.cli <path to your assistant instance>
```

This launches a FastAPI server with uvicorn and opens the UI.

## Support

For questions or fixes, refer to the source code, tests, and issues.
Contributions via pull requests are welcome.
