MCP Servers

hyperweave

HyperWeave gives agents a visual output surface: structured data in, branded SVG out. No JavaScript, no runtime. Works anywhere an image can be embedded. Badges, cards, charts, dashboards, diagrams, and more.

README

Headless visual output layer for AI agents. One API call → self-contained SVG. No JavaScript. No dependencies. No runtime. Works everywhere an <code><img></code> tag works.

<!-- AI agents need to explain what they did, what they found, and what changed — HyperWeave gives them a visual language that works anywhere.

A brand agent for repos. Generate a cohesive visual identity layer for README, profile, status, and releases — automatically.

A brand agent for repos. Generate a cohesive visual identity — README, profile, metrics, releases — from a single genome.

HyperWeave is the generative visual identity system for the agentic era. A user defines a genome — their aesthetic DNA — and HyperWeave renders coherent visual artifacts across any surface, for any context, from any data. Badges for repos. Cards for stats. Charts for data. Artifact sets for research papers. Release kits for product launches. Marketing assets for startups. Static when static. Live when live. Generated when generative. Their brand, as infrastructure, for everything their agents will ever need to render.

The list in the middle ("Badges for repos. Cards for stats. Charts for data...") reads long. It proves the surface area is broad but it also reads like a features list. Investors skim past enumeration. You could collapse it: "Every surface agents render on, from repos to research papers to product launches." The breadth lands harder when it's a claim than when it's a list.

HyperWeave is the brand agent for engineering teams. Define your identity once; every artifact your team ships carries it wherever their work appears.

Safe, Auditable, Drop-Anywhere Visuals for your Agents.

"Hyperweave is the visual protocol for autonomous agents. We give AI agents the ability to generate high-fidelity, brand-aligned UI artifacts—roadmaps, telemetry, and status cards—so humans can monitor and trust agentic workflows."

HyperWeave is the visual artifact layer for modern software. Generate branded, self-contained SVG outputs for profiles, repositories, docs, dashboards, and agent workflows.

“runtime-free visual compiler for structured machine outputs”

take structured state, compress it into an emotionally legible surface, and make it portable

"In a post-Mythos world, letting autonomous agents generate executable UI code (React/JS) is a catastrophic security risk. HyperWeave is the secure, stateless, verifiable visual protocol for the Agentic Web."

The Voiceover: "Agents don't need to generate heavy React apps that require hosting and runtimes. HyperWeave generates secure, zero-dependency SVG artifacts that travel to wherever your users actually work."

Prompting Guide for AI Agents -->

The Problem

When an agent needs to produce something visual — a status card, a dashboard, a receipt of its work — it generates React, HTML, or pixels, locked in the environment that made it. Embed it in markdown, pass it to another agent — it breaks or loses context. There's no portable visual primitive for agents.

HyperWeave is that primitive. One API call returns a self-contained SVG with data binding, branding, and machine-readable metadata baked in. No JavaScript, no dependencies, no runtime. It renders in GitHub READMEs, Slack, Notion, docs, your site, email, VS Code, or terminal. Every surface that renders an <img> tag is a HyperWeave surface.

Agentic Artifacts

Every AI coding session produces a receipt — cost, tokens, tool distribution, session rhythm. One install, fully automatic.

hyperweave install-hook

<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_voltage_xlarge.svg" alt="session receipt — voltage livery showing 262M tokens, 562 calls, 52 stages, divergence flag" width="800"/> 262M tokens · 562 calls · 52 stages · $175 — voltage

<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/rhythm_strip_voltage_xlarge.svg" alt="session rhythm strip — same session data at 92px tall" width="800"/> Rhythm strip — the same session data at 92px tall

<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_claude-code_medium.svg" alt="session receipt — claude-code livery on warm paper substrate" width="800"/> Same data, different livery — claude-code

<img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/telemetry/receipt_codex_large.svg" alt="session receipt — codex agent transcript auto-detected from JSONL shape" width="800"/> Codex transcripts auto-detect from the JSONL shape

The livery matches the agent that produced the session:

Agent	Livery
Claude Code	`claude-code`
Codex	`codex`
—	`voltage`
—	`cream`

Auto-detected from the session transcript. Pin a different default with hyperweave install-hook --genome voltage.

Genomes — Aesthetic 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.

Three production genomes ship today. Custom genome generation via AI skill files coming soon.

<a href="#brutalist"><kbd>brutalist</kbd></a> · <a href="#automata"><kbd>automata</kbd></a> · <a href="#chrome"><kbd>chrome</kbd></a>

<h3 id="brutalist">brutalist</h3>

12 variants: <code>celadon</code> · <code>carbon</code> · <code>alloy</code> · <code>temper</code> · <code>pigment</code> · <code>ember</code> · <code>archive</code> · <code>signal</code> · <code>pulse</code> · <code>depth</code> · <code>afterimage</code> · <code>primer</code>

<table> <tr> <th align="left" width="160">Signals state machine</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"/> <ul> <li><code>/v1/badge/{title}/{value}/{genome}.static?state={state}&variant={celadon|carbon|alloy|temper|pigment|ember|archive|signal|pulse|depth|afterimage|primer}</code></li> <li><code>hyperweave.app/v1/badge/BUILD/passing/brutalist.static?state=passing&variant=celadon</code></li> </ul> </td> </tr> <tr> <th align="left">Dashboard strip</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"/> <ul> <li><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></li> <li><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></li> </ul> </td> </tr> <tr> <th align="left">Profile stats card</th> <td> <img src="https://hyperweave.app/v1/stats/eli64s/brutalist.static?variant=celadon" alt="stats" width="70%"/> <ul> <li><code>/v1/stats/{username}/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/stats/eli64s/brutalist.static?variant=celadon</code></li> </ul> </td> </tr> <tr> <th align="left">Star Chart star history</th> <td> <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/brutalist.static?variant=celadon" alt="star chart" width="70%"/> <ul> <li><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/brutalist.static?variant=celadon</code></li> </ul> </td> </tr> <tr> <th align="left">Marquee horizontal ticker</th> <td> <img src="https://hyperweave.app/v1/marquee/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=celadon" alt="marquee"/> <ul> <li><code>/v1/marquee/{title}/{genome}.static?data={tokens}&variant={variant}</code></li> <li><code>hyperweave.app/v1/marquee/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=celadon</code></li> </ul> </td> </tr> <tr> <th align="left">Icons circle + square</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/github/brutalist.static?shape=circle&variant=carbon" alt="github — carbon" 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/npm/brutalist.static?shape=square&variant=temper" alt="npm — temper" width="56"/> <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=square&variant=pigment" alt="discord — pigment" width="56"/> <img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic — ember" width="56"/> <ul> <li><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></li> <li><code>hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon</code></li> </ul> </td> </tr> <tr> <th align="left">Divider seam</th> <td> <img src="https://hyperweave.app/v1/divider/seam/brutalist.static?variant=celadon" alt="brutalist seam divider"/> <ul> <li><code>/v1/divider/seam/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/divider/seam/brutalist.static?variant=celadon</code></li> </ul> </td> </tr> </table> <h3 id="automata">automata</h3>

16 tones: <code>violet</code> · <code>teal</code> · <code>bone</code> · <code>steel</code> · <code>amber</code> · <code>jade</code> · <code>magenta</code> · <code>cobalt</code> · <code>toxic</code> · <code>solar</code> · <code>abyssal</code> · <code>crimson</code> · <code>sulfur</code> · <code>indigo</code> · <code>burgundy</code> · <code>copper</code>. Pair any two via <code>?variant=primary&pair=secondary</code>.

<table> <tr> <th align="left" width="160">Signals state machine</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"/> <ul> <li><code>/v1/badge/{title}/{value}/{genome}.static?state={state}</code></li> <li><code>hyperweave.app/v1/badge/BUILD/passing/automata.static?state=passing&variant=bone</code></li> </ul> </td> </tr> <tr> <th align="left">Dashboard strip</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"/> <ul> <li><code>/v1/strip/{title}/automata.static?data={tokens}&variant={tone}&pair={tone}&subtitle={text}&glyph={glyph}</code></li> <li><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></li> </ul> </td> </tr> <tr> <th align="left">Profile stats card</th> <td> <img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone&v=2" alt="stats" width="100%"/> <ul> <li><code>/v1/stats/{username}/{genome}.static?variant={tone}</code></li> <li><code>hyperweave.app/v1/stats/eli64s/automata.static?variant=bone</code></li> </ul> </td> </tr> <tr> <th align="left">Star Chart star history</th> <td> <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone&v=2" alt="star chart" width="100%"/> <ul> <li><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={tone}</code></li> <li><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone</code></li> </ul> </td> </tr> <tr> <th align="left">Marquee horizontal ticker</th> <td> <img src="https://hyperweave.app/v1/marquee/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=bone" alt="marquee"/> <ul> <li><code>/v1/marquee/{title}/automata.static?data={tokens}&variant={tone}</code></li> <li><code>hyperweave.app/v1/marquee/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=bone</code></li> </ul> </td> </tr> <tr> <th align="left">Icons square</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"/> <ul> <li><code>/v1/icon/{glyph}/automata.static?shape=square&variant={tone}</code></li> <li><code>hyperweave.app/v1/icon/docker/automata.static?shape=square&variant=cobalt</code></li> </ul> </td> </tr> <tr> <th align="left">Divider dissolve</th> <td> <img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone" alt="automata dissolve divider"/> <ul> <li><code>/v1/divider/dissolve/{genome}.static?variant={tone}&pair={tone}</code></li> <li><code>hyperweave.app/v1/divider/dissolve/automata.static?variant=bone&pair=steel</code></li> </ul> </td> </tr> </table> <h3 id="chrome">chrome</h3>

5 variants: <code>horizon</code> · <code>abyssal</code> · <code>lightning</code> · <code>graphite</code> · <code>moth</code>

<table> <tr> <th align="left" width="160">Signals state machine</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"/> <ul> <li><code>/v1/badge/{title}/{value}/{genome}.static?state={state}&variant={horizon|abyssal|lightning|graphite|moth}</code></li> <li><code>hyperweave.app/v1/badge/BUILD/passing/chrome.static?state=passing&variant=horizon</code></li> </ul> </td> </tr> <tr> <th align="left">Dashboard strip</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"/> <ul> <li><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></li> <li><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></li> </ul> </td> </tr> <tr> <th align="left">Profile stats card</th> <td> <img src="https://hyperweave.app/v1/stats/eli64s/chrome.static?variant=horizon" alt="stats" width="100%"/> <ul> <li><code>/v1/stats/{username}/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/stats/eli64s/chrome.static?variant=horizon</code></li> </ul> </td> </tr> <tr> <th align="left">Star Chart star history</th> <td> <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/chrome.static?variant=horizon" alt="star chart" width="100%"/> <ul> <li><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/chart/stars/eli64s/readme-ai/chrome.static?variant=horizon</code></li> </ul> </td> </tr> <tr> <th align="left">Marquee horizontal ticker</th> <td> <img src="https://hyperweave.app/v1/marquee/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=horizon" alt="marquee"/> <ul> <li><code>/v1/marquee/{title}/{genome}.static?data={tokens}&variant={variant}</code></li> <li><code>hyperweave.app/v1/marquee/readme-ai/chrome.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version,pypi:readmeai.downloads,docker:zeroxeli/readme-ai.pull_count&variant=horizon</code></li> </ul> </td> </tr> <tr> <th align="left">Icons circle + square</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"/> <ul> <li><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></li> <li><code>hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon</code></li> </ul> </td> </tr> <tr> <th align="left">Divider band</th> <td> <img src="https://hyperweave.app/v1/divider/band/chrome.static?variant=horizon" alt="chrome band divider"/> <ul> <li><code>/v1/divider/band/{genome}.static?variant={variant}</code></li> <li><code>hyperweave.app/v1/divider/band/chrome.static?variant=horizon</code></li> </ul> </td> </tr> </table>

	brutalist	automata	chrome
Aesthetic	Raw material	Living cellular grid	Metallic precision
Variants	12 (6 dark, 6 light)	16 tones, any two pair	5 named
Motion	Animated border SMIL	Animated cell grid	Animated border SMIL
Divider	`seam`	`dissolve`	`band`

<h3 id="dividers"><code>/a/inneraura/dividers/</code></h3>

<table> <tr> <th align="left" width="160">block De Stijl composition</th> <td> <img src="https://hyperweave.app/a/inneraura/dividers/block" alt="block divider"/> <ul> <li><code>/a/inneraura/dividers/{slug}</code></li> <li><code>hyperweave.app/a/inneraura/dividers/block</code></li> </ul> </td> </tr> <tr> <th align="left">current animated rainbow bezier</th> <td> <img src="https://hyperweave.app/a/inneraura/dividers/current" alt="current divider"/> <ul> <li><code>/a/inneraura/dividers/{slug}</code></li> <li><code>hyperweave.app/a/inneraura/dividers/current</code></li> </ul> </td> </tr> <tr> <th align="left">takeoff rocket trajectory + thrust</th> <td> <img src="https://hyperweave.app/a/inneraura/dividers/takeoff" alt="takeoff divider"/> <ul> <li><code>/a/inneraura/dividers/{slug}</code></li> <li><code>hyperweave.app/a/inneraura/dividers/takeoff</code></li> </ul> </td> </tr> <tr> <th align="left">void spectral bloom + hover state</th> <td> <img src="https://hyperweave.app/a/inneraura/dividers/void" alt="void divider"/> <ul> <li><code>/a/inneraura/dividers/{slug}</code></li> <li><code>hyperweave.app/a/inneraura/dividers/void</code></li> </ul> </td> </tr> <tr> <th align="left">zeropoint aurora rule + nexus beacon</th> <td> <img src="https://hyperweave.app/a/inneraura/dividers/zeropoint" alt="zeropoint divider"/> <ul> <li><code>/a/inneraura/dividers/{slug}</code></li> <li><code>hyperweave.app/a/inneraura/dividers/zeropoint</code></li> </ul> </td> </tr> </table>

<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.

<ul> <li><code>/v1/badge/{title}/{value}/{unknown-genome}.static</code></li> <li><code>hyperweave.app/v1/badge/TEST/value/unknown-genome.static</code></li> </ul>

Install

uv add hyperweave
# or
pip install hyperweave

Requires Python 3.12+.

Entry Points

Four interfaces, one pipeline. Every path produces the same artifact through the same compositor.

MCP

{
  "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-horizontal",
           data="text:NEW RELEASE,gh:anthropics/claude-code.stars,text:DOWNLOAD",
           genome="brutalist")

# Discoverable shortcut for single-metric live badges
hw_live(provider="github", identifier="anthropics/claude-code", metric="stars")

hw_kit(type="readme", genome="brutalist", badges="build:passing")
hw_discover(what="all")

CLI

# 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-horizontal --data 'text:NEW RELEASE,gh:owner/repo.stars,text:DOWNLOAD' -g brutalist

# Artifact kit
hyperweave kit readme -g brutalist --badges "build:passing,version:v0.2.0" --social "github,discord"

# Profile card (live GitHub data, path-segment identity)
hyperweave compose stats eli64s -g chrome -o stats.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

HTTP API

# 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'

# 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"}'

# Local server
hyperweave serve --port 8000

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:

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 — all motion uses compositor-safe properties (transform, opacity, filter). No script tags. Works inside GitHub's Camo proxy, email clients, Notion embeds — anywhere SVGs render.
Accessibility — WCAG AA, prefers-reduced-motion, prefers-color-scheme, forced-colors, ARIA markup. Structural, not decorative.

Dimension	Count
Frame types	9 (badge, strip, icon, divider, marquee-horizontal, stats, chart, receipt, rhythm-strip)
Genomes	3 (automata, brutalist, chrome)
Motion configs	6 (1 static + 5 border SMIL)
Glyphs	99 (93 Simple Icons + 6 geometric)
Divider variants	8 — 3 genome-themed (`band` chrome, `seam` brutalist, `dissolve` automata) + 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	4 families / 5 weights (JetBrains Mono, Orbitron, Chakra Petch, Barlow Condensed 700/900 — base64-embedded)

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>).

Prefix	Source	Identifier shape	Metrics
`gh` / `github`	GitHub	`owner/repo`	`stars`, `forks`, `watchers`, `issues`, `license`, `language`, `build`
`pypi`	PyPI + pypistats.org	`package`	`version`, `license`, `python_requires`, `downloads`
`npm`	npm registry	`package`	`version`, `license`, `downloads`
`hf` / `huggingface`	HuggingFace Hub	`org/model`	`downloads`, `likes`, `tags`, `pipeline_tag`, `library_name`
`docker`	Docker Hub	`namespace/repo`	`pull_count`, `star_count`, `last_updated`
`arxiv`	arXiv API	`id` (e.g. `2310.06825`)	`title`, `authors`, `published`, `categories`, `summary`
`text`	literal	—	renders the payload as displayed text
`kv`	literal	`KEY=VALUE`	static role-tagged value

Live tokens cache for 5–10 minutes per provider. Failures cache for 60s and surface as the em-dash sentinel (—) instead of fabricating zero values. Each provider runs through its own circuit breaker so a single upstream outage cannot trip unrelated fetches.

Embedded commas inside text: and kv: values escape as \,.

→ Open an issue to request a connector.

Contributing

HyperWeave is early. If you're interested in building genomes, extending frame types, or just seeing what this looks like in your own README — join the Discord.

</div>

[inneraura.ai]: https://inneraura.ai/ [discord]: https://discord.gg/wVmcAZPQZ8 [docs]: https://hyperweave.readthedocs.io/ [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

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured