akaOSS
ProjectsHologram

Live observability, guided skills, and an agent (MCP) surface for Blender → glTF pipelines.

v0.6.0 · on PyPI as hologram-gltf · Python 3.10+ · MIT.

Install

Run the dashboard
$ uvx --from hologram-gltf hologram dashboard

Why it exists.

Plenty of tools inspect a .glb. Hologram is the only one that puts a live feed of your agent's pipeline activity next to the assets it's producing, and hands that same pipeline to the agent as MCP tools — now including a render so the agent can see an export, not just count its nodes.

Hologram watches a glTF asset pipeline and streams what's happening to a local dashboard in real time — including the tool calls your AI coding agent is making right now.

Deliberately read-only / non-destructive. No framework, no build step, no database — a stdlib HTTP server, a JSONL event log, and pure-Python glTF parsing.

01

Why it was built

Hologram comes from building games. The bulk of the asset work runs through Blender into glTF — characters, props, weapons — and at some point an AI coding agent became a real part of that pipeline: it writes the Blender scripts, runs the exports, and rearranges the .glb files that ship. That was a huge speed-up, right up until the realisation that there was no real idea what it was doing. Assets changed, exports appeared, and reconstructing which step touched which file meant scrolling back through a terminal.

Hologram closes that gap. It tails a single event log and shows the agent's live activity — edits, shell commands, exports — right next to the assets those actions produce, in one local dashboard. Then it hands the agent that same pipeline back as a few MCP tools, so human and agent end up looking at the same picture instead of talking past each other.

Plenty of tools inspect a .glb. Hologram is the only one that puts a live feed of your agent's pipeline activity next to the assets it's producing — and gives the agent a render, so it can see an export, not just count its nodes.

02

Constraints as design

Hologram is deliberately read-only / non-destructive: it observes, introspects, validates, and previews your pipeline, but it never modifies your assets. The one nuance is render_asset — it drives a live Blender to produce an image, in a throwaway scene with your scene restored afterward. Four tools are strictly read-only; the render is non-destructive. Checks you author run over assets but can't modify anything, and never run inside the MCP server.

The second constraint is architectural austerity: no framework, no build step, no database. A stdlib HTTP server, a JSONL event log, and pure-Python glTF parsing. The MCP server imports none of your project code, and Hologram itself never imports bpy — it drives Blender over a socket, so its import purity stays intact. Austerity here isn't minimalism for its own sake; it's what makes the tool trustworthy enough to point at the pipeline that produces the assets you actually ship.

03

The pieces

Four pieces, none needing a manual install: an activity hook (a stdlib-only Claude Code hook that logs sessions, shell commands, edits, and MCP calls into the event log), the MCP server (launched by uvx per session), five guided skills (/hologram:start, inspect, check, status, create-skill — a natural-language front door), and the SSE dashboard you run in a terminal when you want eyes on the pipeline.

On top of the live feed: read-only checks you author in .hologram/checks.py, fingerprint-based regression diffing so the dashboard can answer "what changed since the last check", and pipeline_status — one MCP read of what's wrong right now.

Signature features.

4 features

Live pipeline feed

Watches a glTF asset pipeline and streams what's happening to a local dashboard in real time — including the tool calls your AI coding agent is making right now.

MCP agent surface

An MCP server with four read-only tools plus a non-destructive render — so the agent can see an export, not just count its nodes.

Guided skills

A Claude Code plugin with guided skills — /hologram:start, inspect, check, status, create-skill.

Read-only by design

Deliberately read-only / non-destructive. No framework, no build step, no database — a stdlib HTTP server, a JSONL event log, and pure-Python glTF parsing.

Explore further.

The source lives on GitHub. Copy, paste, own — no fork, no vendor lock-in.

The other projects