---
name: "Generate and iterate on a local codebase from a natural-language spec with gpt-engineer"
slug: "generate-and-iterate-on-a-local-codebase-from-a-natural-language-spec-with-gpt-engineer"
description: "Use gpt-engineer when an agent/operator needs to turn a prompt file into a local project scaffold, inspect the generated code, and run a supervised improvement loop before adopting the result."
github_stars: 55220
verification: "security_reviewed"
source: "https://github.com/AntonOsika/gpt-engineer"
author: "AntonOsika / gpt-engineer community"
publisher_type: "open_source"
category: "Developer Tools"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "AntonOsika/gpt-engineer"
  github_stars: 55220
---

# Generate and iterate on a local codebase from a natural-language spec with gpt-engineer

Use gpt-engineer when an agent/operator needs to turn a prompt file into a local project scaffold, inspect the generated code, and run a supervised improvement loop before adopting the result.

## Prerequisites

Python, pip, OpenAI-compatible or supported model API key, gpte CLI

## Installation

Use the upstream install or setup path that matches your environment:
- Use Docker ([instructions](docker/README.md))

Requirements and caveats from upstream:
- python -m pip install gpt-engineer
- We actively support Python 3.10 - 3.12. The last version to support Python 3.8 - 3.9 was [0.2.6](https://pypi.org/project/gpt-engineer/0.2.6/).

Basic usage or getting-started notes:
- For **stable** release:
- For **development**:
- git clone https://github.com/gpt-engineer-org/gpt-engineer.git

- Source: https://github.com/AntonOsika/gpt-engineer
- Extracted from upstream docs: https://raw.githubusercontent.com/AntonOsika/gpt-engineer/HEAD/README.md

## Documentation

- https://gpt-engineer.readthedocs.io/en/latest/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/generate-and-iterate-on-a-local-codebase-from-a-natural-language-spec-with-gpt-engineer/)