# marimo-team/marimo

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.

Repository: https://github.com/marimo-team/marimo
Canonical: https://ross.abutalabs.com/products/marimo
Homepage: https://marimo.io
Language: Python
License: Apache-2.0
License Family: permissive
Topics: notebooks, python, data-science, machine-learning, artificial-intelligence, data-visualization, developer-tools, reactive, pipeline, web-app, dag, dataflow, sql
Last push: 2026-08-27T00:11:31+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 79
- inputs: {"age_days": 1115, "days_push": 7, "days_rel": 16, "gap_med": 2, "n_releases_24m": 188}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 22500, forks 1239 (observed 2026-08-28T04:11:32.685488+00:00)

## What it is
marimo is a reactive Python notebook stored as pure Python files, where running a cell automatically re-runs dependent cells to keep code and outputs consistent. Notebooks can be executed as scripts, deployed as interactive web apps, queried with SQL, and edited with built-in AI assistance.

## Use cases
- replace jupyter notebooks with a reproducible reactive python notebook
- build interactive data apps with sliders and widgets without callbacks
- query dataframes and databases with sql in a notebook
- run notebooks as python scripts with cli arguments
- deploy a notebook as a shareable web app
- version notebooks with git as pure python files
- pair coding agents like claude code with a running notebook
- explore and transform data with an ai-native editor

## When to choose
- you want reproducible notebooks with no hidden state and consistent outputs
- you need notebooks stored as git-friendly pure python files
- you want to turn a notebook into an interactive app or script without rewriting it
- you need built-in sql support for dataframes, databases, and warehouses
- you want AI-assisted code generation that understands your notebook's variables

## When to avoid
- your team and tooling are deeply invested in the jupyter/ipykernel ecosystem
- you need cell-by-cell arbitrary execution order rather than reactive dataflow
- you only need lightweight scratch experimentation with no reproducibility requirements
- you rely on jupyter-specific extensions or widgets incompatible with marimo

## Facets
- artifact type: application
- maturity: active
- function: data-visualization, developer-tools, editor, gui, web-framework, cli, nlp, machine-learning, data-science
- domain: data-science, developer-tools, machine-learning, data-visualization, web-development, artificial-intelligence
- platform: python, cross-platform, cli, wasm
- tags: notebook, reactive-programming, jupyter-alternative, streamlit-alternative, sql, git-friendly, interactive-widgets, dataflow, ai-native, reproducibility, web-server, docker

## Member repositories
- marimo-team/marimo (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:32.685488+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:57:09.339963+00:00, confidence not recorded.
  - readme: https://github.com/marimo-team/marimo (fetched 2026-08-28T04:11:32.685488+00:00, sha b5e0c3d7a83d)
  - homepage: https://marimo.io (fetched 2026-08-29T07:55:28.413590+00:00, sha 1ab276f5eb14)
  - site_page: https://docs.marimo.io (fetched 2026-08-29T07:55:28.422805+00:00, sha b20033177619)
  - site_page: https://docs.marimo.io/guides/editor_features/watching?h=autocom (fetched 2026-08-29T07:55:28.425128+00:00, sha 56888c5d51af)
  - site_page: https://docs.marimo.io/guides/editor_features/overview?h=vim+k (fetched 2026-08-29T07:55:28.427258+00:00, sha b1891a7dd217)
  - site_page: https://docs.marimo.io/guides/editor_features/ai_completion (fetched 2026-08-29T07:55:28.430376+00:00, sha aaf5df617641)
  - site_page: https://docs.marimo.io/guides/editor_features/ai_completion.html (fetched 2026-08-29T07:55:28.433267+00:00, sha aaf5df617641)
  - site_page: https://docs.marimo.io/faq.html (fetched 2026-08-29T07:55:28.435311+00:00, sha 0c341c8f6844)
  - site_page: https://marimo.io/about (fetched 2026-08-29T07:55:28.437458+00:00, sha 3c82f8492670)
  - site_page: https://marimo.io/features/feat-ai (fetched 2026-08-29T07:55:28.439116+00:00, sha 693bc0fa5674)
- Data as of 2026-08-30T08:39:29.467469+00:00.