Skip to content

About

Scroll-driven websites from one YAML file: generated film, live 3D, data stories, maps. Runs locally, no API keys; Claude can drive it via MCP.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

50 stars

Watchers

0 watching

Forks

Latest commit

 

History

396 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Scroll Studio

Scroll Studio

An open-source design studio for scroll-driven landing pages. One YAML file in, a finished site out, made on your own machine with no API keys.

See it live →
Every example, built by this engine, on one page. Scroll it.
Try it on a laptop →
No GPU needed: pip install -e ., then studio new my-site --laptop.

Scroll Studio 1.5 in 30 seconds: six example pages recorded from their built sites
New in 1.5: your brand from a link, pictures in one medium, the pointer as a light or a lens, and studio remake <url>. What's new →

Showcase · Get started · Docs · Examples · Releases · Changelog

Latest release AGPL-3.0 Tests OpenSSF Scorecard Local models only MCP ready

Your brand. Your scroll.

Scenes Your brand Workflow
One camera take through a whole page Remake any landing page: studio remake <url> Six art directions from one brief
Cinemagraphs, light from dawn to night Your colours, fonts and logo from a URL or a logo Storyboard before you render
Fly inside your product's 3D model Every spacing, type and motion value is yours to set A polish report on every film
Miniature worlds, maps, charts, live 3D Optional experiences on top: 32 styles, from zoetrope to paint on glass Claude drives it all through MCP
Photo parallax from your own pictures Any brand, from a page, a logo or a brand.yaml Remake a live landing page: studio remake <url>

The heavy scenes (generated film and images) are made with open models on your own GPU (Z-Image, Qwen-Image-Edit, LTX-2.3, Wan 2.2, SeedVR2, Blender); photo parallax, kinetic type, maps, data, code, live 3D and every style need no GPU. The output is plain HTML, CSS and JS you can host anywhere. The examples show what each scene does; they are not templates. Bring your own photos, footage, 3D models, logo and copy, or a brief.

See the scenes · one take, cinemagraphs, light, inside the product, miniature worlds, film cuts
The one-take page: a farmhouse hearth room Cinemagraphs: a hotel where only one thing moves
The one-take pageCinemagraphs
Light as the scroll: a harbour at blue hour Inside the product: the Framework mainboard fan
Light as the scrollInside the product
Miniature worlds: a tilt-shift harbour Film cuts: a ring logo becomes the sun
Miniature worldsFilm cuts
Type in the world: a headline behind a tree Direction boards: six art directions side by side
Type in the worldDirection boards

Get started

git clone https://github.com/Okohedeki/scroll-studio && cd scroll-studio
pip install -e .
studio doctor                         # what this machine can build
studio build examples/cellwright-bio  # live 3D: needs nothing but Python
studio preview cellwright-bio         # http://localhost:5173
studio ui                             # the Studio app: http://localhost:5180

No GPU? Try it on a laptop: studio new my-site --laptop makes a site that builds without ComfyUI or Blender, and studio remake <url> --no-gpu turns a live page into one.

What you build What it needs
Live 3D, charts, maps, type, vector art, splat scans, miniature worlds, code flights, all 32 styles Python and a browser
Photo parallax, product sequences, inside the product Runs on the CPU; Blender and a GPU make it fast
Generated film, the one-take page, cinemagraphs, light as the scroll, generated images ComfyUI and a 24 GB GPU (RTX 4090 class)

Full setup (GPU, Blender, ComfyUI and the models) is in docs/INSTALL.md.

Build with Claude

Open the repo in Claude Code and ask for a site. The scroll-studio MCP server (.mcp.json) gives Claude every engine tool, and the scroll-site skill gives it the workflow. Or paste this into any coding agent:

Install Scroll Studio on this machine and build one of its examples, following
https://github.com/Okohedeki/scroll-studio/blob/main/docs/INSTALL.md
Make your own site
studio new my-site                 # a starter site.yaml
studio remake https://example.com/ # or start from a live landing page, told as a scroll site
studio directions my-site          # six art directions; --pick one
studio storyboard my-site --edit   # sketches, stills and an animatic before any video render
studio build my-site               # cached stage by stage: change one thing, rebuild one thing
studio inspect my-site             # pops, softness, halos and drift in every film
studio publish my-site --out site  # one static folder for GitHub Pages or any host

The whole workflow is in the guide.

Documentation

Need Start here
Setup Install · What each machine can build
What it can make Scenes · Styles · Examples · Showcase
Reference site.yaml, CLI and MCP reference, generated from the engine
Making a site Guide: direction boards, storyboards, client copy decks, trailers, Claude
Why it exists Local only, 10 to 30 times fewer tokens
How it works Engine · Style research · Roadmap
Contributing How to contribute · Rules per area · Code of conduct · Getting help
The project Governance · Maintainers · Compatibility · Design proposals · Security · Threat model
Releases What's new · Changelog · 1.5 milestone

Licence

Free software under the GNU AGPL-3.0 with additional terms (NOTICE.md): derivatives stay open source and keep the attribution word for word, and sites you build are yours to license however you like. Model weights keep their own licences. Details in docs/licence.md; AI agents, see AGENTS.md.

About

Scroll-driven websites from one YAML file: generated film, live 3D, data stories, maps. Runs locally, no API keys; Claude can drive it via MCP.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

50 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages