https://github.com/adafede/marimo

https://github.com/adafede/marimo

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.6%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Basic Info
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 1
  • Releases: 0
Created 12 months ago · Last pushed 11 months ago
Metadata Files
Readme License

README.md

marimo WebAssembly + GitHub Pages Template

This template repository demonstrates how to export marimo notebooks to WebAssembly and deploy them to GitHub Pages.

📚 Included Examples

  • apps/charts.py: Interactive data visualization with Altair
  • notebooks/fibonacci.py: Interactive Fibonacci sequence calculator
  • notebooks/penguins.py: Interactive data analysis with Polars and marimo

🚀 Usage

  1. Fork this repository
  2. Add your marimo files to the notebooks/ or apps/ directory
    1. notebooks/ notebooks are exported with --mode edit
    2. apps/ notebooks are exported with --mode run
  3. Push to main branch
  4. Go to repository Settings > Pages and change the "Source" dropdown to "GitHub Actions"
  5. GitHub Actions will automatically build and deploy to Pages

Including data or assets

To include data or assets in your notebooks, add them to the public/ directory.

For example, the apps/charts.py notebook loads an image asset from the public/ directory.

markdown <img src="public/logo.png" width="200" />

And the notebooks/penguins.py notebook loads a CSV dataset from the public/ directory.

python import polars as pl df = pl.read_csv(mo.notebook_location() / "public" / "penguins.csv")

🎨 Templates

This repository includes several templates for the generated site:

  1. index.html.j2 (default): A template with styling and a footer
  2. bare.html.j2: A minimal template with basic styling
  3. tailwind.html.j2: A minimal and lean template using Tailwind CSS

To use a specific template, pass the --template parameter to the build script:

bash uv run .github/scripts/build.py --template templates/tailwind.html.j2

You can also create your own custom templates. See the templates/README.md for more information.

🧪 Testing

To test the export process, run .github/scripts/build.py from the root directory.

bash uv run .github/scripts/build.py

This will export all notebooks in a folder called _site/ in the root directory. Then to serve the site, run:

bash python -m http.server -d _site

This will serve the site at http://localhost:8000.

Owner

  • Name: Adriano Rutz
  • Login: Adafede
  • Kind: user
  • Location: Zürich, Switzerland

Pharmacist | Computational Metabolomics

GitHub Events

Total
  • Delete event: 1
  • Push event: 9
  • Pull request event: 2
  • Create event: 3
Last Year
  • Delete event: 1
  • Push event: 9
  • Pull request event: 2
  • Create event: 3

Dependencies

.github/workflows/deploy.yml actions
  • actions/checkout v4 composite
  • actions/deploy-pages v4 composite
  • actions/setup-python v5 composite
  • actions/upload-pages-artifact v3 composite
  • astral-sh/setup-uv v6 composite
pyproject.toml pypi
  • rdkit <2026.0.0,>=2025.3.3
uv.lock pypi
  • marimo 0.0.1
  • numpy 2.3.1
  • pillow 11.3.0
  • rdkit 2025.3.3