hyperweave
by InnerAura
README.md
<div id="top">
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/banners/hw-banner-adaptive.svg" alt="HyperWeave Hero" width="100%"/>
</p>
<!--
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/banners/hw-banner-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/banners/hw-banner-dark.svg" alt="Logo" width="100%"
>
</picture>
</p>
-->
<!--
<p align="center">
<strong>
The artifact layer for agent-human representations.
</strong>
<br/>
One API call, one SVG. No JavaScript. Works everywhere.
</p>
-->
<p align="center">
<strong>The Visual CLI for agents</strong>
<br />
<br />
<em>
<a href="#HTTP-API"><img src="./assets/glyphs/readme.entry-points.http.svg" height="18" alt="" align="absmiddle" /> API</a> · 
<a href="#CLI"><img src="./assets/glyphs/readme.entry-points.cli.svg" height="18" alt="" align="absmiddle" /> CLI</a> · 
<a href="#MCP"><img src="./assets/glyphs/readme.entry-points.mcp.svg" height="18" alt="" align="absmiddle" /> MCP</a> · 
<a href="SKILL.md"><img src="./assets/glyphs/readme.entry-points.markdown.svg" height="18" alt="" align="absmiddle" /> SKILL.md</a>
</em>
</p>
<!--
<p align="center">
<img src="https://hyperweave.app/v1/badge/STARS/primer.static?data=gh:InnerAura/hyperweave.stars&variant=noir" alt="stars"/>
<img src="https://hyperweave.app/v1/badge/FORKS/primer.static?data=gh:InnerAura/hyperweave.forks&variant=noir" alt="forks"/>
<img src="https://hyperweave.app/v1/badge/VERSION/primer.static?data=pypi:hyperweave.version&variant=noir" alt="version"/>
<img src="https://hyperweave.app/v1/badge/LICENSE/primer.static?data=gh:InnerAura/hyperweave.license&variant=noir&glyph=check" alt="license"/>
<img src="https://hyperweave.app/v1/badge/PYTHON/primer.static?data=pypi:hyperweave.python_requires&variant=noir" alt="python"/>
</p>
-->
<p align="center">
<img src="https://hyperweave.app/v1/strip/hyperweave/primer.static?data=gh:InnerAura/hyperweave.build,pypi:hyperweave.version,gh:InnerAura/hyperweave.license&glyph=hyperweave&variant=porcelain"
alt="build, version, license, python"/>
</p>
---
## What Is HyperWeave
HyperWeave is a visual CLI for agents. Structured spec in, deterministic SVG out. Artifact classes include **diagrams**, **charts**, **tables**, and more. Each SVG is self-contained, with layout, theme, and machine-readable metadata compiled into the file.
**<img src="./assets/glyphs/readme.glyph.exclamation-alt.svg" width="24" height="24" alt="" align="absmiddle"/> Why It Exists**
Humans can't keep pace with the volume of text agents produce. Pictures are the obvious fix, and every picture format gives something up. **Markdown** is portable but flat. **HTML** is expressive but fragile. **Raster images** travel well but discard their structure. **Model output** is flexible but never twice the same.
A HyperWeave artifact carries its own spec, so the thing your agent drew is the thing your agent can read back. Useful as:
- **Chained steps:** one agent's output is the next one's typed input.
- **Memory:** a committed artifact is durable state that survives the context window.
- **Diffs:** compare two artifacts semantically, not pixel by pixel.
- **Audit:** the spec, its provenance, and its mutation lineage travel with the image.
The picture is the record.
**<img src="./assets/glyphs/readme.glyph.zero-js.svg" width="24" height="24" alt="" align="absmiddle"/> Philosophy**
- Zero JavaScript.
- No runtime.
- No dependencies.
- One file, one request.
- Renders anywhere an `<img>` tag does.
**<img src="./assets/glyphs/readme.glyph.magnify.svg" width="24" height="24" alt="" align="absmiddle"/> Artifact Format Comparison**
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/tables/format-comparison.light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/tables/format-comparison.dark.svg" alt="Format comparison: SVG scores 4.5 of 5, Markdown 3.0, HTML 2.5, across portability, agent-readable metadata, visual fidelity, token efficiency, and zero dependencies." width="100%">
</picture>
</p>
<details>
<summary>View as <code>markdown table</code></summary>
<br/>
| FORMAT | Portability | Agent-Readable Metadata | Visual Fidelity | Token Efficiency | Zero Dependencies | SCORE |
|:---|:---:|:---:|:---:|:---:|:---:|:---:|
| **SVG** | ✓ | ✓ | ✓ | ~ | ✓ | **4.5** |
| Markdown | ~ | ~ | ✗ | ✓ | ✓ | 3.0 |
| HTML | ✗ | ✓ | ✓ | ✗ | ~ | 2.5 |
✓ full · ~ partial · ✗ none
</details>
---
## Artifact Classes
### Diagrams
Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: `pipeline`, `fanout`, `fanin`, `hub`, `cycle`, `loop`, `dag`, `lanes`, `state-machine`, `sequence`, `tree`, and `comparison`. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/provider-router-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/provider-router-dark.svg" alt="One call, best model: a model router fans out to Claude, Gemini, OpenAI, DeepSeek, Kimi, and Qwen, each door labelled with the capability it is routed for" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file /dev/stdin -g primer --variant porcelain --surface inlay --face light -o provider-router-light.svg <<'JSON'
{
"topology": "fanout",
"orientation": "horizontal",
"title": "One call, best model",
"subtitle": "Fanout · horizontal",
"zones": ["router", "providers"],
"node_style": "card+glyph",
"glyph_tint": "full",
"nodes": [
{ "id": "router", "label": "model router", "desc": "1 call, best model\ncapability-routed", "role": "hero", "kind": "router", "gather": true },
{ "id": "claude", "label": "Claude", "desc": "long-context", "glyph": "anthropic" },
{ "id": "gemini", "label": "Gemini", "desc": "multimodal", "glyph": "gemini" },
{ "id": "openai", "label": "OpenAI", "desc": "tool-use", "glyph": "openai" },
{ "id": "deepseek", "label": "DeepSeek", "desc": "reasoning", "glyph": "deepseek" },
{ "id": "kimi", "label": "Kimi", "desc": "agentic", "glyph": "kimi" },
{ "id": "qwen", "label": "Qwen", "desc": "multilingual", "glyph": "qwen" }
],
"edges": [
{ "source": "router", "target": "claude", "label": "route", "label_style": "chip", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "gemini", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "openai", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "deepseek", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "kimi", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "qwen", "relation": "drift", "marker": "arrow" }
]
}
JSON
```
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/broadcast-split-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/broadcast-split-dark.svg" alt="Two feeds in, three surfaces out: a spec and live connector data arrive on the left of one HyperWeave artifact, which fans out to a GitHub README, a Slack unfurl, and an agent reading the payload" width="90%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave extract broadcast-split-light.svg --respond payload > broadcast-split.json
hyperweave compose diagram --spec-file broadcast-split.json -g primer --variant porcelain --surface inlay --face light -o broadcast-split-light.svg
```
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/compose-gate-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/compose-gate-dark.svg" alt="Every request in, every artifact out: Claude Code, Codex, and MCP call the compose engine from the left; GitHub, Slack, and Obsidian receive the artifacts on the right" width="90%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave extract compose-gate-light.svg --respond payload > compose-gate.json
hyperweave compose diagram --spec-file compose-gate.json -g primer --variant porcelain --surface inlay --face light -o compose-gate-light.svg
```
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/mcp-gateway-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/mcp-gateway-dark.svg" alt="MCP gateway: Claude Code as MCP host, through an MCP gateway, to the hyperweave MCP server, with request and response drawn as two lanes" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file pipeline-row -g primer --variant space --surface inlay --face light -o mcp-gateway-light.svg
```
`pipeline-row` is a bundled preset; the URL API renders it by name at `/v1/diagram/pipeline-row/primer.static`.
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/verbs-mouth-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/verbs-mouth-dark.svg" alt="Six verbs, one mouth: compose writes into the artifact and transform writes out, while extract, verify, diff, and query bundle into a single read gathered at the artifact's face" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave extract verbs-mouth-light.svg --respond payload > verbs-mouth.json
hyperweave compose diagram --spec-file verbs-mouth.json -g primer --variant porcelain --surface inlay --face light -o verbs-mouth-light.svg
```
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/frontier-serving-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/frontier-serving-dark.svg" alt="Frontier serving DAG: requests through one OpenRouter key to Anthropic, OpenAI, and Gemini, all sharing a Redis cache, with telemetry skipping the ranks to Grafana" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file dag-providers -g primer --variant noir --surface inlay --face light -o frontier-serving-light.svg
```
`dag-providers` is a bundled preset; the URL API renders it by name at `/v1/diagram/dag-providers/primer.static`.
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/cycle-flow-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/cycle-flow-dark.svg" alt="The data flywheel: Generate, Distribute, Capture, and Improve seated on a dashed ring around a hero that compounds each turn" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file cycle-flow -g primer --variant porcelain --surface inlay --face light -o cycle-flow-light.svg
```
`cycle-flow` is a bundled preset; the URL API renders it by name at `/v1/diagram/cycle-flow/primer.static`.
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-dark.svg" alt="One turn of the loop, performed: change, measure, keep or revert — guard chips inside the Stop? holder decide whether the loop returns or the champion ships" width="70%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file loop-hillclimb-turn -g primer --variant porcelain --surface inlay --face light -o loop-hillclimb-turn-light.svg
```
`loop-hillclimb-turn` is a bundled preset; the URL API renders it by name at `/v1/diagram/loop-hillclimb-turn/primer.static`.
</details>
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-dark.svg" alt="Dependency audit tree: my-app roots direct dependencies react, lodash, and axios, transitive children hang on dashed edges, and health dots flag what is outdated or vulnerable" width="100%"
>
</picture>
</p>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose diagram --spec-file tree-health -g primer --variant porcelain --surface inlay --face light -o tree-health-light.svg
```
`tree-health` is a bundled preset; the URL API renders it by name at `/v1/diagram/tree-health/primer.static`.
</details>
### Pick a layout
| | | |
|:---|:---|:---|
| **Flows** | `pipeline` · `fanout` · `fanin` | stages in a line, one-to-many, many-to-one |
| **Cycles** | `cycle` · `loop` · `state-machine` | a closed ring, a procedural loop with exits, legal state transitions |
| **Structure** | `dag` · `tree` · `lanes` | dependencies, hierarchy, ownership rows |
| **Centered** | `hub` | one thing at the middle of its world |
| **Time** | `sequence` | who calls whom, in order |
| **Side by side** | `comparison` | two options on one sheet |
Twelve layouts, fifty-nine bundled presets, one spec vocabulary. Variations are values of `orientation`, not layouts of their own:
| | |
|:---|:---|
| `dag` · `pipeline` | `horizontal` · `vertical` |
| `fanout` | `horizontal` · `bilateral` · `upward` · `downward` · `radial` |
| `tree` | `horizontal` · `radial` |
| `cycle` | `ring` · `orbit` |
| `loop` | `vertical` · `horizontal` |
| `fanin` · `hub` · `lanes` · `sequence` · `state-machine` · `comparison` | `horizontal` |
Render any preset by name at `/v1/diagram/{preset}/primer.static`, or run `hyperweave discover diagram` for every preset, orientation and field.
---
<!-- ## Charts -->
### Matrices
HyperWeave matrices are structured tables rendered as portable SVGs. A single JSON description can produce `comparison grids`, `registries`, `tiers`, `benchmark tables`, `heatmaps`, `chips`, `glyphs`, `bars`, and `status maps`, while carrying a machine-readable payload for agents.
<p align="center">
<img src="https://hyperweave.app/v1/matrix/custom/primer.static?variant=porcelain&spec=eyJ0aXRsZSI6Ik9uZSBhcnRpZmFjdC4gTWFueSByZWFkZXJzLiIsInN1YnRpdGxlIjoiaG93IGVhY2ggY29uc3VtZXIgaW5nZXN0cyB0aGUgc2FtZSBTVkciLCJjb2x1bW5zIjpbeyJpZCI6InJlYWRlciIsImxhYmVsIjoiUkVBREVSIiwicm9sZSI6ImxhYmVsIn0seyJpZCI6Im1hcmsiLCJsYWJlbCI6IiIsImtpbmQiOiJnbHlwaCIsImdseXBoX3RpbnQiOiJmdWxsIn0seyJpZCI6InBpeGVscyIsImxhYmVsIjoiUElYRUxTIiwia2luZCI6ImNoZWNrIn0seyJpZCI6Im1vdGlvbiIsImxhYmVsIjoiTU9USU9OIiwia2luZCI6InBpbGwifSx7ImlkIjoidmlhIiwibGFiZWwiOiJSRUFEUyBWSUEiLCJraW5kIjoiY2hpcCJ9XSwicm93cyI6W3sibGFiZWwiOiJHaXRIdWIgUkVBRE1FIiwiY2VsbHMiOlt7ImdseXBoIjoiZ2l0aHViIn0seyJzdGF0ZSI6ImZ1bGwifSx7InN0YXRlIjoib24ifSx7ImNoaXBzIjpbImNhbW8iLCJjc3MgYW5pbWF0aW9uIl19XX0seyJsYWJlbCI6IlZTIENvZGUgcHJldmlldyIsImNlbGxzIjpbeyJnbHlwaCI6InZzY29kZSJ9LHsic3RhdGUiOiJmdWxsIn0seyJzdGF0ZSI6Im9uIn0seyJjaGlwcyI6WyJtYXJrZG93biBwcmV2aWV3Il19XX0seyJsYWJlbCI6IlNsYWNrIHVuZnVybCIsImNlbGxzIjpbeyJnbHlwaCI6InNsYWNrIn0seyJzdGF0ZSI6InBhcnRpYWwifSx7InN0YXRlIjoib2ZmIn0seyJjaGlwcyI6WyJpbWFnZSBwcm94eSJdfV19LHsibGFiZWwiOiJHbWFpbCBib2R5IiwiY2VsbHMiOlt7ImdseXBoIjoiZ21haWwifSx7InN0YXRlIjoicGFydGlhbCJ9LHsic3RhdGUiOiJvZmYifSx7ImNoaXBzIjpbImltZyB0YWciXX1dfSx7ImxhYmVsIjoiQWdlbnQiLCJjZWxscyI6W3siZ2x5cGgiOiJtY3AifSx7InN0YXRlIjoibm9uZSJ9LHsic3RhdGUiOiJvZmYifSx7ImNoaXBzIjpbImh3OnBheWxvYWQiLCJod3ovMSIsIm1hcmtkb3duIHR3aW4iXX1dfV0sIm5vdGVzIjoicGl4ZWxzIGZvciBodW1hbnMgwrcgaHc6cGF5bG9hZCBmb3IgYWdlbnRzIn0&v=4" alt="comparison matrix: how GitHub, VS Code, Slack, Gmail, and AI agents each ingest the same SVG" width="100%"/>
</p>
<p align="center"><sub>One frame, every table · generated, not drawn</sub></p>
<details>
<summary>View as table</summary>
| READER | | PIXELS | MOTION | READS VIA |
|:---|:---:|:---:|:---:|:---|
| GitHub README | github | ✓ | Yes | camo, css animation |
| VS Code preview | vscode | ✓ | Yes | markdown preview |
| Slack unfurl | slack | ~ | - | image proxy |
| Gmail body | gmail | ~ | - | img tag |
| Agent | mcp | ✗ | - | hw:payload, hwz/1, markdown twin |
</details>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose matrix --spec-file /dev/stdin -g primer --variant porcelain -o one-artifact.svg <<'JSON'
{
"title": "One artifact. Many readers.",
"subtitle": "how each consumer ingests the same SVG",
"columns": [
{
"id": "reader",
"label": "READER",
"role": "label"
},
{
"id": "mark",
"label": "",
"kind": "glyph",
"glyph_tint": "full"
},
{
"id": "pixels",
"label": "PIXELS",
"kind": "check"
},
{
"id": "motion",
"label": "MOTION",
"kind": "pill"
},
{
"id": "via",
"label": "READS VIA",
"kind": "chip"
}
],
"rows": [
{
"label": "GitHub README",
"cells": [
{
"glyph": "github"
},
{
"state": "full"
},
{
"state": "on"
},
{
"chips": [
"camo",
"css animation"
]
}
]
},
{
"label": "VS Code preview",
"cells": [
{
"glyph": "vscode"
},
{
"state": "full"
},
{
"state": "on"
},
{
"chips": [
"markdown preview"
]
}
]
},
{
"label": "Slack unfurl",
"cells": [
{
"glyph": "slack"
},
{
"state": "partial"
},
{
"state": "off"
},
{
"chips": [
"image proxy"
]
}
]
},
{
"label": "Gmail body",
"cells": [
{
"glyph": "gmail"
},
{
"state": "partial"
},
{
"state": "off"
},
{
"chips": [
"img tag"
]
}
]
},
{
"label": "Agent",
"cells": [
{
"glyph": "mcp"
},
{
"state": "none"
},
{
"state": "off"
},
{
"chips": [
"hw:payload",
"hwz/1",
"markdown twin"
]
}
]
}
],
"notes": "pixels for humans · hw:payload for agents"
}
JSON
```
</details>
```bash
# Connectors preset
https://hyperweave.app/v1/matrix/connectors/primer.static?variant=porcelain
# Any table, one URL: base64url MatrixSpec JSON (8 KB cap)
https://hyperweave.app/v1/matrix/custom/primer.static?spec=<base64url>
# CLI, with the markdown twin alongside
hyperweave compose matrix --spec-file table.json -g primer --variant porcelain --markdown-out table.md
```
Another matrix configuration for visualizing benchmarks:
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/matrices/frontier-benchmarks-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/matrices/frontier-benchmarks-dark.svg" alt="Frontier vs open-weights models compared on SWE-bench Verified coding score against input and output token price, June 2026" width="100%"
>
</picture>
</p>
<details>
<summary>View as table</summary>
| MODEL | | SWE-bench Verified | INPUT (per Mtok) | OUTPUT (per Mtok) |
|:---|:---:|:---:|:---:|:---:|
| **FRONTIER · CLOSED WEIGHTS** | | | | |
| Claude Fable 5 | anthropic | 95 % | $10 | $50 |
| Claude Opus 4.8 | anthropic | 88.6 % | $5 | $25 |
| GPT-5.5 | openai | 82.6 % | $5 | $30 |
| Gemini 3.1 Pro | gemini | 80.6 % | $2 | $12 |
| **OPEN WEIGHTS** | | | | |
| DeepSeek V4-Pro | deepseek | 80.6 % | $0.44 | $0.87 |
| Kimi K2.6 | kimi | 80.2 % | $0.95 | $4 |
| GLM-5 | zai | 77.8 % | $1 | $3.2 |
| Mistral Medium 3.5 | mistral | 77.6 % | $1.5 | $7.5 |
*SWE-bench Verified % · USD per Mtok · current flagships, jun 2026 · sources: vals.ai · artificialanalysis.ai · model cards*
</details>
<details>
<summary>Compose this inline</summary>
```bash
hyperweave compose matrix --spec-file /dev/stdin -g primer --variant cream --surface twin --faces -o frontier-benchmarks.svg <<'JSON'
{
"title": "Frontier vs Open",
"subtitle": "coding & price · SWE-bench Verified against price per million tokens · current flagships, jun 2026",
"columns": [
{
"id": "model",
"label": "MODEL",
"kind": "text",
"align": "left",
"role": "label"
},
{
"id": "mark",
"label": "",
"kind": "glyph",
"align": "center",
"glyph_tint": "full"
},
{
"id": "swe",
"label": "SWE-bench Verified",
"kind": "numeric",
"align": "center",
"polarity": "higher",
"unit": "%"
},
{
"id": "pin",
"label": "INPUT",
"sublabel": "per Mtok",
"kind": "numeric",
"align": "center",
"polarity": "lower",
"unit": "$"
},
{
"id": "pout",
"label": "OUTPUT",
"sublabel": "per Mtok",
"kind": "numeric",
"align": "center",
"polarity": "lower",
"unit": "$"
}
],
"rows": [
{
"label": "Claude Fable 5",
"cells": [
{
"glyph": "anthropic"
},
{
"value": 95.0
},
{
"value": 10
},
{
"value": 50
}
],
"section": "FRONTIER · CLOSED WEIGHTS"
},
{
"label": "Claude Opus 4.8",
"cells": [
{
"glyph": "anthropic"
},
{
"value": 88.6
},
{
"value": 5
},
{
"value": 25
}
],
"section": "FRONTIER · CLOSED WEIGHTS"
},
{
"label": "GPT-5.5",
"cells": [
{
"glyph": "openai"
},
{
"value": 82.6
},
{
"value": 5
},
{
"value": 30
}
],
"section": "FRONTIER · CLOSED WEIGHTS"
},
{
"label": "Gemini 3.1 Pro",
"cells": [
{
"glyph": "gemini"
},
{
"value": 80.6
},
{
"value": 2
},
{
"value": 12
}
],
"section": "FRONTIER · CLOSED WEIGHTS"
},
{
"label": "DeepSeek V4-Pro",
"cells": [
{
"glyph": "deepseek"
},
{
"value": 80.6
},
{
"value": 0.44
},
{
"value": 0.87
}
],
"section": "OPEN WEIGHTS"
},
{
"label": "Kimi K2.6",
"cells": [
{
"glyph": "kimi"
},
{
"value": 80.2
},
{
"value": 0.95
},
{
"value": 4.0
}
],
"section": "OPEN WEIGHTS"
},
{
"label": "GLM-5",
"cells": [
{
"glyph": "zai"
},
{
"value": 77.8
},
{
"value": 1.0
},
{
"value": 3.2
}
],
"section": "OPEN WEIGHTS"
},
{
"label": "Mistral Medium 3.5",
"cells": [
{
"glyph": "mistral"
},
{
"value": 77.6
},
{
"value": 1.5
},
{
"value": 7.5
}
],
"section": "OPEN WEIGHTS"
}
],
"sections": [
"FRONTIER · CLOSED WEIGHTS",
"OPEN WEIGHTS"
],
"notes": "SWE-bench Verified % · USD per Mtok · current flagships, jun 2026 · sources: vals.ai · artificialanalysis.ai · model cards"
}
JSON
```
</details>
<br/>
[Inside every artifact](#inside-every-artifact)
- **Markdown twin:** every matrix has a GFM projection of the same table. `--markdown-out` on the CLI, `respond:"json"` over HTTP, `render_target="markdown"` over MCP.
---
### Receipts
Hyperweave parses agent session telemetry into a portable receipts that include model usage, tool calls stats, token spend, and context window visualization. Install the hook once and every session emits one:
```bash
uv tool install hyperweave # or: pip install hyperweave
hyperweave install-hook
```
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_cream.svg" alt="A HyperWeave session receipt for a Claude Code run: $1,787.28 across 1686.0M tokens and 3795 calls, opus-4.8 dominant, with a tool-spend breakdown, a cost-by-model bar, and a context-load curve." width="800"/>
</p>
<p align="center"><sub>Claude Code · $1,787.28 · 1686.0M tokens · 3795 calls · opus-4.8</sub></p>
<details>
<summary>View the Codex receipt</summary>
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_porcelain.svg" alt="A HyperWeave session receipt for a Codex run: $10.72 across 32.4M tokens and 346 calls, gpt-5.3." width="800"/>
</p>
<p align="center"><sub>Codex · $10.72 · 32.4M tokens · 346 calls · gpt-5.3</sub></p>
</details>
<details>
<summary>View the same session as a register receipt</summary>
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_raw.svg" alt="The same Claude Code session printed as a thermal register tape: tools as line items priced in tokens, models as payment tender, failed calls as voids." width="300"/>
</p>
<p align="center"><sub>The same Claude session if you fancy a proper receipt</sub></p>
</details>
The hook reads your session's JSONL transcript from disk and detects the harness automatically (Claude Code or Codex). Theme it with any of the [8 primer themes](#primer), or the paper receipt style above.
```bash
hyperweave install-hook --genome cream # any primer theme
hyperweave install-hook --genome raw # the paper receipt
```
<a href="https://github.com/InnerAura/hyperweave/issues/new"><img src="./assets/glyphs/readme.glyph.open-sign.porcelain.svg" alt="Open an issue" height="20" width="20" align="absmiddle" /> Open an issue</a> to request a missing agent harness.
---
## Inside Every Artifact
<!--
Agents should communicate through representations optimized for human cognition, not default prose.
structured input
↓
deterministic layout
↓
beautiful artifact
┌─────────────┐
human ─────────►│ │◄──────── agent
│ ARTIFACT │
human ◄─────────│ │────────► agent
└─────────────┘
│
extract / query / diff
transform / verify
representation should not disappear
after it has been shown.
↓
make it an operable artifact.
-->
Every HyperWeave artifact is a re-ingestible object, not just an image. It carries its full spec (`hw:payload`) and a hash-verified digest (`hwz/1` envelope), so an agent can work with it directly, never parsing pixels. Two tiers, two jobs. Here they are inside a diagram artifact:
**recreate & modify: the complete spec**
```xml
<hw:payload schema="diagram/1" media-type="application/json">
{
"spec": {
"title": "Service dependencies",
"subtitle": "Service dependencies · a gateway fans to domain services, each grounding on its store",
"topology": "dag",
"zones": ["subsystems"],
"nodes": [
{ "id": "web", "label": "web", "desc": "React SPA", "glyph": "react" },
{ "id": "gateway", "label": "API gateway", "role": "hero", "kind": "router" },
{ "id": "auth", "label": "Auth", "desc": "tokens", "kind": "shield" }
<!-- … 5 more nodes · lossless -->
],
"edges": [
{ "source": "web", "target": "gateway", "relation": "assert" },
{ "source": "gateway", "target": "auth", "relation": "assert" },
{ "source": "auth", "target": "postgres", "label": "reads", "label_style": "chip", "relation": "assert" }
<!-- … 6 more edges · lossless -->
]
}
}
</hw:payload>
```
**the ≈200-token digest: know what an artifact is without opening it**
```xml
<hw:envelope format="hwz/1" media-type="application/json">
{
"v": "hwz/1",
"id": "sha256:48b3de6494886c678f4c8efab4f0aa105922e315f8f62145548e17935175fb11",
"k": "diagram",
"title": "Service dependencies",
"intent": "topology diagram: Service dependencies",
"state": "active",
"data": {
"pattern": "dag",
"n": 8,
"hero": "API gateway",
"nodes": { "web": "React SPA", "API gateway": "", "Auth": "tokens", "Orders": "Python svc", "Search": "query svc", "Postgres": "primary", "Kafka": "events", "Redis": "cache" },
"edges": ["web → API gateway", "API gateway → Auth", "API gateway → Orders", "API gateway → Search", "Auth → Postgres (reads)", "Orders → Postgres", "Orders → Kafka (emits)", "Search → Redis (cache)", "API gateway → Postgres (direct read)"]
},
"frames": [{ "t": "diagram", "l": "Service dependencies" }],
"prov": { "by": "hyperweave", "ver": "0.4.6", "genome": "primer.porcelain", "ts": "2026-07-15T02:01:15.613547+00:00" }
}
</hw:envelope>
```
The envelope is the lossy digest; only the payload round-trips.
- **The round-trip:** extract `hw:payload`, edit the JSON, `POST /v1/compose` with it as `diagram`: byte-identical re-render. The envelope's `id` is the sha256 of the payload, so an agent verifies "this artifact really is this data" before trusting either.
- **The look is a pointer, not a copy:** `prov.genome: "primer.porcelain"` names the aesthetics; payload plus that one string is the entire recreation recipe.
### Read at a budget: the verb algebra
Pixels for humans, compact JSON for agents. The verb algebra is the read/write grammar over the two tiers: every verb picks how much of the artifact to load, from the ≈200-token envelope to the full payload, and no verb ever parses pixels.
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/verb-algebra-hub-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/verb-algebra-hub-dark.svg" alt="The verb algebra: the artifact at the hub centre, composed from a spec, transformed with lineage, read without mutation (extract, verify, diff, query), shipping to documents and surfaces." width="100%"
>
</picture>
</p>
The verbs, split two ways.
**Write** · mints a new artifact, returns a content-addressed link (`/v1/a/{id}`), never inline SVG:
| Verb | What it does |
|:---|:---|
| `compose` | a spec → an artifact |
| `transform` | edit an artifact's spec → a new artifact (new id + lineage) |
**Read** · never mutates the artifact:
| Verb | What it does | Returns |
|:---|:---|:---|
| `extract` | pull the payload, envelope, or markdown back out | the requested depth |
| `verify` | recompute the id, proving the artifact *is* its data | `{valid, id}` |
| `validate` | check a spec against the schema before composing | `{valid, type, genome}` |
| `diff` | compare two artifacts | the structural delta |
| `query` | ask a question of the envelope | the answer |
Every verb runs the same over the **CLI** (`hyperweave {verb}`), **HTTP** (`POST /v1/{verb}`), and **MCP** (`hw_{verb}`):
```bash
# compose an artifact, then read its spec straight back, no rendering
hyperweave compose matrix --spec-file table.json -g primer -o table.svg
curl -X POST https://hyperweave.app/v1/extract \
-H 'Content-Type: application/json' \
-d '{"source": "<svg or /v1/a/{id} url>", "respond": "payload"}'
```
### One transform, start to finish
#### Action 1
**Compose** a bundled preset (or your own spec). This is the diagram whose payload and envelope appear above:
```bash
hyperweave compose diagram --spec-file dag-mesh -g primer --variant porcelain --surface inlay --face light -o services.svg
```
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-dark.svg" alt="Service dependencies DAG: a web SPA through an API gateway fanning to Auth, Orders, and Search, each grounding on its store" width="100%"
>
</picture>
</p>
#### Action 2
**Transform** it through the artifact itself. `transform` verifies the hash, applies the patch to the embedded spec, re-validates, and mints a new artifact with a lineage entry recording exactly what changed:
```bash
hyperweave transform services.svg -o services-billing.svg --patch-json '[
{"op": "add", "path": "/nodes/-", "value": {"id": "billing", "label": "Billing", "desc": "invoices", "glyph": "stripe"}},
{"op": "add", "path": "/edges/-", "value": {"source": "gateway", "target": "billing", "relation": "assert"}},
{"op": "add", "path": "/edges/-", "value": {"source": "billing", "target": "postgres", "label": "writes", "label_style": "chip", "relation": "assert", "exit": "bottom", "entry": "right"}}
]'
```
**The result** is a new artifact: new id, one more service in the fan, the envelope and lineage on stdout. `-o` writes the new pixels to `services-billing.svg`:
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-billing-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-billing-dark.svg" alt="The same diagram after one transform: a Billing service joins the fan and its writes edge rides the bottom band into Postgres" width="100%"
>
</picture>
</p>
#### Action 3
**Flip it, and redress it.** Layout is a field, so one op turns the whole graph. The look is a separate pointer, so the same graph re-renders in any variant:
```bash
hyperweave transform services-billing.svg -o services-vertical.svg \
--patch-json '[{"op": "add", "path": "/orientation", "value": "vertical"}]'
hyperweave extract services-vertical.svg --respond payload \
| hyperweave compose diagram --spec-file - --variant noir -o services-noir.svg
```
<p align="center">
<picture>
<source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-light.svg" media="(prefers-color-scheme: light)">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-dark.svg" alt="The same service graph turned vertical and rendered in the noir variant: the fan flows top to bottom, Billing keeps its place in it, and the writes edge takes the outside gutter into Postgres" width="100%"
>
</picture>
</p>
- **A new artifact, not a redraw:** one field changed, and the result carries a new id plus a lineage entry naming its parent. Point `-o` at the same path to overwrite in place; you keep the record of where it came from, not the old render.
- **Orientation keeps structure:** boxes hold their order and authored sides follow the flow, so setting it back to `horizontal` returns the landscape diagram to the pixel.
- **Theme is a pointer:** `porcelain` to `noir` re-renders the same spec in a different look, structure untouched.
---
## Genomes - Brand DNA
A genome is a portable, machine-readable aesthetic specification. It encodes the complete visual identity (chromatic system, surface material, motion vocabulary, geometric form language) as a set of CSS custom properties that any agent can consume and apply consistently across every artifact type.
Four built-in genomes ship today. Custom brand dna generation via agnet SKILL.md files coming soon!
<!--
## Theme Naming Philosophy
Why genome and not theme? Because brand isn't a design problem, it's an infrastructure problem. When an agent says "build me a status page," it has zero memory of visual identity. A genome solves that: define once, express everywhere, from a 90px badge to a 900px star history chart. The same genome produces different artifacts that feel like they came from the same hand.
-->
<p align="center">
<a href="#primer"><kbd>primer</kbd></a>
·
<a href="#brutalist"><kbd>brutalist</kbd></a>
·
<a href="#automata"><kbd>automata</kbd></a>
·
<a href="#chrome"><kbd>chrome</kbd></a>
</p>
<h3 id="primer">primer</h3>
<p align="center">
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=porcelain" alt="PYPI - porcelain variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=cream" alt="PYPI - cream variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=dusk" alt="PYPI - dusk variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=petrol" alt="PYPI - petrol variant"/>
<br/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=noir" alt="PYPI - noir variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=carbon" alt="PYPI - carbon variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=space" alt="PYPI - space variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/primer.static?data=pypi:hyperweave.version&glyph=python&variant=anvil" alt="PYPI - anvil variant"/>
</p>
<p align="center">
<sub>8 variants · 4 light: <code>porcelain</code> · <code>cream</code> · <code>dusk</code> · <code>petrol</code><br/>4 dark: <code>noir</code> · <code>carbon</code> · <code>space</code> · <code>anvil</code></sub>
</p>
<table>
<tr>
<th align="left" width="160">Signals<br/><sub>animated state marks</sub></th>
<td>
<img src="https://hyperweave.app/v1/badge/BUILD/passing/primer.static?state=passing&variant=porcelain" alt="passing"/>
<img src="https://hyperweave.app/v1/badge/BUILD/building/primer.static?state=building&variant=porcelain" alt="building"/>
<img src="https://hyperweave.app/v1/badge/BUILD/warning/primer.static?state=warning&variant=porcelain" alt="warning"/>
<img src="https://hyperweave.app/v1/badge/BUILD/critical/primer.static?state=critical&variant=porcelain" alt="critical"/>
<br/>
<ul>
<li><sub>ping (passing) · spinner (building) · throb (warning) · shake (critical). One mark system, shared with the strip.</sub></li>
<li><sub><code>/v1/badge/{title}/{value}/primer.static?state={state}&variant={porcelain|cream|dusk|petrol|noir|carbon|space|anvil}</code></sub></li>
<li><sub><code>hyperweave.app/v1/badge/BUILD/passing/primer.static?state=passing&variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Dashboard<br/><sub>strip</sub></th>
<td>
<img src="https://hyperweave.app/v1/strip/readme-ai/primer.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=porcelain" alt="strip"/>
<br/>
<ul>
<li><sub><code>/v1/strip/{title}/primer.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/strip/readme-ai/primer.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Profile<br/><sub>card</sub></th>
<td>
<img src="https://hyperweave.app/v1/stats/eli64s/primer.static?variant=porcelain" alt="stats"/>
<br/>
<ul>
<li><sub><code>/v1/card/{username}/primer.static?variant={variant}</code> (<code>/v1/stats/…</code> alias)</sub></li>
<li><sub><code>hyperweave.app/v1/card/eli64s/primer.static?variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Star Chart<br/><sub>star history</sub></th>
<td>
<img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/primer.static?variant=porcelain" alt="star chart"/>
<br/>
<ul>
<li><sub><code>/v1/chart/stars/{owner}/{repo}/primer.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/primer.static?variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Marquee<br/><sub>horizontal ticker</sub></th>
<td>
<img src="https://hyperweave.app/v1/marquee/readme-ai/primer.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=porcelain" alt="marquee"/>
<br/>
<ul>
<li><sub><code>/v1/marquee/{title}/primer.static?data={tokens}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/marquee/readme-ai/primer.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Icons<br/><sub>circle + square</sub></th>
<td>
<img src="https://hyperweave.app/v1/icon/vercel/primer.static?shape=circle&variant=noir" alt="vercel - noir" width="56"/>
<img src="https://hyperweave.app/v1/icon/cloudflare/primer.static?shape=circle&variant=carbon" alt="cloudflare - carbon" width="56"/>
<img src="https://hyperweave.app/v1/icon/docker/primer.static?shape=circle&variant=space" alt="docker - space" width="56"/>
<img src="https://hyperweave.app/v1/icon/github/primer.static?shape=circle&variant=anvil" alt="github - anvil" width="56"/>
<img src="https://hyperweave.app/v1/icon/deepseek/primer.static?shape=square&variant=porcelain" alt="deepseek - porcelain" width="56"/>
<img src="https://hyperweave.app/v1/icon/anthropic/primer.static?shape=square&variant=cream" alt="anthropic - cream" width="56"/>
<img src="https://hyperweave.app/v1/icon/ollama/primer.static?shape=square&variant=dusk" alt="ollama - dusk" width="56"/>
<img src="https://hyperweave.app/v1/icon/nousresearch/primer.static?shape=square&variant=petrol" alt="nousresearch - petrol" width="56"/>
<br/>
<ul>
<li><sub><code>/v1/icon/{glyph}/primer.static?shape={circle|square}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/icon/github/primer.static?shape=circle&variant=noir</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Divider<br/><sub>aura</sub></th>
<td>
<img src="https://hyperweave.app/v1/divider/aura/primer.static?variant=porcelain" alt="primer aura divider"/>
<br/>
<ul>
<li><sub><code>/v1/divider/aura/primer.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/divider/aura/primer.static?variant=porcelain</code></sub></li>
</ul>
</td>
</tr>
</table>
<h3 id="brutalist">brutalist</h3>
<details>
<summary>View the brutalist catalog</summary>
<p align="center">
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=celadon" alt="PYPI - celadon variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=alloy" alt="PYPI - alloy variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=carbon" alt="PYPI - carbon variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=pigment" alt="PYPI - pigment variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=umber" alt="PYPI - umber variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=ember" alt="PYPI - ember variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=temper" alt="PYPI - temper variant"/>
<br/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=onyx" alt="PYPI - onyx variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=primer" alt="PYPI - primer variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=depth" alt="PYPI - depth variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=pulse" alt="PYPI - pulse variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=archive" alt="PYPI - archive variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=signal" alt="PYPI - signal variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/brutalist.static?data=pypi:hyperweave.version&glyph=python&variant=afterimage" alt="PYPI - afterimage variant"/>
</p>
<p align="center">
<sub>22 variants · 8 dark: <code>celadon</code> · <code>alloy</code> · <code>carbon</code> · <code>pigment</code> · <code>umber</code> · <code>ember</code> · <code>temper</code> · <code>onyx</code><br/>14 light (6 shown): <code>primer</code> · <code>depth</code> · <code>pulse</code> · <code>archive</code> · <code>signal</code> · <code>afterimage</code></sub>
</p>
<table>
<tr>
<th align="left" width="160">Signals<br/><sub>state machine</sub></th>
<td>
<img src="https://hyperweave.app/v1/badge/BUILD/passing/brutalist.static?state=passing&variant=celadon" alt="passing"/>
<img src="https://hyperweave.app/v1/badge/BUILD/warning/brutalist.static?state=warning&variant=celadon" alt="warning"/>
<img src="https://hyperweave.app/v1/badge/BUILD/critical/brutalist.static?state=critical&variant=celadon" alt="critical"/>
<br/>
<ul>
<li><sub><code>/v1/badge/{title}/{value}/{genome}.static?state={state}&variant={celadon|carbon|alloy|temper|pigment|ember|umber|onyx|archive|signal|pulse|depth|afterimage|primer}</code></sub></li>
<li><sub><code>hyperweave.app/v1/badge/BUILD/passing/brutalist.static?state=passing&variant=celadon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Dashboard<br/><sub>strip</sub></th>
<td>
<img src="https://hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon" alt="strip"/>
<br/>
<ul>
<li><sub><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Profile<br/><sub>card</sub></th>
<td>
<img src="https://hyperweave.app/v1/stats/eli64s/brutalist.static?variant=pulse" alt="stats - pulse (light)"/>
<br/>
<img src="https://hyperweave.app/v1/stats/eli64s/brutalist.static?variant=celadon" alt="stats - celadon (dark)"/>
<br/>
<ul>
<li><sub><code>/v1/card/{username}/{genome}.static?variant={variant}</code> (<code>/v1/stats/…</code> alias)</sub></li>
<li><sub><code>hyperweave.app/v1/card/eli64s/brutalist.static?variant=pulse</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Star Chart<br/><sub>star history</sub></th>
<td>
<img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/brutalist.static?variant=celadon" alt="star chart"/>
<br/>
<ul>
<li><sub><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/brutalist.static?variant=celadon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Marquee<br/><sub>horizontal ticker</sub></th>
<td>
<img src="https://hyperweave.app/v1/marquee/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=celadon" alt="marquee"/>
<br/>
<ul>
<li><sub><code>/v1/marquee/{title}/{genome}.static?data={tokens}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/marquee/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=celadon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Icons<br/><sub>circle + square</sub></th>
<td>
<img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=circle&variant=celadon" alt="spotify - celadon" width="56"/>
<img src="https://hyperweave.app/v1/icon/docker/brutalist.static?shape=circle&variant=alloy" alt="docker - alloy" width="56"/>
<img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=carbon" alt="github - carbon" width="56"/>
<img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=circle&variant=pigment" alt="discord - pigment" width="56"/>
<img src="https://hyperweave.app/v1/icon/rust/brutalist.static?shape=square&variant=umber" alt="rust - umber" width="56"/>
<img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic - ember" width="56"/>
<img src="https://hyperweave.app/v1/icon/codex/brutalist.static?shape=square&variant=temper" alt="codex - temper" width="56"/>
<img src="https://hyperweave.app/v1/icon/hyperweave/brutalist.static?shape=square&variant=onyx" alt="hyperweave - onyx" width="56"/>
<br/>
<ul>
<li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Divider<br/><sub>seam · sigil</sub></th>
<td>
<img src="https://hyperweave.app/v1/divider/seam/brutalist.static?variant=celadon" alt="brutalist seam divider (dark)"/>
<br/>
<img src="https://hyperweave.app/v1/divider/sigil/brutalist.static?variant=pulse" alt="brutalist sigil divider (light)"/>
<br/>
<ul>
<li><sub><code>/v1/divider/{seam|sigil}/{genome}.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/divider/sigil/brutalist.static?variant=pulse</code></sub></li>
</ul>
</td>
</tr>
</table>
</details>
<h3 id="automata">automata</h3>
<details>
<summary>View the automata catalog</summary>
<p align="center">
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=crimson&size=compact" alt="PYPI - crimson variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=copper&size=compact" alt="PYPI - copper variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=bone&size=compact" alt="PYPI - bone variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=solar&size=compact" alt="PYPI - solar variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=amber&size=compact" alt="PYPI - amber variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=sulfur&size=compact" alt="PYPI - sulfur variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=toxic&size=compact" alt="PYPI - toxic variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=jade&size=compact" alt="PYPI - jade variant"/>
<br/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal&size=compact" alt="PYPI - abyssal variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=teal&size=compact" alt="PYPI - teal variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=steel&size=compact" alt="PYPI - steel variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=cobalt&size=compact" alt="PYPI - cobalt variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=indigo&size=compact" alt="PYPI - indigo variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=violet&size=compact" alt="PYPI - violet variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=magenta&size=compact" alt="PYPI - magenta variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=burgundy&size=compact" alt="PYPI - burgundy variant"/>
</p>
<p align="center">
<sub>16 tones · <code>crimson</code> · <code>copper</code> · <code>bone</code> · <code>solar</code> · <code>amber</code> · <code>sulfur</code> · <code>toxic</code> · <code>jade</code><br/><code>abyssal</code> · <code>teal</code> · <code>steel</code> · <code>cobalt</code> · <code>indigo</code> · <code>violet</code> · <code>magenta</code> · <code>burgundy</code><br/>pair any two via <code>?variant=primary&pair=secondary</code></sub>
</p>
<table>
<tr>
<th align="left" width="160">Signals<br/><sub>state machine</sub></th>
<td>
<img src="https://hyperweave.app/v1/badge/BUILD/passing/automata.static?state=passing&variant=bone" alt="passing"/>
<img src="https://hyperweave.app/v1/badge/BUILD/warning/automata.static?state=warning&variant=bone" alt="warning"/>
<img src="https://hyperweave.app/v1/badge/BUILD/critical/automata.static?state=critical&variant=bone" alt="critical"/>
<br/>
<ul>
<li><sub><code>/v1/badge/{title}/{value}/{genome}.static?state={state}</code></sub></li>
<li><sub><code>hyperweave.app/v1/badge/BUILD/passing/automata.static?state=passing&variant=bone</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Dashboard<br/><sub>strip</sub></th>
<td>
<img src="https://hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&glyph=github" alt="strip"/>
<br/>
<ul>
<li><sub><code>/v1/strip/{title}/automata.static?data={tokens}&variant={tone}&pair={tone}&subtitle={text}&glyph={glyph}</code></sub></li>
<li><sub><code>hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&pair=steel&glyph=github</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Profile<br/><sub>card</sub></th>
<td>
<img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone&v=2" alt="stats"/>
<br/>
<ul>
<li><sub><code>/v1/card/{username}/{genome}.static?variant={tone}</code> (<code>/v1/stats/…</code> alias)</sub></li>
<li><sub><code>hyperweave.app/v1/card/eli64s/automata.static?variant=bone</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Star Chart<br/><sub>star history</sub></th>
<td>
<img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone&v=2" alt="star chart"/>
<br/>
<ul>
<li><sub><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={tone}</code></sub></li>
<li><sub><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Marquee<br/><sub>horizontal ticker</sub></th>
<td>
<img src="https://hyperweave.app/v1/marquee/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=bone" alt="marquee"/>
<br/>
<ul>
<li><sub><code>/v1/marquee/{title}/automata.static?data={tokens}&variant={tone}</code></sub></li>
<li><sub><code>hyperweave.app/v1/marquee/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=bone</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Icons<br/><sub>square</sub></th>
<td>
<img src="https://hyperweave.app/v1/icon/docker/automata.static?shape=square&variant=cobalt" alt="docker cobalt" width="56"/>
<img src="https://hyperweave.app/v1/icon/discord/automata.static?shape=square&variant=indigo" alt="discord indigo" width="56"/>
<img src="https://hyperweave.app/v1/icon/github/automata.static?shape=square&variant=bone" alt="github bone" width="56"/>
<img src="https://hyperweave.app/v1/icon/huggingface/automata.static?shape=square&variant=sulfur" alt="huggingface sulfur" width="56"/>
<img src="https://hyperweave.app/v1/icon/anthropic/automata.static?shape=square&variant=solar" alt="anthropic solar" width="56"/>
<img src="https://hyperweave.app/v1/icon/youtube/automata.static?shape=square&variant=crimson" alt="youtube crimson" width="56"/>
<img src="https://hyperweave.app/v1/icon/spotify/automata.static?shape=square&variant=jade" alt="spotify jade" width="56"/>
<br/>
<ul>
<li><sub><code>/v1/icon/{glyph}/automata.static?shape=square&variant={tone}</code></sub></li>
<li><sub><code>hyperweave.app/v1/icon/docker/automata.static?shape=square&variant=cobalt</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Divider<br/><sub>dissolve</sub></th>
<td>
<img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone" alt="automata dissolve divider"/>
<br/>
<ul>
<li><sub><code>/v1/divider/dissolve/{genome}.static?variant={tone}&pair={tone}</code></sub></li>
<li><sub><code>hyperweave.app/v1/divider/dissolve/automata.static?variant=bone&pair=steel</code></sub></li>
</ul>
</td>
</tr>
</table>
</details>
<h3 id="chrome">chrome</h3>
<details>
<summary>View the chrome catalog</summary>
<p align="center">
<img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=horizon" alt="PYPI - horizon variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=lightning" alt="PYPI - lightning variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal" alt="PYPI - abyssal variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=moth" alt="PYPI - moth variant"/>
<img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=graphite" alt="PYPI - graphite variant"/>
</p>
<p align="center">
<sub>5 variants: <code>horizon</code> · <code>lightning</code> · <code>abyssal</code> · <code>moth</code> · <code>graphite</code></sub>
</p>
<table>
<tr>
<th align="left" width="160">Signals<br/><sub>state machine</sub></th>
<td>
<img src="https://hyperweave.app/v1/badge/BUILD/passing/chrome.static?state=passing&variant=horizon" alt="passing"/>
<img src="https://hyperweave.app/v1/badge/BUILD/warning/chrome.static?state=warning&variant=horizon" alt="warning"/>
<img src="https://hyperweave.app/v1/badge/BUILD/critical/chrome.static?state=critical&variant=horizon" alt="critical"/>
<br/>
<ul>
<li><sub><code>/v1/badge/{title}/{value}/{genome}.static?state={state}&variant={horizon|lightning|abyssal|moth|graphite}</code></sub></li>
<li><sub><code>hyperweave.app/v1/badge/BUILD/passing/chrome.static?state=passing&variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Dashboard<br/><sub>strip</sub></th>
<td>
<img src="https://hyperweave.app/v1/strip/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=horizon" alt="strip"/>
<br/>
<ul>
<li><sub><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/strip/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Profile<br/><sub>card</sub></th>
<td>
<img src="https://hyperweave.app/v1/stats/eli64s/chrome.static?variant=horizon" alt="stats" />
<br/>
<ul>
<li><sub><code>/v1/card/{username}/{genome}.static?variant={variant}</code> (<code>/v1/stats/…</code> alias)</sub></li>
<li><sub><code>hyperweave.app/v1/card/eli64s/chrome.static?variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Star Chart<br/><sub>star history</sub></th>
<td>
<img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/chrome.static?variant=horizon" alt="star chart" />
<br/>
<ul>
<li><sub><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/chrome.static?variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Marquee<br/><sub>horizontal ticker</sub></th>
<td>
<img src="https://hyperweave.app/v1/marquee/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=horizon" alt="marquee"/>
<br/>
<ul>
<li><sub><code>/v1/marquee/{title}/{genome}.static?data={tokens}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/marquee/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,gh:eli64s/readme-ai.contributors,gh:eli64s/readme-ai.watchers,pypi:readmeai.downloads,gh:eli64s/readme-ai.last_push,gh:eli64s/readme-ai.pull_requests,gh:eli64s/readme-ai.issues,gh:eli64s/readme-ai.build,pypi:readmeai.version,gh:eli64s/readme-ai.language&variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Icons<br/><sub>circle + square</sub></th>
<td>
<img src="https://hyperweave.app/v1/icon/github/chrome.static?shape=circle&variant=horizon" alt="github - horizon" width="56"/>
<img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=graphite" alt="notion - graphite" width="56"/>
<img src="https://hyperweave.app/v1/icon/rust/chrome.static?shape=square&variant=moth" alt="rust - moth" width="56"/>
<img src="https://hyperweave.app/v1/icon/docker/chrome.static?shape=square&variant=lightning" alt="docker - lightning" width="56"/>
<img src="https://hyperweave.app/v1/icon/spotify/chrome.static?shape=square&variant=abyssal" alt="spotify - abyssal" width="56"/>
<br/>
<ul>
<li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">Divider<br/><sub>band</sub></th>
<td>
<img src="https://hyperweave.app/v1/divider/band/chrome.static?variant=horizon" alt="chrome band divider"/>
<br/>
<ul>
<li><sub><code>/v1/divider/band/{genome}.static?variant={variant}</code></sub></li>
<li><sub><code>hyperweave.app/v1/divider/band/chrome.static?variant=horizon</code></sub></li>
</ul>
</td>
</tr>
</table>
</details>
<br />
| | primer | brutalist | automata | chrome |
|---|---|---|---|---|
| Aesthetic | Minimal | Raw material | Cellular | Metallic |
| Variants | 8 (4 dark, 4 light) | 22 (8 dark, 14 light) | 16 tones, any two pair | 5 named |
| Motion | Animated state marks | Animated border SMIL | Animated cell grid | Animated border SMIL |
| Divider | `aura` | `seam` · `sigil` | `dissolve` | `band` |
<br />
<h3 id="dividers"><code>/a/inneraura/dividers/</code></h3>
<details>
<summary>View the divider catalog</summary>
<table>
<tr>
<th align="left" width="160">block<br/><sub>De Stijl composition</sub></th>
<td>
<img src="https://hyperweave.app/a/inneraura/dividers/block" alt="block divider"/>
<br/>
<ul>
<li><sub><code>/a/inneraura/dividers/{slug}</code></sub></li>
<li><sub><code>hyperweave.app/a/inneraura/dividers/block</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">current<br/><sub>animated rainbow bezier</sub></th>
<td>
<img src="https://hyperweave.app/a/inneraura/dividers/current" alt="current divider"/>
<br/>
<ul>
<li><sub><code>/a/inneraura/dividers/{slug}</code></sub></li>
<li><sub><code>hyperweave.app/a/inneraura/dividers/current</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">takeoff<br/><sub>rocket trajectory + thrust</sub></th>
<td>
<img src="https://hyperweave.app/a/inneraura/dividers/takeoff" alt="takeoff divider"/>
<br/>
<ul>
<li><sub><code>/a/inneraura/dividers/{slug}</code></sub></li>
<li><sub><code>hyperweave.app/a/inneraura/dividers/takeoff</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">void<br/><sub>spectral bloom + hover state</sub></th>
<td>
<img src="https://hyperweave.app/a/inneraura/dividers/void" alt="void divider"/>
<br/>
<ul>
<li><sub><code>/a/inneraura/dividers/{slug}</code></sub></li>
<li><sub><code>hyperweave.app/a/inneraura/dividers/void</code></sub></li>
</ul>
</td>
</tr>
<tr>
<th align="left">zeropoint<br/><sub>aurora rule + nexus beacon</sub></th>
<td>
<img src="https://hyperweave.app/a/inneraura/dividers/zeropoint" alt="zeropoint divider"/>
<br/>
<ul>
<li><sub><code>/a/inneraura/dividers/{slug}</code></sub></li>
<li><sub><code>hyperweave.app/a/inneraura/dividers/zeropoint</code></sub></li>
</ul>
</td>
</tr>
</table>
</details>
<h3 id="error-fallback">Error fallback: SMPTE NO SIGNAL</h3>
Every broken `<img>` URL renders the SMPTE RP 219 test pattern with `ERR_NNN` matching the HTTP status, instead of a browser broken-image icon.
<p align="center">
<img src="https://hyperweave.app/v1/badge/TEST/value/unknown-genome.static" alt="404 error fallback (intentionally broken URL)"/>
</p>
<p align="center">
<ul>
<li><sub><code>/v1/badge/{title}/{value}/{unknown-genome}.static</code></sub></li>
<li><sub><code>hyperweave.app/v1/badge/TEST/value/unknown-genome.static</code></sub></li>
</ul>
</p>
**Surface modes.** A genome renders onto one of three surfaces: `plate` (opaque, its own background), `inlay` (bare, borrows the host page's light/dark), or `twin` (opaque and scheme-aware). Standalone, slide, and raster destinations take `plate`. For a GitHub README, bake a pair instead of shipping one scheme-adaptive file: GitHub serves README images through Camo as a plain `<img>`, so a `prefers-color-scheme` rule *inside* the SVG answers to the reader's operating system, not the GitHub theme toggle. `--face light|dark` bakes one scheme per file and `<picture>` chooses between them. The CLI exposes `--surface`/`--ground`/`--palette`, and `--faces` writes both files in one call (`<out>-light.svg` / `<out>-dark.svg`).
---
## Install
```bash
uv add hyperweave # CLI + SVG rendering (the base)
uv add 'hyperweave[serve]' # + HTTP server (hyperweave serve)
uv add 'hyperweave[mcp]' # + MCP server (hyperweave mcp)
uv add 'hyperweave[all]' # + both servers
# or swap `uv add` for `pip install`
uv tool install hyperweave # standalone `hw` CLI: uv provisions Python itself
```
<sub>Requires Python 3.10+</sub>
---
## Entry Points
Four interfaces, one pipeline. Every path produces the same artifact through the same compositor.
<p align="center">
<a href="https://hyperweave.app/docs/mcp">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/cards/card-butterfly.svg" alt="MCP" width="48%">
</a>
<a href="https://hyperweave.app/docs/cli">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/cards/card-sunflower.svg" alt="CLI" width="48%">
</a>
<br/>
<a href="https://hyperweave.app/docs/api">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/cards/card-waves.svg" alt="HTTP API" width="48%">
</a>
<a href="https://hyperweave.app/docs/python">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/cards/card-python.svg" alt="Python SDK" width="48%">
</a>
</p>
<!--
<p align="center">
<a href="https://hyperweave.app/docs/api">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/cards/material/api-card.svg" alt="HTTP API" width="48%">
</a>
<a href="https://hyperweave.app/docs/cli">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/cards/material/cli-card.svg" alt="CLI" width="48%">
</a>
<br/>
<a href="https://hyperweave.app/docs/mcp">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/cards/material/mcp-card.svg" alt="MCP" width="48%">
</a> <a href="https://hyperweave.app/docs/python">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/cards/material/skills-card.svg" alt="Python SDK" width="48%">
</a>
</p>
-->
### <img src="./assets/glyphs/readme.entry-points.mcp.svg" alt="Model Context Protocol (MCP)" height="20" width="20" align="absmiddle" /> MCP
```json
{
"mcpServers": {
"hyperweave": {
"command": "hyperweave",
"args": ["mcp"]
}
}
}
```
```
# Static badge
hw_compose(type="badge", title="BUILD", value="passing", genome="brutalist")
# Data-driven badge - unified token grammar (gh:owner/repo.metric, pypi:pkg.metric, ...)
hw_compose(type="badge", title="STARS", data="gh:anthropics/claude-code.stars", genome="brutalist")
# Strip with multiple live metrics
hw_compose(type="strip", title="readme-ai",
data="gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version",
genome="chrome")
# Marquee with mixed text + live tokens
hw_compose(type="marquee",
data="text:NEW RELEASE,gh:anthropics/claude-code.stars,text:DOWNLOAD",
genome="brutalist")
# Read or edit an existing artifact - the verb algebra
hw_extract(svg_or_url="<svg or /v1/a/{id} url>", respond="payload")
hw_transform(svg_or_id="<svg or /v1/a/{id} url>",
mutations=[{"op": "replace", "path": "/title", "value": "SHIPPED"}])
# Return the SVG bytes inline instead of a hosted url (default respond="url")
hw_compose(type="badge", title="BUILD", value="passing", genome="brutalist", respond="svg")
hw_discover(what="all") # the capability registry; full agent contract at /llms-full.txt
```
### <img src="./assets/glyphs/readme.entry-points.cli.svg" alt="Command Line Interface (CLI)" height="20" width="20" align="absmiddle" /> CLI
```bash
# Badge
hyperweave compose badge "build" "passing" --genome brutalist
# Strip with metrics
hyperweave compose strip "readme-ai" "STARS:2.9k,FORKS:278" -g brutalist
# Live data through the unified --data token grammar
hyperweave compose badge "STARS" --data 'gh:anthropics/claude-code.stars' -g brutalist
# Marquee with mixed text + live tokens
hyperweave compose marquee --data 'text:NEW RELEASE,gh:owner/repo.stars,text:DOWNLOAD' -g brutalist
# Session receipt from an agent transcript (Claude Code / Codex)
hyperweave compose receipt session.jsonl -o receipt.svg
# Validate a spec without rendering
hyperweave validate spec.json
# Profile card (live GitHub data, path-segment identity; 'stats' stays an alias)
hyperweave compose card eli64s -g chrome -o card.svg
# Star history chart
hyperweave compose chart stars eli64s/readme-ai -g brutalist -o chart.svg
# Custom genome from a local JSON file (validated against the profile contract)
hyperweave compose badge "DEPLOY" "live" --genome-file ./my-genome.json
hyperweave validate-genome ./my-genome.json
# The verbs: read or transform any artifact by handle, file, URL, or digest
hyperweave extract diagram.svg # the hw:payload seed as JSON
hyperweave diff v1.svg v2.svg --exit-code # structural diff, git-style exit
hyperweave verify diagram.svg # payload ↔ envelope integrity
hyperweave query diagram.svg 'nodes[0].label' # read one field
hyperweave transform diagram.svg --patch patch.json # mint a new artifact + lineage
```
### Agent Loop
The same CLI runs as a machine-readable loop: learn what the install can do, validate before composing, compose with an inspection record, and say why each edit happened.
```bash
# Capability capsule for an agent context: caps, legality, vocabulary, presets + a digest
hyperweave discover --agent
hyperweave discover --agent --topology hub # scoped to one topology family
# Install readiness before composing: formats, fonts, genomes, telemetry wiring
hyperweave doctor
# Machine-readable validation report, the same report every surface returns
hyperweave validate spec.json --json
# Proof sidecars beside the SVG: measured geometry, diagnostics, verdicts,
# a motion-stripped resting frame, and a png when the raster extra is installed
hyperweave compose diagram --spec-file pipeline-head -o out.svg --proof
# One bounded JSON report on stdout instead of SVG bytes: ok, artifact, integrity, diagnostics, next
hyperweave compose badge build passing --respond report
# Say why a patch happened; the reason is recorded in the new artifact's lineage
hyperweave transform out.svg --patch patch.json --intent "rename entry node"
```
### <img src="./assets/glyphs/readme.entry-points.http.svg" alt="HTTP API" height="20" width="20" align="absmiddle" /> HTTP API
```bash
# URL grammar: /v1/{type}/{title}/{value}/{genome}.{motion}
curl 'https://hyperweave.app/v1/strip/readme-ai/brutalist.static?value=STARS:2.9k,FORKS:278'
# Live data via the unified ?data= grammar (works on badge / strip / marquee)
curl 'https://hyperweave.app/v1/badge/STARS/chrome.static?data=gh:anthropics/claude-code.stars'
curl 'https://hyperweave.app/v1/strip/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks'
curl 'https://hyperweave.app/v1/marquee/SCROLL/brutalist.static?data=text:NEW%20RELEASE,gh:anthropics/claude-code.stars'
# Chromatic variants (automata: 16 solo tones, pair any two via &pair=...; chrome: horizon/abyssal/lightning/graphite/moth)
curl 'https://hyperweave.app/v1/badge/PYPI/automata.static?variant=teal&pair=violet&data=pypi:hyperweave.version'
curl 'https://hyperweave.app/v1/badge/build/passing/automata.static?size=compact'
# Genome-themed dividers
curl 'https://hyperweave.app/v1/divider/band/chrome.static'
curl 'https://hyperweave.app/v1/divider/seam/brutalist.static'
curl 'https://hyperweave.app/v1/divider/dissolve/automata.static'
# Genome-agnostic dividers
curl 'https://hyperweave.app/a/inneraura/dividers/zeropoint'
# Structured frames: /v1/{matrix|diagram}/{preset}/{genome}.{motion}
# (preset 'custom' takes a base64url ?spec=)
curl 'https://hyperweave.app/v1/matrix/connectors/primer.static?variant=porcelain'
curl 'https://hyperweave.app/v1/diagram/pipeline-head/primer.static?variant=porcelain'
# POST compose
curl -X POST https://hyperweave.app/v1/compose \
-H "Content-Type: application/json" \
-d '{"type":"strip","title":"hyperweave","genome":"brutalist","value":"STARS:2.9k"}'
# Verb algebra over an existing artifact: extract · verify · transform · diff · query
curl -X POST https://hyperweave.app/v1/extract \
-H "Content-Type: application/json" \
-d '{"source":"<svg or /v1/a/{id} url>","respond":"payload"}'
# Local server
hyperweave serve --port 8000
```
### Output formats
Compose once, export to any of these (same artifact, same metadata):
| `--format` | What you get |
| --- | --- |
| `svg` | the default: live, animated, adapts to the reader's light/dark theme |
| `svg-static` | the same picture with variables flattened and animation stripped, for renderers that don't run CSS |
| `png` · `webp` | rasterized bitmaps (needs `pip install 'hyperweave[raster]'`) |
| `ansi` | a terminal character-grid render |
The HTTP API serves any of these by file suffix (`GET /v1/a/{id}.png`, width-bounded with `?w=`), and a graphics-capable terminal (kitty, ghostty, wezterm) shows `--format png` inline.
Fonts embed in the SVG by default (`--font-mode embed`) so the file stands alone anywhere; `cdn` and `system` trade that portability for smaller bytes.
---
## How It Works
Every artifact is the output of a single composition formula:
```
ARTIFACT = FRAME × PROFILE × GENOME × SLOTS × MOTION × ENVIRONMENT
```
Python builds context dicts. Jinja2 builds SVG. YAML defines config. Three layers, no mixing. Zero f-string SVG in Python.
```
ComposeSpec → engine.py → assembler.py (CSS) → lanes.py (validate) → templates.py (Jinja2) → SVG
```
Every artifact ships with:
- **Re-ingestible payload:** the full spec (`hw:payload`) plus a hash-verified `hwz/1` envelope, so an agent can recover, verify, and edit it - the basis of [the verb algebra](#read-at-a-budget-the-verb-algebra).
- **Semantic metadata:** provenance, reasoning, spatial trace, aesthetic DNA. Machine-readable context so the next agent in the chain knows what it's looking at and why.
- **CSS state machines:** `data-hw-status`, `data-hw-state`, `data-hw-regime` drive visual transitions through the Custom Property Bridge. No JavaScript.
- **Pure CSS/SMIL animation:** no script tags, ever. Each artifact declares its measured tier — `composite-only` (transform/opacity) or `paint-ok` (the default dash march rides `stroke-dashoffset`). Works anywhere SVGs render: GitHub's Camo proxy, email clients, Notion embeds.
- **Accessibility:** WCAG AA, `prefers-reduced-motion`, `prefers-color-scheme`, `forced-colors`, ARIA markup. Structural, not decorative.
| Dimension | Count |
|---|---|
| Frame types | 10 (badge, strip, icon, divider, marquee, card, chart, matrix, diagram, receipt) |
| Genomes | 4 (automata, brutalist, chrome, primer) |
| Motion configs | 6 (1 static + 5 border SMIL) |
| Glyphs | 192 (183 brand marks + 9 geometric shapes) |
| Divider variants | 10: 5 genome-themed (`band` chrome, `seam` + `sigil` brutalist, `dissolve` automata, `aura` primer) + 5 genome-agnostic (`block`, `current`, `takeoff`, `void`, `zeropoint`) at <code>/a/inneraura/dividers/</code> |
| Metadata tiers | 5 (Tier 0 silent → Tier 4 reasoning) |
| Bundled fonts | 5 (JetBrains Mono, Orbitron, Chakra Petch, Barlow Condensed, Inter), embedded per artifact, no external font requests |
Stack: Pydantic, FastAPI, FastMCP v3, Jinja2, Typer.
---
## Data Connectors
HyperWeave binds **live data** into any artifact through a unified token grammar (`?data=...`). Tokens are comma-separated; each token is either a literal (`text:`, `kv:`) or a live fetch (`<provider>:<identifier>.<metric>`).
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/matrices/hw-data-connectors-matrix-inlay.svg" alt="Data connectors matrix: 9 live providers - GitHub, PyPI, npm, crates.io, Hugging Face, Docker Hub, arXiv, OpenSSF Scorecard, GitHub Actions - plus text and kv literal tokens" width="100%"/>
</p>
<details>
<summary>Copy a token · view as table</summary>
| Prefix | Source | Identifier shape | Metrics |
|--------|--------|------------------|---------|
| `gh` / `github` | [GitHub](https://github.com) | `owner/repo` | `stars`, `forks`, `watchers`, `contributors`, `issues`, `pull_requests`, `last_push`, `build`, `license`, `language` |
| `pypi` | [PyPI](https://pypi.org) + [pepy.tech](https://pepy.tech) | `package` | `version`, `license`, `python_requires`, `downloads` |
| `npm` | [npm](https://www.npmjs.com) | `package` | `version`, `license`, `downloads` |
| `crates` / `cargo` | [crates.io](https://crates.io) | `crate` | `version`, `downloads`, `recent_downloads`, `license` |
| `hf` / `huggingface` | [Hugging Face](https://huggingface.co) | `org/model` | `downloads`, `likes`, `tags`, `pipeline_tag`, `library_name`, `license`, `gated`, `last_modified` |
| `docker` | [Docker Hub](https://hub.docker.com) | `namespace/repo` | `pull_count`, `star_count`, `last_updated` |
| `arxiv` | [arXiv](https://arxiv.org) | `id` (e.g. `2310.06825`) | `title`, `authors`, `published`, `updated`, `categories`, `summary`, `journal_ref`, `doi` |
| `scorecard` | [OpenSSF Scorecard](https://github.com/ossf/scorecard) | `owner/repo` | `score` (overall trust), plus per-check: `code_review`, `maintained`, `vulnerabilities`, `token_permissions`, ... |
| `dora` | [GitHub Actions](https://github.com/features/actions) | `owner/repo` | `deploy_frequency`, `lead_time`, `change_failure_rate`, `mttr` (30-day window) |
| `text` | literal | - | renders the payload as displayed text |
| `kv` | literal | `KEY=VALUE` | static role-tagged value |
</details>
- **Caching:** live values for 5–10 min; a failed fetch caches 60s and shows `-` rather than a fabricated zero.
- **Isolation:** each provider has its own circuit breaker, so one upstream outage can't trip the others.
- **Escaping:** commas inside `text:` / `kv:` values escape as `\,`.
<a href="https://github.com/InnerAura/hyperweave/issues/new"><img src="./assets/glyphs/readme.glyph.open-sign.porcelain.svg" alt="Open an issue" height="20" width="20" align="absmiddle" /> Open an issue</a> to request a connector.
---
## Contributing
HyperWeave is early and would love your perspective.
<a href="https://discord.gg/wVmcAZPQZ8"><img src="./assets/glyphs/readme.social.discord.svg" alt="Discord" height="20" width="20" align="absmiddle" /> Join the Discord</a> to connect with the community and discuss the project. HyperWeave has a bit of everything, and we welcome contributions of any kind, from **code** to **docs** to **design**!
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/strips/contributors.svg" alt="InnerAura Labs" width="100%"/>
</p>
---
<p align="center">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/footers/inneraura-footer-liquid.svg" alt="InnerAura Labs" width="100%"/>
</p>
<p align="center">
<a href="https://discord.gg/wVmcAZPQZ8">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-discord.svg" width="48" alt="Discord"/>
</a>
<a href="https://www.instagram.com/hyperweave.ai/">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-instagram.svg" width="48" alt="Instagram"/>
</a>
<a href="https://www.linkedin.com/company/inneraura">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-linkedin.svg" width="48" alt="LinkedIn"/>
</a>
<a href="https://www.tiktok.com/@hyperweave.ai">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-tiktok.svg" width="48" alt="TikTok"/>
</a>
<a href="https://x.com/InnerAuraLabs">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-x.svg" width="48" alt="X"/>
</a>
<a href="https://www.youtube.com/@InnerAuraLabs">
<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/icons/social-icons/cobalt-sapphire-youtube.svg" width="48" alt="YouTube"/>
</a>
</p>
<div align="center">
[![][return-top]](#top)
</div>
<!-- REFERENCE LINKS -->
<!-- SOCIAL URLS -->
[inneraura.ai]: https://inneraura.ai/
[discord]: https://discord.gg/wVmcAZPQZ8
[docs]: https://hyperweave.app
[github]: https://github.com/InnerAura/hyperweave
[instagram]: https://www.instagram.com/hyperweave.ai/
[linkedin]: https://www.linkedin.com/company/inneraura
[tiktok]: https://www.tiktok.com/@hyperweave.ai
[x]: https://x.com/InnerAuraLabs
[youtube]: https://www.youtube.com/@InnerAuraLabs
<!-- SVG WIDGETS -->
[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/buttons/button-liquid.svg
<!-- OTHER README NOTES:
## Features
- Compose portable visual artifacts that can live inside reports, detach into Slack/email/docs, and carry their source, state, and drilldown with them.
- Safe, Auditable, Drop-Anywhere Visuals for your Agents.
- HyperWeave makes AI explanations stateful.
- Beautiful, verified diagrams for coding agents.
- Beautiful diagrams for agents that stay structurally correct.
- Ask your coding agent for a diagram. Get verified SVG.
- HyperWeave is a visual compiler for agents.
- Ask your agent to explain something visually. HyperWeave turns its intent into a deterministic, verified, self-contained SVG or HTML artifact that can be inspected, transformed, diffed, and regenerated without the agent manually drawing coordinates.
---
## Self-Describing Artifacts
```ascii
ONE OBJECT
┌───────────────┐
│ semantic spec │ ← agent
├───────────────┤
│ compact form │ ← context window
├───────────────┤
│ visual form │ ← human
├───────────────┤
│ text form │ ← markdown/terminal
└───────────────┘
```
-->
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues