Metadata-Version: 2.5
Name: hackagent-webui
Version: 0.2.0
Summary: Prebuilt HackAgent dashboard served by the hackagent CLI.
Project-URL: Homepage, https://hackagent.dev
Project-URL: Source, https://github.com/AISecurityLab/hackagent-webapp
Author-email: AI Security Lab <ais@ai4i.it>
License: Apache-2.0
Keywords: dashboard,hackagent,security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# hackagent-webui

The prebuilt [HackAgent](https://hackagent.dev) dashboard, packaged for Python.

This package contains only static assets — the compiled web application — plus a
single helper that returns their location. The [`hackagent`](https://pypi.org/project/hackagent/)
CLI serves them locally with `hackagent web`.

## Installation

Install it through the CLI's extra, which keeps the two versions compatible:

```bash
pip install 'hackagent[web]'
```

Installing `hackagent-webui` on its own does nothing useful: it ships no server.

## Usage

```python
from hackagent_webui import bundle_path, bundle_version

bundle_path()      # Path to the directory of static files
bundle_version()   # Version of the bundled dashboard
```

## Building

The bundle is generated from the [hackagent-webapp](https://github.com/AISecurityLab/hackagent-webapp)
sources; this directory holds no hand-written assets.

```bash
npm ci
npm run build:community          # writes out/
node scripts/package-python.mjs  # copies out/ here and stamps the version
cd packaging/python && python -m build
```

## Licence

Apache-2.0
