Content Studio Catalogue & Desktop App
Yanshi’s Content Studio turns raw sources — a topic idea, web URLs, GitHub
repositories, academic PDFs, or audio/video recordings — into finished,
downloadable deliverables through a deterministic five-stage pipeline
(RFC_CONTENT_STUDIO.md):
- Sources — ingest web search results, pages (
httpwith SSRF protection), codebases (repo_snapshot), PDFs (pdf_extract), arXiv source tarballs (arxiv), or recordings (video_ingest+asr). - Planner — optional content-level planning (
examples/applications/content-studio/or interactivetype: agentclarification viaask_user). - Generators — hand-authored, schema-validated DAG templates under
examples/generators/with structured JSON outputs and chunk-level citations. - Renderers — embedded pure-Rust writers (
render_slides+ native OOXML.pptx,render_table.xlsx/.csv,render_svg,render_mindmap,render_study,render_markdown) plus OS-sandboxed media/typesetting tools (typst,pandoc,ffmpeg,d2,lualatex,ContainerBackendPython). - Artifacts — first-class
FlowValue::Fileoutputs stored on disk with SHA-256 manifests, downloadable via CLI--output-dir,/v1/runs/{id}/artifacts, Web Studio, or theYanshi Studiodesktop app.
Built-in Generator Catalogue (15 Workflows)
Every template in examples/generators/ validates
under yanshi workflow validate --strict and can be executed from the CLI, the
HTTP gateway, /ui/studio, /ui/app, or the macOS/Windows/Linux desktop app.
1. Keynote Slides, Video & Audio
| Template | Primary Inputs | Deliverables | Visual & Media Highlights |
|---|---|---|---|
illustrated_slides.yml | subject, audience, slide_count, slide_theme (dark/light), style_preset | Interactive .html deck, native editable OOXML .pptx, 16:9 .pdf | Web grounding → slide visual routing across AI illustration (6 art presets), D2 figure, and native editable shapes/tables/code |
tech_slides_video.yml | topic, repo_url, pdf_source, presenter_mode (spotlight/pip/intro_outro) | 1080p narrated .mp4, .srt/.vtt subtitles, .pptx, 16:9 .pdf, .html | Progressive step-by-step slide builds synced millisecond-accurately to expressive TTS, spotlight rings, optional PiP presenter video |
slides.yml | url / text / chunks, focus, enable_illustrations, style_preset | Native editable .pptx, 16:9 .pdf, .html | Source-grounded presentation with self-repairing vector figure diagrams and optional illustration visuals (works with zero image keys by default) |
video_overview.yml | url / text, image_model, tts_model, video_model (optional) | Narrated .mp4 + .srt | Parallel scene illustration (text_to_image or optional text_to_video motion shots) + per-scene tts + render_video muxing |
audio_overview.yml | url / text, minutes, tts_model, host_voice, guest_voice | Loudness-normalised .mp3 | Two-speaker conversational script voiced in parallel and EBU R128 normalised via render_audio |
Slide Visual Routing & Art-Direction Presets
Slide workflows (illustrated_slides.yml, slides.yml, tech_slides_video.yml)
classify each slide’s visual layout automatically:
illustration— conceptual, cover, analogy, and summary slides are rendered byIllustrationNodewith optional LLM art-director prompt refinement (refine_prompt: true), canvas palette harmonization (dark#0B1120/light#F8FAFC), and strict anti-text guardrails across sixstyle_presetmodes:editorial_tech(default) — editorial publication illustration with crisp geometric formsisometric_3d— clean 3D isometric miniature with soft studio lightingflat_vector— Swiss-grid geometric vector art with bold silhouettesblueprint_schematic— precision architectural/engineering CAD schematicscientific_diagram— textbook-grade layered cross-section visualcinematic_keynote— dramatic wide-angle keynote hero visual
arch_diagram— system topology and dataflow slides compile validated vector SVG diagrams viafigure(language: d2/svg/typst/tikz/python) with automatic compile-error feedback repair.structured_panel— code walkthroughs, benchmarks, and checklists emit native editable PowerPoint shapes,<a:tbl>tables,<p:cxnSp>connectors, and monospace callouts directly via pure-Rust OOXML (export_pptx: true).
2. Daily Engineering & Research Workflows
| Template | Primary Inputs | Deliverables | Workflow Highlights |
|---|---|---|---|
repo_architecture.yml | source (GitHub URL or local dir), git_ref, subpath, focus | D2 system & module dependency .svg/.png, .pdf, .html, .md | repo_snapshot scans directory tree, manifests, and internal imports without executing untrusted repo code |
backend_project_planner.yml | idea, tech_preference, interactive (true/false), max_questions | System arch, module dep, UML class/sequence, flowchart & ER .svg, PostgreSQL .sql DDL, mindmap, full spec .pdf | Multi-turn HITL ask_user clarification pauses the run in Studio/CLI to confirm scale and constraints before generating full specs |
paper_reader.yml | source (arXiv URL, PDF URL, or local PDF), target_lang, max_pages | Bilingual digest .pdf/.html, extracted experiment tables .xlsx/.csv, method diagram .svg, mindmap | pdf_extract + structured experimental benchmark extraction into numeric Excel sheets |
video_summarizer.yml | source (video URL or local media file), subtitle_langs, asr_model | Timestamped summary .pdf/.html, .srt subtitles (native or ASR + optional bilingual polish), mindmap | video_ingest prefers native captions and falls back automatically to FFmpeg audio extraction + asr |
3. Sourced Reports, Diagrams & Study Kits
| Template | Primary Inputs | Deliverables | Workflow Highlights |
|---|---|---|---|
report.yml | url / text / chunks, focus, sections, pdf | Footnoted .md, self-contained .html, typeset .pdf | Parallel map section drafting with verbatim source quotes and chunk citations |
infographic.yml | url / text / chunks, focus | .svg and high-DPI .png | Deterministic Tera SVG poster layout driven by schema-validated headline metrics |
mindmap.yml | url / text / chunks, depth | Vector .svg, .png, interactive markmap .html | Hierarchical tree extraction rendered via embedded render_mindmap + render_svg |
circuit_diagram.yml | description, text | Checked schematic .svg and .png | Extracts a typed parts list first, then verifies every component ID/kind in circuitikz before lualatex compile |
flashcards.yml | url / text / chunks, count | Interactive flip-card .html + JSON deck | Self-contained offline study page rendered by render_study (kind: flashcards) |
quiz.yml | url / text / chunks, count | Self-grading multiple-choice .html + JSON | Instant explanation and score tally via render_study (kind: quiz) |
Quickstart Commands
CLI One-Liners
# 1. Illustrated Keynote Deck (.pptx + 16:9 .pdf + interactive .html)
yanshi workflow run examples/generators/illustrated_slides.yml \
--input subject "Rust Async Runtime & Work-Stealing Scheduler" \
--input style_preset editorial_tech \
--output-dir out/slides
# 2. Academic Paper Reader (arXiv/PDF -> .pdf dossier + .xlsx tables + D2 diagram)
yanshi workflow run examples/generators/paper_reader.yml \
--input source "https://arxiv.org/abs/1706.03762" \
--output-dir out/paper
# 3. GitHub Repository Architecture Analysis
yanshi workflow run examples/generators/repo_architecture.yml \
--input source "https://github.com/tokio-rs/axum" \
--output-dir out/axum-arch
# 4. Multi-Deliverable Planner Skill (one source -> report + mindmap + audio)
yanshi skill run examples/applications/content-studio \
--input url=https://example.org/article \
--input want=report,mindmap \
--output-dir out/studio
Cap total LLM + media spend on any run with cost_limit_usd in YAML or --checkpoint
to resume interrupted multi-stage pipelines without re-billing completed nodes:
yanshi workflow run examples/generators/tech_slides_video.yml \
--checkpoint --timeout 15m \
--input topic "Zero-Copy Networking in Rust" \
--output-dir out/lecture
# If interrupted at a late stage, resume from the last completed node:
yanshi workflow resume <run_id> examples/generators/tech_slides_video.yml \
--output-dir out/lecture
Web Studio (/ui/studio & /ui/app)
Start yanshi-server and open:
http://127.0.0.1:8080/ui/app— App Runner: pick any of the 15 templates, fill in the generated input form, answer inlineask_userclarification cards if prompted, and preview/download finished.pptx,.pdf,.mp4,.xlsx, and.htmldeliverables.http://127.0.0.1:8080/ui/studio— Visual DAG Studio: inspect and edit the workflow graph on an interactive canvas, set per-node breakpoints, step through evaluated inputs/outputs, and preview rendered slides or media inline.
Desktop App (Yanshi Studio via Tauri v2)
yanshi-ui/src-tauri packages the full Studio and App Runner as a standalone
desktop app with an in-process local execution engine (local_engine.rs) —
no PostgreSQL or external server process required. It automatically loads
~/.yanshi/.env, seeds the bundled 44-model pricing table
(config/pricing.prod.yml), and supports interactive ask_user HITL prompts
offline.
On macOS, build and install Yanshi Studio.app directly into /Applications:
# Build release bundle and stage into /Applications/Yanshi Studio.app
./scripts/install_desktop.sh --open
# Re-install an already built bundle without recompiling
./scripts/install_desktop.sh --skip-build
Check external rendering binaries (ffmpeg, ffprobe, pandoc, typst, d2)
at any time with:
yanshi doctor --profile local