{"id":13861615,"url":"https://github.com/gimlet-ai/tddGPT","last_synced_at":"2025-07-14T09:32:42.550Z","repository":{"id":184614848,"uuid":"672200179","full_name":"gimlet-ai/tddGPT","owner":"gimlet-ai","description":"AutoGPT for Web App Development","archived":false,"fork":false,"pushed_at":"2023-12-06T11:28:43.000Z","size":200,"stargazers_count":134,"open_issues_count":31,"forks_count":16,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-08-05T06:03:28.269Z","etag":null,"topics":["auto-gpt","autonomous-agents","codegeneration","fullstack-development","gpt-4"],"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/gimlet-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-29T08:56:51.000Z","updated_at":"2024-08-05T06:03:30.259Z","dependencies_parsed_at":"2024-04-21T04:18:48.805Z","dependency_job_id":null,"html_url":"https://github.com/gimlet-ai/tddGPT","commit_stats":null,"previous_names":["gimlet-ai/dev-gpt","gimlet-ai/tdd-gpt-agent","gimlet-ai/tddgpt"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gimlet-ai%2FtddGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gimlet-ai%2FtddGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gimlet-ai%2FtddGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gimlet-ai%2FtddGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gimlet-ai","download_url":"https://codeload.github.com/gimlet-ai/tddGPT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225968843,"owners_count":17553147,"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":["auto-gpt","autonomous-agents","codegeneration","fullstack-development","gpt-4"],"created_at":"2024-08-05T06:01:26.313Z","updated_at":"2024-11-22T21:30:54.252Z","avatar_url":"https://github.com/gimlet-ai.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Autonomous Agent for Test-Driven Development (TDD)\n\n\"Programmers have programmed themselves out of jobs\" - Unknown\n\n[![tddGPT: ReactJS Counter App with GPT3.5](https://cdn.loom.com/sessions/thumbnails/7f56ab1b478049baa299813c223526bd-with-play.gif)](https://www.loom.com/share/7f56ab1b478049baa299813c223526bd)\n\ntddGPT is an autonomous coding agent that builds applications in ReactJS, Flask, Express, and more, all while adhering to the Test-Driven Development (TDD) methodology. It operates entirely without human intervention. Beginning with a project plan, tddGPT translates requirements into tests, develops code based on those tests, and debugs until all tests pass. The TDD framework keeps the agent focused and goal-oriented.\n\nThe core architecture is elegantly simple, utilizing just three tools: CLI, ReadFile, and WriteFile. It has been adpated from Langchain's AutoGPT example. Most enhancements were performed by ChatGPT Plus itself over the course of a month-long chat. The initially aim was to test the limits of GPT-4's capabilities in building ReactJS apps end-to-end. In the process, it gained an understanding of temporal concepts like past, present, and future, as well as cause and effect.\n\nUtilizing GPT-4 Turbo and GPT-4 Vision, the system is capable of transforming wireframes or screenshots, in conjunction with detailed user stories, into fully functional applications, complete with all necessary tests. The expanded context window of GPT-4 Turbo facilitates its functioning as an integrated team comprising a Product Owner, Programmer, and Tester. This enhanced capacity allows for the handling of significantly more intricate and detailed user stories.\n\nThe agent is not just a code generator; it’s also a learner. It evaluates its mistakes and areas for improvement as a final step, and some of these insights have already been incorporated into its operating prompts.\n\nThis project is in early alpha stage. GPT-4 API key is required. \n\n## Setup Instructions\n\n1. Setup a virtual environment:\n```\npython3 -m venv env\n```\n\n2. Activate the virtual environment:\n- On macOS and Linux:\n  ```\n  source env/bin/activate\n  ```\n- On Windows:\n  ```\n  .\\env\\Scripts\\activate\n  ```\n3. Clone the repository to your local machine:\n```\ngit clone https://github.com/sankethchebbi/tddGPT.git\n\n```\n4. Navigate to the project directory:\n```\ncd tddGPT\n```\n\n5. Run the following command to install the package and its dependencies:\n```\npython setup.py install\n```\n\n6. Set up your GPT-4 API keys as environment variables.\n```\nexport OPENAI_API_KEY=\"sk-...\"\n```\n\n7. Run the main.py\n```\ncd tdd-gpt\npython main.py --model gpt-4-1106-preview or gpt-3.5-turbo --prompt \"Your prompt here\" --temperature 0.2 --context_window 128000\n```\n\nCheck the counter-app directory for the generated app.\n\n## Example apps\n\nThe following are some apps have been built by this agent.\n\n- [Todo App](https://todo-app-tv1.netlify.app/) - built with GPT4 Turbo + GPT4-V\n- [Task Tracker](https://brilliant-biscotti-3f9e48.netlify.app/) - built with GPT4\n- [Counter App](https://counter-app-tddgpt.netlify.app/) - built with fine-tuned GPT3.5\n\n## Similar Projects\n\n- [Aider](https://github.com/paul-gauthier/aider)\n- [Smol Developer](https://github.com/smol-ai/developer)\n- [GPT-Engineer](https://github.com/AntonOsika/gpt-engineer)\n- [Mentat](https://github.com/biobootloader/mentat)\n\n\n## Contributing\n\nWe welcome contributions to this project. Please feel free to submit issues and pull requests. For major changes, please open an issue first to discuss what you would like to change.\n\n\n## License\n\nThis project is open source, under the [MIT license](LICENSE).\n\n## Contact\n\nIf you have any questions or comments, please feel free to reach out to us on GitHub.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgimlet-ai%2FtddGPT","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgimlet-ai%2FtddGPT","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgimlet-ai%2FtddGPT/lists"}