Metadata-Version: 2.4
Name: llm-webchat
Version: 1.0.0
Summary: A web chat interface plugin for llm
Project-URL: Homepage, https://github.com/imbue-ai/llm-webchat
Project-URL: Repository, https://github.com/imbue-ai/llm-webchat
Project-URL: Issues, https://github.com/imbue-ai/llm-webchat/issues
Project-URL: Changelog, https://github.com/imbue-ai/llm-webchat/releases
Author-email: Hynek Urban <hynek@imbue.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: fastapi>=0.115
Requires-Dist: llm>=0.28
Requires-Dist: pluggy>=1.5
Requires-Dist: pydantic-settings>=2.13.1
Requires-Dist: sqlite-utils>=3.39
Requires-Dist: starlette>=0.45
Requires-Dist: uvicorn>=0.34
Description-Content-Type: text/markdown

# LLM Webchat

A plugin for the [LLM](https://github.com/simonw/llm) tool.
When installed, running `llm webchat` starts a local webserver.
Visiting its address in the browser lets you see the
conversations in your `llm` database and chat with supported
language models.

The appearance and functionality of `llm-webchat` is heavily
customizable - styles, frontend appearance and behavior and even
the backend logic.

## Quickstart

```bash
llm install llm-webchat
llm webchat
```

## Development

### Prerequisites

- Python 3.10+ with [uv](https://github.com/astral-sh/uv)
- Node.js 18+

### Building and running

Build the frontend (output goes to `src/llm_webchat/static/`):

```bash
cd frontend
npm install
npm run build
```

Run the backend (serves the built frontend at `/`):

```bash
uv run llm-webchat
```

For frontend development with hot reload (proxies `/api` requests to the backend):

```bash
cd frontend
npm run dev
```

### Running tests

```bash
uv run pytest
cd frontend
npm test
```
