# Visual Lab

Fast visual conversations: render charts with Flint CLI and shared MCP, diagrams with Archify, and scientific plots with Python. Measured trials and editable examples.

**Status:** Live · Projects · 2026

- **Local checkout:** `/Users/simon/Developer/visual-lab` (branch `main`, last commit e38d012, 2026-10-31 — Report Fedora tool errors as display failures)
- **Uncommitted changes:** 1 file(s) at brief generation time
- **Repository:** https://github.com/ShimonNavon/visual-lab
- **On another machine:** `git clone https://github.com/ShimonNavon/visual-lab` — the paths below are Simon's Mac
- **Documentation and trials:** https://projects.navonsimon.com/visual-lab
- **Where it runs:** Node24; pinned npm lockfile; no database or mounted secrets
- **Note:** Experimental tailnet renderer; documentation public.

## Stack

Node.js, Flint chart MCP 1.0.1, MCP SDK, Python Matplotlib, Archify

## Start here

- `visual.mjs` — CLI wrapper and Fedora image display
- `bridge.mjs` — Stateless MCP HTTP adapter for native Flint tools

## Commands

- **Render PNG:** `visual render examples/projects.json --format png --output artifacts/projects.png`
- **Show on Fedora:** `visual show artifacts/projects.png`
- **Native MCP:** `visual mcp`
- **Deploy:** `./deploy/deploy.sh`

## Deploy and where it runs

- Kubernetes namespace visual-lab; NodePort30114; http://ubuntu03:30114/mcp; shared registry visual-lab

## Current state

Working CLI and native MCP trials; shared cluster bridge. Public evidence at /visual-lab.

## Watch out

- Flint1.0.1 bin symlink no-ops: wrapper uses real entry point.
- Inherited Zod3 memory-exhaustion advisory; experimental trusted-tailnet use only, 1MiB body cap.
- HTTP bridge forwards tools only; no MCP-App resources/prompts.
- Archify and Python are companion trials; not exposed by Flint MCP.

## Tags

Visualization, CLI, MCP, Flint, Archify, Python

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/visual-lab.md
