explaingit

antonosika/gpt-engineer

55,219PythonAudience · developerComplexity · 3/5StaleLicenseSetup · moderate

TLDR

Command-line tool that generates working code from plain-English descriptions using AI models like GPT-4 or Claude.

Mindmap

mindmap
  root((repo))
    What it does
      Write code from text
      Modify existing projects
      Generate full codebases
    How it works
      AI model calls
      Structured prompts
      Image support
    Use cases
      Rapid prototyping
      AI workflow testing
      Code generation
    Tech stack
      Python 3.10-3.12
      OpenAI API
      Claude support
    Customization
      Custom preprompts
      Provider selection
      Benchmarking tools

Things people build with this

USE CASE 1

Quickly prototype a software idea by describing it in plain English instead of writing code manually.

USE CASE 2

Experiment with AI-driven code generation workflows and test custom AI agent implementations.

USE CASE 3

Modify and improve existing projects by describing the changes you want in natural language.

USE CASE 4

Benchmark AI models against standard coding datasets to evaluate their performance.

Tech stack

PythonOpenAIClaudepipPoetry

Getting it running

Difficulty · moderate Time to first run · 30min

Requires API key from OpenAI or Anthropic to generate code.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

gpt-engineer is a command-line tool that lets you describe a software project in plain English and then uses an AI model to write and execute the code for you. You write your requirements in a simple text file called "prompt," run the tool, and it generates a working codebase. You can also point it at an existing project and describe improvements, and the AI will modify the code accordingly. The project is described as the original proof-of-concept experimentation platform for AI-driven code generation, and is noted as the precursor to Lovable (formerly gptengineer.app), a commercial product built on the same ideas. Under the hood, the tool calls an AI model (OpenAI's models by default, though it also supports Anthropic's Claude and open-source alternatives) with a structured set of instructions called preprompts that define how the AI should behave as an engineer. You can customize these preprompts to shape the AI's identity and make it remember patterns across projects. It also supports passing images alongside text prompts, which is useful for sharing UI mockups or architecture diagrams as additional context. You would use gpt-engineer if you want to quickly prototype a software idea without writing all the code yourself, or if you want to experiment with AI code generation workflows. It also includes a benchmarking tool for testing custom AI agent implementations against standard coding datasets. The tech stack is Python 3.10 through 3.12, installed via pip or Poetry, and it requires an API key for whichever AI provider you choose.

Copy-paste prompts

Prompt 1
I want to build a todo app with a React frontend and Python backend. Here's my description: [paste your requirements]. Use gpt-engineer to generate the full codebase.
Prompt 2
Take my existing Python project and add authentication using JWT tokens. Describe the changes you want and let gpt-engineer modify the code.
Prompt 3
Create a custom preprompt for gpt-engineer that makes the AI generate code following my team's specific coding standards and patterns.
Prompt 4
Use gpt-engineer's benchmarking tool to test how well Claude performs on a set of coding challenges compared to GPT-4.
Prompt 5
Pass a UI mockup image to gpt-engineer along with a text description to generate a frontend that matches your design.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.