# manim-marimo

> Animate <span class="notebook">marimo notebooks</span> with <span class="scene">Manim</span>

The notebook computes. The scene animates the result.

## Table of Contents

### Guide

- [Getting started](https://peter-gy.github.io/manim-marimo/guide/getting-started.md): Install manim-marimo, add an Animation view to a notebook, and watch it render from notebook values.
- [Scenes and notebook results](https://peter-gy.github.io/manim-marimo/guide/scenes.md): Read notebook values, figures, and cell outputs in a Manim scene, and give every read a default.
- [Pages and players](https://peter-gy.github.io/manim-marimo/guide/pages.md): Show one or more scenes on a view page, with a custom player and native notebook cells.
- [Author with agents](https://peter-gy.github.io/manim-marimo/guide/agents.md): Let a coding agent write the notebook, the scenes, and the page, using the skills marimo-studio and manim-marimo ship.
- [Run and export](https://peter-gy.github.io/manim-marimo/guide/run-and-export.md): Serve Manim views live, export them as static sites, and render on Linux servers without a display.
- [Troubleshooting](https://peter-gy.github.io/manim-marimo/guide/troubleshooting.md): Match a Manim view symptom to its cause and repair.

### Examples

- [Examples](https://peter-gy.github.io/manim-marimo/examples.md): Four marimo notebooks whose Animation views render Manim scenes from notebook results.
- [A notebook is a dataflow graph](https://peter-gy.github.io/manim-marimo/examples/dataflow.md): A notebook analyzes a small notebook the way marimo does, and its scene draws which cells each slider reruns.
- [Fourier drawing](https://peter-gy.github.io/manim-marimo/examples/fourier.md): Rotating vectors draw manim-marimo's mark and TeX's italic m from Fourier coefficients the notebook computes.
- [Convolution of dice](https://peter-gy.github.io/manim-marimo/examples/convolution.md): A joint probability table becomes the distribution of a sum, and the scene ends on the notebook's own chart.
- [Simulating an epidemic](https://peter-gy.github.io/manim-marimo/examples/epidemic.md): Two hundred simulated people spread an infection through a city, and every person in the movie traces back to the notebook row that simulated them.

### Reference

- [Python API](https://peter-gy.github.io/manim-marimo/reference/python-api.md): The functions a Manim scene calls to read notebook results.
- [View provider](https://peter-gy.github.io/manim-marimo/reference/provider.md): The manim-marimo/manim provider's starter, options, project files, renders, and diagnostics.

### Other

- [manim-marimo](https://peter-gy.github.io/manim-marimo/index.md): Manim animations of marimo notebook results, rendered as marimo-studio views.