A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
marimo + openapi
The frontend of marimo communicates with the backend through an OpenAPI specification, which can be found in packages/openapi/api.yaml.
The host protocol has a separate, schema-first contract in
protocols/host/openapi.yaml. Its ownership,
generation commands, and portable conformance checks are documented in
protocols/host/README.md.
Printing the OpenAPI schema
marimo development openapi
Writing a new OpenAPI schema
To expose a frontend type, add it to roots in
schema.py, or use named_exports to
give a union or literal an exported name. Its dependencies are included
automatically when you regenerate the schema and TypeScript with Python 3.12:
make fe-codegen
Validating an OpenAPI schema
pipx install openapi-spec-validator
marimo development openapi | openapi-spec-validator -
Generating a client from an OpenAPI schema
make fe-codegen
You will then need to reinstall the package in /frontend:
cd frontend
pnpm update @marimo-team/marimo-api