Metadata-Version: 2.4
Name: devqubit-ui
Version: 0.1.1
Summary: Web interface for devqubit experiment tracking
Author: devqubit
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: devqubit,experiment-tracking,fastapi,web-ui
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Requires-Python: <3.14,>=3.11
Requires-Dist: devqubit-engine<0.2.0,>=0.1.1
Requires-Dist: fastapi>=0.128.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: uvicorn[standard]>=0.40.0
Description-Content-Type: text/markdown

# devqubit-ui

Web UI for devqubit experiment tracking. Browse runs, view artifacts, and compare experiments in a local web interface.

## Installation

```bash
pip install devqubit-ui
```

Or via the meta-package:

```bash
pip install devqubit[ui]
```

## Usage

### From CLI

```bash
devqubit ui
devqubit ui --port 9000
devqubit ui --workspace /path/to/.devqubit
```

### From Python

```python
from devqubit import run_server

run_server(port=8080)
```

## Features

- **Run browser** — List, filter, search runs with live HTMX updates
- **Run details** — Parameters, metrics, tags, artifacts
- **Artifact viewer** — View JSON/text; large files (>2MB) download-only
- **Diff view** — Compare runs side-by-side with TVD analysis
- **Projects & groups** — Organize and navigate experiments
- **REST API** — JSON endpoints at `/api/*` for programmatic access
- **Plugin system** — Extend UI via entry points

## Production
```bash
uvicorn devqubit_ui.app:create_app --factory --host 0.0.0.0 --port 8080
```

## License

Apache 2.0
