metadata

title: marimo learn
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
sdk_version: latest
app_file: app.py
pinned: false

A curated collection of educational marimo notebooks || 💬 Discord

📚 Learn

This repository contains a curated collection of educational marimo notebooks. These Python notebooks, organized into courses, explain fundamental concepts for an expanding set of topics, including academic topics like computer science, linear algebra, probability, and machine learning, as well as applied topics such as how to use popular packages such as polars, pytorch, matplotlib, and more.

Our goal with marimo learn is to create a central repository of high quality notebooks for educators, students, and practitioners.

Courses

🐍 Python: Learn the basics of the Python programming language
⚖️ Optimization: Learn how to solve optimization problems, with applications to finance and control

Coming soon.

🎲 Probability
📏 Linear algebra
❄️ Polars
🔥 Pytorch
🗄️ Duckdb
📈 Altair
📈 Plotly
📈 matplotlib

We're seeking contributions! If you'd like to contribute, please reach out.

Adding notebooks

We welcome community contributions of notebooks and entire courses (folders of notebooks on a single topic).

To get started, please start by opening an issue and proposing the notebook or course you'd like to contribute. Once your proposal is accepted, draft your notebook and submit it for review as a pull request. We hold learn notebooks to a high standard, and we may go through a few rounds of reviews before your notebook is merged.

Here's a contribution checklist:

Include package dependencies in notebook files using --sandbox
If adding a course, include a README.md
Keep language direct and simple.

If you aren't comfortable adding a new notebook or course, you can also request what you'd like to see by filing an issue.

Building and Previewing

The site is built using a Python script that exports marimo notebooks to HTML and generates an index page.

# Build the site
python scripts/build.py --output-dir _site

# Preview the site (builds first)
python scripts/preview.py

# Preview without rebuilding
python scripts/preview.py --no-build

Community

We're building a community. Come hang out with us!