https://github.com/haleshot/marimo-tutorials
Collection of marimo tutorials which encompass notebook/app examples in varying domains - CS/AI/ML
https://github.com/haleshot/marimo-tutorials
artificial-intelligence computer-vision data-science image-processing jax llm machine-learning marimo marimo-notebook pytorch recommender-system tensorflow
Last synced: 5 months ago
JSON representation
Collection of marimo tutorials which encompass notebook/app examples in varying domains - CS/AI/ML
- Host: GitHub
- URL: https://github.com/haleshot/marimo-tutorials
- Owner: Haleshot
- License: mit
- Created: 2024-05-26T06:38:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-09T15:42:42.000Z (7 months ago)
- Last Synced: 2025-05-01T18:50:18.449Z (6 months ago)
- Topics: artificial-intelligence, computer-vision, data-science, image-processing, jax, llm, machine-learning, marimo, marimo-notebook, pytorch, recommender-system, tensorflow
- Language: Python
- Homepage: https://marimo.io/c/@haleshot/marimo-tutorials
- Size: 35.8 MB
- Stars: 27
- Watchers: 3
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Interactive Tutorials and Notebooks for marimo
# marimo-tutorials
Welcome to `marimo-tutorials`, a comprehensive collection of interactive
notebooks and tutorials showcasing the power and versatility of
[marimo](https://marimo.io), an innovative Python notebook framework. This
repository serves as a hub for learning, exploration and community engagement
across various domains of computer science, data science, AI, and more.
## Table of Contents
- [About](#about)
- [Getting Started](#getting-started)
- [Featured Notebooks](#featured-notebooks)
- [Community Spotlights](#community-spotlights)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## About
`marimo-tutorials` is designed to provide a rich learning experience for both
beginners and advanced users of marimo. Our collection spans multiple
disciplines, offering hands-on examples, in-depth tutorials, and real-world
applications of marimo's capabilities.
Each subdirectory within `marimo-tutorials/` contains domain-specific
notebooks, along with their respective README files and assets.
## Getting Started
To get started with the notebooks in this repository, you'll need to have
marimo installed. We recommend using [`uv`](https://github.com/astral-sh/uv)
for managing dependencies and running notebooks in isolated environments.
1. Install [`uv`](https://github.com/astral-sh/uv) if you haven't already:
```shell
pip install uv
```
2. Clone this repository:
```shell
git clone https://github.com/Haleshot/marimo-tutorials.git
cd marimo-tutorials
```
3. To run a notebook with its dependencies in an isolated environment:
```shell
uvx marimo run --sandbox path/to/notebook.py
```
4. To edit a notebook:
```shell
uvx marimo edit --sandbox path/to/notebook.py
```
### Isolated Environments with marimo
As highlighted in the
[marimo blog](https://marimo.io/blog/sandboxed-notebooks), it's now possible to
create marimo notebooks that have their package requirements serialized into
them as a top-level comment. Given a notebook with inlined requirements, marimo
can run it in an isolated virtual environment with a single command:
```shell
marimo edit --sandbox notebook.py
```
This creates a fresh virtual environment, or sandbox, and installs the
dependencies before opening the notebook. marimo's opt-in package management
features can even track imports and automatically add them to your notebook's
inlined requirements. This means you can create and share standalone notebooks
without shipping `requirements.txt` files alongside them.
## Featured Notebooks
Here are some featured notebooks from our collection:
> [!NOTE]
> The links given below will be updated soon, they are intended as placeholders to showcase the structure of our README file.
### Artificial Intelligence
Collaborative Filtering
Machine Learning
### Data Science
### Signal and Image Processing
Image Processing
Signal Processing
## Community Spotlights
While this repository hosts a variety of tutorials and notebooks, the official
community spotlights are featured in a separate repository:
[marimo-team/spotlights](https://github.com/marimo-team/spotlights).
> [!NOTE]
>
> The spotlights repository features a project or marimo notebook from
> the community every Thursday. If you've created a notebook in this repository
> that you believe would be a good fit for the community spotlight, feel free
> to open an [issue](https://github.com/marimo-team/spotlights/issues) in the
> spotlights repository.
## Notebook Structure
All notebooks in this repository follow a uniform structure defined in the
`init.py` file. This structure ensures consistency across tutorials and makes
it easier for users to navigate and understand the content. Key elements of
this structure include:
- Standard import statements
- Configuration settings
- Helper functions
- Main content sections
- Interactive elements
By adhering to this template, contributors can focus on creating high-quality
content while maintaining a consistent user experience across all tutorials.
## Contributing
We welcome contributions from the community! Whether it's adding new tutorials,
improving existing ones, or suggesting new features, your input is valuable.
Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to
contribute.
## License
This project is licensed under the [MIT License](LICENSE).
## Contact
For questions, suggestions or support, please open an issue in this repository
or reach out to us (maintainers) through our community channels:
marimo socials:
- LinkedIn: [marimo LinkedIn](https://www.linkedin.com/company/marimo-io/)
- Twitter: [@marimo_io](https://twitter.com/marimo_io)
- Discord (proj-marimo-tutorials-channel):
[marimo community](https://discord.gg/JE7nhX6mD8)
