{"id":18693724,"url":"https://github.com/antonosika/gpt-engineer","last_synced_at":"2025-09-09T20:54:35.646Z","repository":{"id":173039012,"uuid":"634224458","full_name":"AntonOsika/gpt-engineer","owner":"AntonOsika","description":"CLI platform to experiment with codegen. Precursor to: https://lovable.dev","archived":false,"fork":false,"pushed_at":"2024-11-17T22:47:32.000Z","size":20607,"stargazers_count":54075,"open_issues_count":38,"forks_count":7095,"subscribers_count":527,"default_branch":"main","last_synced_at":"2025-05-05T16:05:54.262Z","etag":null,"topics":["ai","autonomous-agent","code-generation","codebase-generation","codegen","coding-assistant","gpt-4","gpt-engineer","openai","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AntonOsika.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"citation.cff","codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["antonosika"],"patreon":"gpt_eng"}},"created_at":"2023-04-29T12:52:15.000Z","updated_at":"2025-05-05T15:32:37.000Z","dependencies_parsed_at":"2023-09-26T21:18:57.161Z","dependency_job_id":"49e421f2-e691-453c-bdec-66f798a9e904","html_url":"https://github.com/AntonOsika/gpt-engineer","commit_stats":null,"previous_names":["antonosika/gpt-engineer"],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonOsika%2Fgpt-engineer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonOsika%2Fgpt-engineer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonOsika%2Fgpt-engineer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonOsika%2Fgpt-engineer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AntonOsika","download_url":"https://codeload.github.com/AntonOsika/gpt-engineer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253818532,"owners_count":21969180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","autonomous-agent","code-generation","codebase-generation","codegen","coding-assistant","gpt-4","gpt-engineer","openai","python"],"created_at":"2024-11-07T11:01:43.323Z","updated_at":"2025-05-12T20:45:04.543Z","avatar_url":"https://github.com/AntonOsika.png","language":"Python","readme":"# gpt-engineer\n\n[![GitHub Repo stars](https://img.shields.io/github/stars/gpt-engineer-org/gpt-engineer?style=social)](https://github.com/gpt-engineer-org/gpt-engineer)\n[![Discord Follow](https://dcbadge.vercel.app/api/server/8tcDQ89Ej2?style=flat)](https://discord.gg/8tcDQ89Ej2)\n[![License](https://img.shields.io/github/license/gpt-engineer-org/gpt-engineer)](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/LICENSE)\n[![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/gpt-engineer-org/gpt-engineer)](https://github.com/gpt-engineer-org/gpt-engineer/issues)\n![GitHub Release](https://img.shields.io/github/v/release/gpt-engineer-org/gpt-engineer)\n[![Twitter Follow](https://img.shields.io/twitter/follow/antonosika?style=social)](https://twitter.com/antonosika)\n\nThe OG code genereation experimentation platform!\n\nIf you are looking for the evolution that is an opinionated, managed service – check out gptengineer.app.\n\nIf you are looking for a well maintained hackable CLI for – check out aider.\n\n\ngpt-engineer lets you:\n- Specify software in natural language\n- Sit back and watch as an AI writes and executes the code\n- Ask the AI to implement improvements\n\n## Getting Started\n\n### Install gpt-engineer\n\nFor **stable** release:\n\n- `python -m pip install gpt-engineer`\n\nFor **development**:\n- `git clone https://github.com/gpt-engineer-org/gpt-engineer.git`\n- `cd gpt-engineer`\n- `poetry install`\n- `poetry shell` to activate the virtual environment\n\nWe 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/).\n\n### Setup API key\n\nChoose **one** of:\n- Export env variable (you can add this to .bashrc so that you don't have to do it each time you start the terminal)\n    - `export OPENAI_API_KEY=[your api key]`\n- .env file:\n    - Create a copy of `.env.template` named `.env`\n    - Add your OPENAI_API_KEY in .env\n- Custom model:\n    - See [docs](https://gpt-engineer.readthedocs.io/en/latest/open_models.html), supports local model, azure, etc.\n\nCheck the [Windows README](./WINDOWS_README.md) for Windows usage.\n\n**Other ways to run:**\n- Use Docker ([instructions](docker/README.md))\n- Do everything in your browser:\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/gpt-engineer-org/gpt-engineer/codespaces)\n\n### Create new code (default usage)\n- Create an empty folder for your project anywhere on your computer\n- Create a file called `prompt` (no extension) inside your new folder and fill it with instructions\n- Run `gpte \u003cproject_dir\u003e` with a relative path to your folder\n  - For example: `gpte projects/my-new-project` from the gpt-engineer directory root with your new folder in `projects/`\n\n### Improve existing code\n- Locate a folder with code which you want to improve anywhere on your computer\n- Create a file called `prompt` (no extension) inside your new folder and fill it with instructions for how you want to improve the code\n- Run `gpte \u003cproject_dir\u003e -i` with a relative path to your folder\n  - For example: `gpte projects/my-old-project -i` from the gpt-engineer directory root with your folder in `projects/`\n\n### Benchmark custom agents\n- gpt-engineer installs the binary 'bench', which gives you a simple interface for benchmarking your own agent implementations against popular public datasets.\n- The easiest way to get started with benchmarking is by checking out the [template](https://github.com/gpt-engineer-org/gpte-bench-template) repo, which contains detailed instructions and an agent template.\n- Currently supported benchmark:\n  - [APPS](https://github.com/hendrycks/apps)\n  - [MBPP](https://github.com/google-research/google-research/tree/master/mbpp)\n\nThe community has started work with different benchmarking initiatives, as described in [this Loom](https://www.loom.com/share/206805143fbb4302b5455a5329eaab17?sid=f689608f-8e49-44f7-b55f-4c81e9dc93e6) video.\n\n### Research\nSome of our community members have worked on different research briefs that could be taken further. See [this document](https://docs.google.com/document/d/1qmOj2DvdPc6syIAm8iISZFpfik26BYw7ZziD5c-9G0E/edit?usp=sharing) if you are interested.\n\n## Terms\nBy running gpt-engineer, you agree to our [terms](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/TERMS_OF_USE.md).\n\n\n## Relation to gptengineer.app (GPT Engineer)\n[gptengineer.app](https://gptengineer.app/) is a commercial project for the automatic generation of web apps.\nIt features a UI for non-technical users connected to a git-controlled codebase.\nThe gptengineer.app team is actively supporting the open source community.\n\n\n## Features\n\n### Pre Prompts\nYou can specify the \"identity\" of the AI agent by overriding the `preprompts` folder with your own version of the `preprompts`. You can do so via the `--use-custom-preprompts` argument.\n\nEditing the `preprompts` is how you make the agent remember things between projects.\n\n### Vision\n\nBy default, gpt-engineer expects text input via a `prompt` file. It can also accept image inputs for vision-capable models. This can be useful for adding UX or architecture diagrams as additional context for GPT Engineer. You can do this by specifying an image directory with the `—-image_directory` flag and setting a vision-capable model in the second CLI argument.\n\nE.g. `gpte projects/example-vision gpt-4-vision-preview --prompt_file prompt/text --image_directory prompt/images -i`\n\n### Open source, local and alternative models\n\nBy default, gpt-engineer supports OpenAI Models via the OpenAI API or Azure OpenAI API, as well as Anthropic models.\n\nWith a little extra setup, you can also run with open source models like WizardCoder. See the [documentation](https://gpt-engineer.readthedocs.io/en/latest/open_models.html) for example instructions.\n\n## Mission\n\nThe gpt-engineer community mission is to **maintain tools that coding agent builders can use and facilitate collaboration in the open source community**.\n\nIf you are interested in contributing to this, we are interested in having you.\n\nIf you want to see our broader ambitions, check out the [roadmap](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/ROADMAP.md), and join\n[discord](https://discord.gg/8tcDQ89Ej2)\nto learn how you can [contribute](.github/CONTRIBUTING.md) to it.\n\ngpt-engineer is [governed](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/GOVERNANCE.md) by a board of long-term contributors. If you contribute routinely and have an interest in shaping the future of gpt-engineer, you will be considered for the board.\n\n## Significant contributors\n\u003cul style=\"list-style-type: none; padding: 0; display: flex; flex-wrap: wrap;\"\u003e \u003cli style=\"margin-right: 10px; margin-bottom: 10px;\"\u003e \u003ca href=\"https://github.com/ATheorell\"\u003e \u003cimg src=\"https://avatars.githubusercontent.com/u/143704446?s=64\u0026v=4\" alt=\"@ATheorell\" width=\"32\" height=\"32\" style=\"border-radius: 50%;\"\u003e @ATheorell \u003c/a\u003e \u003c/li\u003e \u003cli style=\"margin-right: 10px; margin-bottom: 10px;\"\u003e \u003ca href=\"https://github.com/similato87\"\u003e \u003cimg src=\"https://avatars.githubusercontent.com/u/71301573?s=64\u0026v=4\" alt=\"@similato87\" width=\"32\" height=\"32\" style=\"border-radius: 50%;\"\u003e @similato87 \u003c/a\u003e \u003c/li\u003e \u003cli style=\"margin-right: 10px; margin-bottom: 10px;\"\u003e \u003ca href=\"https://github.com/TheoMcCabe\"\u003e \u003cimg src=\"https://avatars.githubusercontent.com/u/9841960?s=64\u0026v=4\" alt=\"@TheoMcCabe\" width=\"32\" height=\"32\" style=\"border-radius: 50%;\"\u003e @TheoMcCabe \u003c/a\u003e \u003c/li\u003e \u003cli style=\"margin-right: 10px; margin-bottom: 10px;\"\u003e \u003ca href=\"https://github.com/captivus\"\u003e \u003cimg src=\"https://avatars.githubusercontent.com/u/366332?s=64\u0026v=4\" alt=\"@captivus\" width=\"32\" height=\"32\" style=\"border-radius: 50%;\"\u003e @captivus \u003c/a\u003e \u003c/li\u003e \u003c/ul\u003e\n\n\n## Example\n\n\n\nhttps://github.com/gpt-engineer-org/gpt-engineer/assets/4467025/40d0a9a8-82d0-4432-9376-136df0d57c99\n","funding_links":["https://github.com/sponsors/antonosika","https://patreon.com/gpt_eng"],"categories":["Others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonosika%2Fgpt-engineer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantonosika%2Fgpt-engineer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonosika%2Fgpt-engineer/lists"}