Package: gpt-pilot
🧑‍✈️ GPT PILOTGPT Pilot is a true AI developer that writes code, debugs it, talks to you when it needs help, etc.You specify what kind of app you want to build. Then, GPT Pilot asks clarifying questions, creates the product and technical requirements, sets up the environment, andstarts coding the app step by step, like in real life, while you oversee the development process. It asks you to review each task it finishes or to help when it gets stuck. This way, GPT Pilot acts as a coder while you are a lead dev who reviews code and helps when needed.GPT Pilot is the core technology for theVS Code extensionthat aims to providethe first real AI developer companion. Not just an autocomplete or a helper for PR messages but rather a real AI developer that can write full features, debug them, talk to you about issues, ask for review, etc.📫 If you would like to get updates on future releases or just get in touch, youcan add your email here. 📬🔌 Requirements🚦How to start using gpt-pilot?🐳 How to start gpt-pilot in docker?🧑‍💻️ CLI arguments🔎 ExamplesReal-time chat appMarkdown editorTimer app🏛 Main pillars of GPT Pilot🏗 How GPT Pilot works?🕴How's GPT Pilot different fromSmol developerandGPT engineer?🍻 Contributing🔗 Connect with us🌟 Star historyGPT Pilot aims to research how much GPT-4 can be utilized to generate fully working, production-ready apps while the developer oversees the implementation.The main idea is that AI can write most of the code for an app (maybe 95%), but for the rest, 5%, a developer is and will be needed until we get full AGI.I've broken down the idea behind GPT Pilot and how it works in the following blog posts:[Part 1/3] High-level concepts + GPT Pilot workflow until the coding part[Part 2/3] GPT Pilot coding workflow[Part 3/3] Other important concepts and future plans (COMING UP)👉 Examples of apps written by GPT Pilot 👈https://github.com/Pythagora-io/gpt-pilot/assets/10895136/0495631b-511e-451b-93d5-8a42acf22d3d🔌 RequirementsPython 3.9+PostgreSQL(Optional, default database is SQLite)DB is needed for multiple reasons like continuing app development. If you have to stop at any point or the app crashes, go back to a specific step so that you can change some later steps in development, and easier debugging, in future we will add functionality to update project (change some things in existing project or add new features to the project and so on).🚦How to start using gpt-pilot?👉 If you are using VS Code as your IDE, the easiest way to start is by downloadingGPT Pilot VS Code extension. 👈Otherwise, you can use the CLI tool.After you have Python and (optionally) PostgreSQL installed, follow these steps:git clone https://github.com/Pythagora-io/gpt-pilot.git(clone the repo)cd gpt-pilotpython -m venv pilot-env(create a virtual environment)source pilot-env/bin/activate(or on Windowspilot-env\Scripts\activate) (activate the virtual environment)pip install -r requirements.txt(install the dependencies)cd pilotmv .env.example .env(or on Windowscopy .env.example .env) (create the .env file)Add your environment to the.envfile:LLM Provider (OpenAI/Azure/Openrouter)Your API keydatabase settings: SQLite/PostgreSQL (to change from SQLite to PostgreSQL, just setDATABASE_TYPE=postgres)optionally set IGNORE_PATHS for the folders which shouldn't be tracked by GPT Pilot in workspace, useful to ignore folders created by compilers (i.e.IGNORE_PATHS=folder1,folder2,folder3)python db_init.py(initialize the database)python main.py(start GPT Pilot)After, this, you can just follow the instructions in the terminal.All generated code will be stored in the folderworkspaceinside the folder named after the app name you enter upon starting the pilot.🐳 How to start gpt-pilot in docker?git clone https://github.com/Pythagora-io/gpt-pilot.git(clone the repo)Update thedocker-compose.ymlenvironment variables, which can be done viadocker compose config. If you wish to use a local model, please go tohttps://localai.io/basics/getting_started/.By default, GPT Pilot will read & write to~/gpt-pilot-workspaceon your machine, you can also edit this indocker-compose.ymlrundocker compose build. this will build a gpt-pilot container for you.rundocker compose up.access the web terminal onport 7681python db_init.py(initialize the database)python main.py(start GPT Pilot)This will start two containers, one being a new image built by theDockerfileand a Postgres database. The new image also hasttydinstalled so that you can easily interact with gpt-pilot. Node is also installed on the image and port 3000 is exposed.🧑‍💻️ CLI argumentsapp_typeandnameIf not provided, the ProductOwner will ask for these values:app_typeis used as a hint to the LLM as to what kind of architecture, language options and conventions would apply. If not provided,prompts.prompts.ask_for_app_type()will ask for it.Seeconst.common.APP_TYPES: 'Web App', 'Script', 'Mobile App', 'Chrome Extension'app_idandworkspaceContinue working on an existing app usingapp_idpythonmain.pyapp_id=<ID_OF_THE_APP>orworkspacepath:pythonmain.pyworkspace=<PATH_TO_PROJECT_WORKSPACE>Each user can have their own workspace path for each App.user_id,email, andpasswordThese values will be saved to the User table in the DB.pythonmain.pyuser_id=me_at_workIf not specified,user_iddefaults to the OS username but can be provided explicitly if your OS username differs from your GitHub or work username. This value is used to load theAppconfig when theworkspacearg is provided.If not specifiedemailwill be parsed from~/.gitconfigif the file exists.See alsoWhat's the purpose of arguments.password / User.password?advancedThe Architect, by default, favors certain technologies, including:Node.JSMongoDBPeeWee ORMJest & PyUnitBootstrapVanilla JavaScriptSocket.ioIf you have your own preferences, you can have a deeper conversation with the Architect.pythonmain.pyadvanced=TruestepContinue working on an existing app from a specificstep(eg:user_tasks)pythonmain.pyapp_id=<ID_OF_THE_APP>step=<STEP_FROM_CONST_COMMON>skip_until_dev_stepContinue working on an existing app from a specificdevelopment steppythonmain.pyapp_id=<ID_OF_THE_APP>skip_until_dev_step=<DEV_STEP>This is basically the same asstepbut during the development process. If you want to play around with gpt-pilot, this is likely the flag you will often use.Erase all development steps previously done and continue working on an existing app from the start of development.pythonmain.pyapp_id=<ID_OF_THE_APP>skip_until_dev_step=0themepythonmain.pytheme=lightpythonmain.pytheme=darkDark mode.delete_unrelated_stepsupdate_files_before_start🔎 ExamplesHere are a couple of example apps GPT Pilot created by itself:📱 Real-time chat app💬 Prompt:A simple chat app with real-time communication▶️Video of the app creation process💻️GitHub repo📝 Markdown editor💬 Prompt:Build a simple markdown editor using HTML, CSS, and JavaScript. Allow users to input markdown text and display the formatted output in real-time.▶️Video of the app creation process💻️GitHub repo⏱️ Timer app💬 Prompt:Create a simple timer app using HTML, CSS, and JavaScript that allows users to set a countdown timer and receive an alert when the time is up.▶️Video of the app creation process💻️GitHub repo🏗 How GPT Pilot works?Here are the steps GPT Pilot takes to create an app:You enter the app name and the description.Product Owner agentasks a couple of questions to understand the requirements better.Product Owner agentwrites user stories and asks you if they are all correct (this helps it create code later on).Architect agentwrites up technologies that will be used for the app.DevOps agentchecks if all technologies are installed on the machine and installs them if not.Tech Lead agentwrites up development tasks that the Developer must implement. This is an important part because, for each step, the Tech Lead needs to specify how the user (real-world developer) can review if the task is done (e.g. open localhost:3000 and do something).Developer agenttakes each task and writes up what needs to be done to implement it. The description is in human-readable form.Finally,Code Monkey agenttakes the Developer's description and the existing file and implements the changes. We realized this works much better than giving it to the Developer right away to implement changes.For more details on the roles of agents employed by GPT Pilot, please take a look atAGENTS.md🕴How's GPT Pilot different fromSmol developerandGPT engineer?GPT Pilot works with the developer to create a fully working production-ready app- I don't think AI can (at least in the near future) create apps without a developer being involved. So,GPT Pilot codes the app step by stepjust like a developer would in real life. This way, it can debug issues as they arise throughout the development process. If it gets stuck, you, the developer in charge, can review the code and fix the issue. Other similar tools give you the entire codebase at once - this way, bugs are much harder to fix for AI and for you as a developer.Works at scale- GPT Pilot isn't meant to create simple apps but rather so it can work at any scale. It has mechanisms that filter out the code, so in each LLM conversation, it doesn't need to store the entire codebase in context, but it shows the LLM only the relevant code for the current task it's working on. Once an app is finished, you can continue working on it by writing instructions on what feature you want to add.🍻 ContributingIf you are interested in contributing to GPT Pilot, I would be more than happy to have you on board and also help you get started. Feel free to pingzvonimir@pythagora.ai, and I'll help you get started.🔬️ ResearchSince this is a research project, there are many areas that need to be researched on both practical and theoretical levels. We're happy to hear how the entire GPT Pilot concept can be improved. For example, maybe it would work better if we structured functional requirements differently, or maybe technical requirements need to be specified in a different way.🖥 DevelopmentOther than the research, GPT Pilot needs to be debugged to work in different scenarios. For example, we realized that the quality of the code generated is very sensitive to the size of the development task. When the task is too broad, the code has too many bugs that are hard to fix, but when the development task is too narrow, GPT also seems to struggle in getting the task implemented into the existing code.📊 TelemetryTo improve GPT Pilot, we are tracking some events from which you can opt out at any time. You can read more about ithere.🔗 Connect with us🌟 As an open-source tool, it would mean the world to us if you starred the GPT-pilot repo 🌟💬 Jointhe Discord serverto get in touch.🌟 Star History