more-compute

An interactive Python notebook environment, similar to Marimo and Google Colab, that runs locally.

https://github.com/user-attachments/assets/8c7ec716-dade-4de2-ad37-71d328129c97

Installation

Prerequisites:

• Node.js v20 (see .nvmrc)
• Python 3.12 (see .python-version)

Using uv (Recommended)

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install more-compute

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install more-compute

Using pip

pip install more-compute

# Add to PATH if needed:
# macOS/Linux: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
# Windows: See troubleshooting below

Usage

more-compute notebook.py     # Open existing notebook
more-compute new             # Create new notebook
more-compute --debug         # Show logs

Opens automatically at http://localhost:2718

Converting Between Formats

MoreCompute uses .py notebooks with # %% cell markers, but you can convert to/from .ipynb:

From .ipynb to .py:

# Auto-detect output name (notebook.ipynb -> notebook.py)
more-compute convert notebook.ipynb

# Or specify output
more-compute convert notebook.ipynb -o my_notebook.py

# Then open in MoreCompute
more-compute my_notebook.py

The converter automatically extracts dependencies from !pip install commands and adds UV inline script metadata.

From .py to .ipynb:

# Auto-detect output name (notebook.py -> notebook.ipynb)
more-compute convert notebook.py

# Or specify output
more-compute convert notebook.py -o colab_notebook.ipynb

This makes your notebooks compatible with Google Colab, Jupyter, and other tools that require .ipynb format.

Troubleshooting

will add things here as things progress...

Development

Option 1: Devcontainer

Works on Mac, Windows, and Linux with identical environments.

Prerequisites: Docker Desktop and VS Code/Cursor with the Dev Containers extension.

1. Clone the repo and open in VS Code/Cursor
2. Press Cmd/Ctrl + Shift + P → "Dev Containers: Reopen in Container"
3. Wait for the container to build (first time takes a few minutes)
4. Run more-compute new in the terminal

Option 2: Docker (No IDE Required)

# Build the image
docker build -t morecompute .

# Run with your notebooks mounted
docker run -p 3141:3141 -p 2718:2718 -v $(pwd):/notebooks morecompute

Option 3: Native Setup

Prerequisites:

• Python 3.12 (install via pyenv: pyenv install 3.12)
• Node.js 20 (install via nvm: nvm install 20)

# Clone and enter directory
git clone https://github.com/DannyMang/MORECOMPUTE.git
cd MORECOMPUTE

# Use pinned versions
pyenv local 3.12  # or: pyenv install 3.12 && pyenv local 3.12
nvm use           # reads .nvmrc automatically

# Create virtual environment and install
uv venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

# Install frontend dependencies
cd frontend && npm ci && cd ..  # npm ci uses package-lock.json for exact versions

# Run
more-compute notebook.py

Environment Variables

License

MIT - see LICENSE