Skip to content

Reference ​

Reference pages define exact public contracts. Start with the quickstart for a complete workflow or What is marimo-export? for the main concepts.

Author and inspect exports ​

NeedReference
Declare a state space and output sourcesStateSpace and ExportSpec
Match a notebook value to a stored form and consumerOutput representations
Implement or inspect the portable directoryExport format
Run commands or consume human and machine outputCLI

Use Python ​

NeedReference
Choose the Python surfacePython API
Plan, prepare, capture, build, and writeProduce an export
Open, select, decode, and verifyPython reader
Connect to sessions and inspect notebooksSessions and inspection
Retain prepared work and observationsRepository and observations
Retain a Python prepared publication or commit an application directoryDelivery and publications
Integrate an interactive marimo hostHost integration
Encode canonical values or handle typed failuresFormat records and errors

Use a browser ​

NeedReference
Choose the browser surfaceBrowser API
Open, select, load, and verifyBrowser reader
Follow a prepared manifest and commit browser statePrepared publications
Decode or mount one representationOutput loaders
Consume rendered-output and complete-cell recordsmarimo snapshots
Handle failures and configure byte limitsBrowser errors and limits

Cross-language contracts ​

  • Portable JSON defines the shared Python and JavaScript value boundary and identifies the published interfaces in each language.
  • Compatibility defines Python, marimo, browser, package, and protocol boundaries.
  • Terminology provides a short lookup map for project nouns.

Released under the Apache 2.0 License.