Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/101dotxyz/GPTeam

GPTeam: An open-source multi-agent simulation
https://github.com/101dotxyz/GPTeam

agents ai autogpt gpt-4

Last synced: 3 months ago
JSON representation

GPTeam: An open-source multi-agent simulation

Awesome Lists containing this project

README 

        


  
GPTeam: Collaborative AI Agents


  


    

    

    
 

  Web App

    |  

  Blog Post

  

  


    


    GPTeam

  



## About GPTeam



GPTeam uses GPT-4 to create multiple agents who collaborate to achieve predefined goals. The main objective of this project is to explore the potential of GPT models in enhancing multi-agent productivity and effective communication.



See a video demo here: https://www.youtube.com/watch?v=cIxhI1d6NsM



Read more about the architecture here: https://blog.langchain.dev/gpteam-a-multi-agent-simulation/



## Getting started



To begin exploring GPTeam, follow these steps:



1. Clone the project repository to your local machine

2. Move to the repository: `cd gpteam`

3. Run `python setup.py` to check your environment setup and configure it as needed

4. Update the environment variables in `.env` with your API Keys. You will need an OpenAI API key, which you can obtain [here](https://platform.openai.com/account/api-keys). Supplying API keys for optional services will enable the use of other tools.

5. Launch the world by running `poetry run world`



To run the world cheaply, you can use `poetry run world --turbo`. This will use gpt3.5-turbo for all LLM calls which is a lot cheaper, but expect worse results!



Now you can observe the world in action and watch as the agents interact with each other, working together to accomplish their assigned directives.



## How it works



GPTeam employs separate agents, each equipped with a memory, that interact with one another using communication as a tool. The implementation of agent memory and reflection is inspired by [this research paper](https://arxiv.org/pdf/2304.03442.pdf). Agents move around the world and perform tasks in different locations, depending on what they are doing and where other agents are located. They can speak to eachother and collaborate on tasks, working in parallel towards common goals.



## Viewing Agents



The world is a busy place! To get a view of what different agents are doing whilst the world is running, you can visit the `agents/` folder where there is a txt file for each agent containing a summary of their current state.



## Changing the world



To change the world, all you need to do is:



1. Make changes to the `config.json` by updating the available agents or locations

2. Reset your database: `poetry run db-reset`

3. Run the world again: `poetry run world`



## Setting up the Discord Integration



Read through the dedicated [Discord setup docs](DISCORD.md)



## Using with Anthropic Claude



Make sure you have an `ANTHROPIC_API_KEY` in your env, then you can use `poetry run world --claude` which will run the world using `claude-v1` for some calls and `claude-v1-instant` for others.



## Using with Window



Make sure you have the [Window extension](https://windowai.io/) installed, then you can use `poetry run world --window`. Some models may be slow to respond, since the prompts are very long.



## Contributing



We enthusiastically welcome contributions to GPTeam! To contribute, please follow these steps:



1. Fork the project repository to your own account

2. Create a new branch for your changes

3. Implement your changes to the project code

4. Submit a pull request to the main project repository



We will review your pull request and provide feedback as necessary.



## License



Licensed under the [MIT license](LICENSE).