01. THE REALITY CHECK
Control Over Fidelity
Models like Veo, Sora, and Kling have achieved remarkable visual fidelity. They can render almost anything as pixels. But pixels are static data—you cannot easily modify a single element, interrupt a sequence mid-animation, or attach logic handlers to specific shapes after generation.
PinePaper bets on Visual Control. By exposing the vector DOM (Document Object Model), we allow AI agents to not just "dream" an image, but to structure it. This enables interruptibility, programmatic modification, and precise component reuse.
This isn't about replacing video generation—it's about filling the gap for functional micro-graphics: status indicators, data visualizations, UI components, and interactive diagrams.
The Vector Advantage
- 1Readable Vector Space Agents can query positions, bounds, and relationships. The DOM is inspectable—enabling understanding, not just output.
- 2Interruptibility Modify scenes mid-animation based on events. Essential for interactive dashboards and live data.
- 3Micro-Signals Generate functional, lightweight components (spinners, badges, progress bars) rather than full-frame art.
02. RESEARCH CONTEXT
Following the Science
PinePaper's approach is informed by emerging academic research on LLM capabilities with vector graphics. These papers demonstrate that text-based vector formats provide a natural interface for language models.
Delving into LLMs' Visual Understanding via SVG
Demonstrates that LLMs can perform visual reasoning, image classification, and generation by processing SVG as text. "The textual nature of SVG provides a data modality that LLMs excel at."
VGBench: Evaluating LLMs on Vector Graphics
First comprehensive benchmark for LLM + vector graphics. Tests understanding and generation across SVG, TikZ, and Graphviz formats with 4,279 QA pairs.
LLM4SVG: Empowering LLMs for Complex Vector Graphics
Introduces semantic tokens for SVG understanding. Released SVGX dataset with 580k SVG-instruction pairs for fine-tuning language models on vector generation.
DeepSVG: Hierarchical SVG Generation & Animation
Pioneering work on neural SVG generation. Demonstrates latent space interpolation for creating smooth animations between vector keyframes.
VDLM: Visually Descriptive Language Model
Introduces "Primal Visual Description" (PVD)—an intermediate text representation between SVG and natural language that improves LLM reasoning on graphics.
StarVector: Image & Text to SVG Generation
Multimodal LLM for SVG generation from both images and text prompts. Achieves state-of-the-art on SVG-Bench for icons, logos, and diagrams.
These papers inform our design decisions but PinePaper is an independent project, not affiliated with any research institution.
03. USE CASES
From "Scenes" to "Signals"
PinePaper isn't trying to replace Hollywood VFX tools. We optimize for the high-utility layer that LLMs can master today: Functional Micro-Interactions.
Live Status Signals
"Recording" indicators, "Live" badges, or "Processing" spinners. Simple, code-defined animations that communicate system state without video file overhead.
PinePaper.create('circle', {animate: 'pulse'})Data Accents
Context-aware overlays for charts. Use an Agent to analyze data and programmatically place animated arrows, highlighters, or callouts exactly where they matter.
PinePaper.annotate(chart, {highlight: 'Q3'})UI Prototyping
Rapidly generate interactive UI mockups. Because output is DOM-based, these components can often port directly to production code.
PinePaper.exportSVG() → React component04. ARCHITECTURE
The "Agent Hand-off"
Browser security sandboxes prevent external AI agents (like Claude) from directly executing code inside a running tab. We solve this with a transparent Human-in-the-Loop workflow, or via the Model Context Protocol (MCP).
Agent Reasons About Vector Space
The agent interprets your prompt, reasons about positions, shapes, and animations, then expresses that as code.
Execution Layer
You run the code (paste into console or via MCP tool) to render vector graphics locally. This keeps the tool free, secure, and client-side.
Iterate & Export
Refine with natural language feedback, then export as animated SVG, video (WebM), or static image.
05. FOUNDATION
Standing on the Shoulders of Giants
PinePaper is built on Paper.js—a mature vector graphics framework. Together, they provide the abstraction layer that lets agents understand and operate in vector space.
Paper.js
The Swiss Army Knife of Vector Graphics Scripting
Paper.js is a mature vector graphics scripting framework that evolved from Scriptographer—a scripting environment for Adobe Illustrator. It provides:
- →Vector-First Mathematics — Points, Sizes, and Rectangles as first-class citizens with operator overloading
- →Scene Graph / DOM — Nested layers, groups, paths, symbols—all inspectable and modifiable
- →Bidirectional SVG — Import, transform, animate, and export vector graphics seamlessly
- →Boolean Operations — Unite, intersect, subtract, divide shapes programmatically
Code that reads like geometry — agents can reason about vector space through this syntax
06. CORE PRINCIPLES
Built for the Open Web
Client-Side Core
No installation required. Works entirely in your browser without server roundtrips. Your data stays on your device—privacy by architecture.
AI-Native API
Built from the ground up to be controlled by agents. Exposes a global window.PinePaper API for programmatic generation and manipulation.
Global by Default
Support for 41 languages and all writing systems including Chinese, Arabic, Hindi, and emoji. Create content for any audience.
We're Testing a Hypothesis
Can AI agents understand vector space and operate within it? The abstractions—PinePaper, Paper.js—are just the interface. The real question is whether agents can reason about positions, shapes, transformations, and timing to create meaningful visual output.
What we're validating:
- ? Can agents reason about spatial relationships and coordinates?
- ? Can they compose shapes, layers, and animations coherently?
- ? Does the scene graph help them self-correct visual errors?
What works today:
- ✓ Manual editor for text, shapes, and SVG import
- ✓ 8 animation presets (pulse, rotate, bounce, typewriter, etc.)
- ✓ Timeline editor with keyframe animations ✨ NEW
- ✓ Export to animated SVG and WebM video
- ✓ Global
window.PinePaperAPI for programmatic control
Help us validate this — try the editor and share your experience via our feedback board.
08. FAQ
Frequently Asked Questions
What is PinePaper Studio?
A browser-based tool for creating animated SVG micro-interactions. Built on Paper.js, it exposes a declarative API designed for both AI agents and humans to understand and manipulate vector graphics.
Is PinePaper Studio free?
Yes, it's freeware. Runs entirely in your browser with no account required. All processing happens client-side—your data stays on your device.
Can AI agents use PinePaper?
Yes. It exposes a global window.PinePaper object for programmatic control. We're testing whether AI can effectively understand and operate in vector space through this interface.
What is Paper.js?
A mature open-source vector graphics framework on HTML5 Canvas. It provides a scene graph (DOM) for vector graphics. PinePaper is built as an abstraction layer on top of it.
What export formats are supported?
Animated SVG files (with native animation tags), WebM video, and static PNG images.
What animations are available?
8 presets: Pulse, Wobble, Rotate, Bounce, Typewriter, Shake, Swing, and Jelly. Plus, the new Timeline system lets you create custom keyframe-based animations with easing functions for professional sequences.
Ready to experiment?
No account required. Everything runs in your browser.