new-modular-project

Initializes new Mojo or MAX projects with pixi, uv, pip, or conda environments.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/shakfu/mdsp --skill new-modular-project-shakfu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new-modular-project
Source: https://github.com/shakfu/mdsp/tree/main/.claude/skills/new-modular-project
Command: npx skills add https://github.com/shakfu/mdsp --skill new-modular-project-shakfu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Mojo or MAX project requires choosing the right package manager, channel (nightly or stable), and install commands, and mistakes like mixing MAX and Mojo versions cause kernel compilation failures. This Skill guides the setup interactively and runs the correct initialization commands. ## Core Features & Use Cases - Guided Project Setup: Infers options from your request and asks only for missing choices (project name, Mojo vs MAX, environment manager, channel) in a single structured prompt. - Multi-Manager Support: Provides exact commands for pixi (recommended), uv (full project or quick venv), pip, and conda, on both nightly and stable channels. - Version Alignment: Ensures MAX and Mojo come from the same channel, recommending max[all] or max-all to avoid kernel compilation failures from mismatched versions. - Use Case: You say "create a new Mojo project called dsp-lib". The Skill infers type=Mojo and name=dsp-lib, asks only about the environment manager, then runs the correct pixi init and pixi add mojo commands. ## Quick Start Create a new Mojo project called my-app using pixi on the stable channel.

Frequently Asked Questions about new-modular-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Mojo project?▼

Create a new Mojo project with pixi by running `pixi init myproject -c https://conda.modular.com/max/ -c conda-forge`, then `pixi add mojo` and `pixi shell`. Alternatively use uv with `uv init` followed by `uv add "max[all]"` for the stable channel.

Should I use pixi or uv for Mojo projects?▼

Pixi is the recommended manager for Mojo and MAX projects because it manages Python, Mojo, and other dependencies reproducibly in one environment. Uv works well too, especially for developers coming from a Python background, via either a full uv project or a quick venv.

Why do my MAX and Mojo versions not match?▼

MAX and Mojo number releases differently, so matching versions look mismatched: stable is max 26.5 with mojo 1.0.0. What matters is that both come from the same channel; install `max[all]` with pip/uv or `max-all` with conda/pixi to guarantee alignment.

Can I use Mojo on Windows?▼

Mojo does not run natively on Windows. Install WSL2 with `wsl --install` in PowerShell, then follow the Linux installation instructions inside the WSL environment, including installing gcc as the C linker.

Why does pip fail to install Mojo nightly?▼

Nightly installs fail when using `--index-url` because it replaces PyPI, and the Modular nightly index lacks third-party dependencies like numpy. Use `--extra-index-url https://whl.modular.com/nightly/simple/` with `--pre` instead.