"Programmers have programmed themselves out of jobs" - Unknown

tddGPT 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. Currently, it can build simple CRUD apps. The TDD framework keeps the agent focused and goal-oriented.

The 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 GPT-4 itself over the course of a month-long chat interaction. I initially aimed to test the boundaries of GPT-4's capabilities in building ReactJS apps, and was successful in teaching it to construct applications step by step. In the process, it gained an understanding of temporal concepts like past, present, and future, as well as cause and effect.

The 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.

This project is in early alpha stage. GPT-4 API key is required.

1. Setup a virtual environment:

python3 -m venv env

2. Activate the virtual environment:

• On macOS and Linux:

  source env/bin/activate
  

• On Windows:

  .\env\Scripts\activate
  

3. Clone the repository to your local machine:

git clone [email protected]:gimlet-ai/tdd-gpt-agent.git

4. Navigate to the project directory:

cd tdd-gpt-agent

5. Run the following command to install the package and its dependencies:

python setup.py install

6. Set up your GPT-4 API keys as environment variables.

export OPENAI_API_KEY="sk-..."

7. Run tdd-gpt-agent

tdd-gpt --prompt 'Build a minimal counter app in ReactJS with increment, decrement, and reset functions'

Check the counter-app directory for the generated app.

The following are some apps have been built by this agent.

• Task Tracker - built with GPT4
• Counter App - built with fine-tuned GPT3.5

• Aider
• Smol Developer
• GPT-Engineer
• Mentat

We 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.

This project is open source, under the MIT license.

If you have any questions or comments, please feel free to reach out to us on GitHub.