README.md

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

<p align="center">
  <img src="/assets/marimo-learn.png">
</p>

<p align="center">
  <span><em>A curated collection of educational <a href="https://github.com/marimo-team/marimo">marimo</a> notebooks</em> || <a href="https://discord.gg/rT48v2Y9fe">💬 Discord</a></span>
</p>

# 📚 Learn

This repository contains a curated collection of educational
[marimo](https://github.com/marimo-team/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](python/): Learn the basics of the Python programming language
- ⚖️ [Optimization](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](https://github.com/marimo-team/learn/issues/new?template=example_request.yaml)._

## 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](https://github.com/marimo-team/learn/issues/new?template=example_request.yaml) 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`](https://docs.marimo.io/guides/package_reproducibility/)
- [ ] 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](https://github.com/marimo-team/learn/issues/new?template=example_request.yaml).

## Building and Previewing

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

```bash
# 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!

- 🌟 [Star us on GitHub](https://github.com/marimo-team/examples)
- 💬 [Chat with us on Discord](https://discord.gg/rT48v2Y9fe)
- 📧 [Subscribe to our Newsletter](https://marimo.io/newsletter)
- ☁️ [Join our Cloud Waitlist](https://marimo.io/cloud)
- ✏️ [Start a GitHub Discussion](https://github.com/marimo-team/marimo/discussions)
- 🦋 [Follow us on Bluesky](https://bsky.app/profile/marimo.io)
- 🐦 [Follow us on Twitter](https://twitter.com/marimo_io)
- 🕴️ [Follow us on LinkedIn](https://www.linkedin.com/company/marimo-io)


<p align="right">
  <img src="https://raw.githubusercontent.com/marimo-team/marimo/main/docs/_static/marimo-logotype-horizontal.png" height="200px">
</p>