Metadata-Version: 2.4
Name: pixelhelm
Version: 0.1.0
Summary: Offline-first verified evidence-brief engine for frontend design: the portable research engine plus PixelHelm's design adapter.
Author: Rahul Krishna
License-Expression: MIT
Keywords: design,frontend,evidence,research,claim-verification,accessibility
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: live
Requires-Dist: anthropic; extra == "live"
Dynamic: license-file

# pixelhelm

The Python-side distribution of **PixelHelm**, the frontend-design capability
family. It ships the portable, offline-capable **verified-evidence-brief
engine** and PixelHelm's **design adapter**: given a design subject and a
source corpus, non-overlapping perspectives interrogate it, an expert answers
grounded only in fetched sources, every load-bearing inference is surfaced as
a typed claim, each claim is verified at the claim level, and the output is a
cited, confidence-labeled design **brief** that abstains honestly when
evidence is thin. It produces briefs, not UI.

## Install

```
pip install pixelhelm          # offline engine + adapter (standard library only)
pip install pixelhelm[live]    # optional live model adapter
```

## Use

```python
from pixelhelm import (
    DesignFramework, DesignRetrieval, DesignGate, DesignVerify,
    DesignInterrogator, DesignExpert, DesignInferenceSurfacer,
    DesignLLM, Ledger, StormDesignProvider,
)
```

The deterministic offline stubs (no network, no credentials) are in
`design_adapter.stubs`; the live path uses the optional `anthropic` dependency
and standard SDK credential resolution.

## Scope

This package contains exactly the PixelHelm functionality that runs standalone:
the engine packages `storm_engine` (imported verbatim from its upstream
project) and `design_adapter`, re-exported under `pixelhelm`. The Claude Code
plugin editions, the deterministic eval suite, and the ChoiceGate admission
consumer live in the PixelHelm repository because they require the repository
tree or externally accepted local roots.

MIT licensed. Built by Rahul Krishna.
