marimo + pixi Starter Template

A starter template for marimo notebooks using pixi for dependency and project management. This template provides a modern Python development setup with best practices for notebook development.

Features

• 🚀 Python 3.12+ support
• 📦 Fast dependency management with pixi
• 🧪 Testing setup with pytest
• 🎯 Code quality with Ruff (linting + formatting)
• 👷 CI/CD with GitHub Actions
• 📓 Interactive notebook development with marimo

Prerequisites

• pixi installed

Getting Started

1. Clone this repository:

   git clone https://github.com/yourusername/marimo-pixi-starter-template
   cd marimo-pixi-starter-template

2. Run the marimo editor:

   pixi run edit

Development

Running Tests

pixi run test

Linting and formatting

pixi run lint
pixi run format

Install pre-commit

pixi run pre-commit-install

Project Structure

├── .github/          # GitHub Actions workflows
├── src/              # Source code
│   └── app.py        # Sample marimo notebook
├── tests/            # Test files
├── pyproject.toml    # Project configuration
└── pixi.lock         # Dependency lock file

License

MIT