CLI Introduction
The Python CLI is nitrostack-py, installed with pip install nitrostack. It is not nitrostack-cli and not npx @nitrostack/cli.
Bash
nitrostack-py --help
python -m nitrostack.cli.main --help
Commands
| Command | Description |
|---|---|
init | Scaffold a project from python-starter, python-pizzaz, or python-oauth |
dev | Hot-reload development server |
start | Production server (no reload) |
pack | Build a deployable wheel (never includes .env) |
generate | Boilerplate: tool, module, guard, pipe, interceptor, filter, service |
install | Install deps (uv sync or pip) |
upgrade | Bump nitrostack and refresh agent skills |
validate | Lint deps, @mcp_app imports, @module refs |
register | Write Claude Desktop MCP config |
There is no build command. Use pack for an artifact and start to run production.
Typical lifecycle
Bash
nitrostack-py init my-server --template python-starter
cd my-server
nitrostack-py dev
nitrostack-py validate
nitrostack-py pack
nitrostack-py start
Ports
Flags --port and --widget apply to init, dev, and start. Resolution order: CLI flags → env (PORT / MCP_SERVER_PORT, WIDGETS_DEV_PORT) → project .env → defaults 3000 / 3001.