Spawn

Spawn is a command-line tool that eliminates the repetitive setup work involved in starting a new Python project. Instead of manually creating folders, initializing Git, setting up a virtual environment, and installing dependencies one by one, Spawn handles all of it in a single command.

Running spawn create walks you through a short series of prompts and generates a fully structured project based on the type of application you're building. It offers eight built-in templates covering common project types: Backend API (with FastAPI, Flask, or Django), CLI Application (Typer, Click, or Argparse), Automation Tool, AI Chatbot, AI Agent, RAG System, Data Project (analysis, dashboard, ETL, or machine learning), and MCP Server. Each template comes with a sensible folder structure, starter code, and optional extras like linting (Ruff), testing (Pytest), Docker support, and GitHub Actions, all wired up automatically.

For projects that don't fit any of the built-in templates, Spawn also supports a "bring your own structure" mode. You can paste any folder layout, whether in tree format, a Markdown list, or plain indented text, and Spawn will parse it and recreate that exact structure, complete with a generated README and a properly configured .gitignore.

Beyond project creation, Spawn includes a doctor command that analyzes an existing project and scores its overall health across six categories: documentation, version control, configuration, testing, automation, and code quality. It returns a percentage score along with a prioritized list of recommendations, so you know exactly what to fix first.

Spawn also supports a non-interactive mode for scripting and automation, accepting either command-line flags or a JSON configuration file to scaffold a project with zero prompts. It can optionally initialize a Git repository, create and push to an existing GitHub repo, and generate agent context files (AGENTS.md and CLAUDE.md) for use with AI coding assistants.

Built on top of uv for fast dependency management, Spawn is open source under the MIT license and available on PyPI.