Use Potpie for spec-driven codebase workflows
Index a repository with Potpie, turn it into a code knowledge graph, and drive focused implementation or review tasks from specs.
Prerequisites
Docker; Git; Python 3.11+; uv; configured LLM provider
Installation
Use the upstream install or setup path that matches your environment:
- git clone --recurse-submodules https://github.com/potpie-ai/potpie.git
- uv sync
- pnpm build && pnpm start
Requirements and caveats from upstream:
- Docker installed and running
- Python 3.11+ with uv
- This will start Docker services, apply migrations, start the FastAPI app, and start the Celery worker.
Basic usage or getting-started notes:
Git installed
Clone the repository
bash
Extracted from upstream docs: https://raw.githubusercontent.com/potpie-ai/potpie/HEAD/README.md