Skip to content
gpt-engineer logo

gpt-engineer

Verified

Open-source tool that turns natural language specs into working code.

Autonomous AgentsGeneral-Purpose 55.2kOpen source
View on GitHub
Updated 2026-06-15
gpt-engineer GitHub repository

What is gpt-engineer?

gpt-engineer serves as a foundational open-source platform for experimenting with AI-driven code generation. Users provide high-level instructions in a prompt file, after which the system handles code creation, execution, and requested modifications without manual intervention.

It operates via a command-line interface that processes project directories containing natural language prompts. The agent can start fresh projects or enhance existing ones, while supporting customizations like alternative preprompts for agent behavior and integration with various models beyond the default.

This tool targets developers and researchers who want a hackable environment for testing AI coding capabilities, including those exploring benchmarks like APPS or MBPP or building custom agent variants.

What you can build with gpt-engineer

New Project Creation

Describe a full application in a prompt file and let the agent generate and execute the initial codebase from scratch.

Codebase Improvements

Point the tool at an existing project folder with update instructions to iteratively refine features or fix issues.

Agent Benchmarking

Use the included bench command to test custom agent implementations against standard datasets for performance evaluation.

Install gpt-engineer

Install
python -m pip install gpt-engineer
  1. 1Install via pip with python -m pip install gpt-engineer or clone the repo and set up with poetry for development.
  2. 2Configure your OpenAI API key through an environment variable, .env file, or custom model settings.
  3. 3Create a project folder and add a plain text file named prompt with your software requirements.
  4. 4Run the gpte command with the project directory path to start generation, adding the -i flag when improving existing code.
  5. 5Review outputs, iterate via new prompts if needed, or explore Docker and browser-based options for alternative setups.

gpt-engineer: pros & cons

Pros

  • +Highly customizable through editable preprompts and support for local or alternative models.
  • +Straightforward CLI workflow that requires minimal setup for both new and existing projects.
  • +Includes built-in benchmarking capabilities for evaluating agent performance on public datasets.
  • +Active community resources like Discord and research documents for further experimentation.

Cons

  • Depends on external API keys and may incur costs for model usage during extended sessions.
  • Primarily command-line focused, which could limit accessibility for non-technical users.
  • Requires manual folder and prompt management rather than offering a graphical interface.
Did you find this helpful?

Frequently asked questions

It works with OpenAI by default but allows custom setups including local models and Azure through configuration options.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Sign in to review

Promote gpt-engineer

Add this badge to your website, or share the tool.

DFeatured on Dhanasvigpt-engineer 2