GPTTeam

Multi-Agent Systems 💻 Python ⚖️ MIT 🟢 Actively maintained
1.7k stars

GPTeam is an open-source project that uses GPT-4 to create multiple AI agents that collaborate to achieve predefined goals. It explores the potential of GPT models in enhancing multi-agent productivity and communication. It is for developers and researchers interested in multi-agent simulations and AI collaboration.

GPTeam v1.1

🎬 GPTeam v1.1 · Citizen Bean

✨ Key features

  • Multiple agents with individual memory and reflection
  • Agents communicate and collaborate using tools
  • Agents move and perform tasks in different locations
  • Supports GPT-4, GPT-3.5-turbo, Claude, and Window models
  • Configurable world via config.json
  • Discord integration for external communication

🎯 Use cases

  • Simulating collaborative problem-solving among AI agents
  • Researching multi-agent communication and productivity
  • Building interactive AI worlds with autonomous agents
  • Testing different LLM backends in a multi-agent setup

📦 Installation

🧰 Requirements: Python environment with Poetry, OpenAI API key (or Anthropic API key for Claude), and optionally Window extension for using local models.

Clone the repository
git clone https://github.com/101dotxyz/GPTeam.git
cd gpteam
Run setup script
python setup.py
Launch the world
poetry run world

🚀 Usage

Run the world with default settings (GPT-4)
poetry run world
Run with cheaper GPT-3.5-turbo
poetry run world --turbo
Run with Claude
poetry run world --claude
Run with Window (local models)
poetry run world --window

⚠️ Good to know

The project is a simulation and may produce unexpected results; using GPT-3.5-turbo yields worse results than GPT-4.

❓ FAQ

How do I change the agents or locations in the world?

Edit the config.json file to update available agents or locations, then reset the database with poetry run db-reset and run the world again.

Can I use GPTeam with models other than GPT-4?

Yes, you can use --turbo for GPT-3.5-turbo, --claude for Anthropic Claude (requires ANTHROPIC_API_KEY), and --window for Window extension models.

How can I see what agents are doing?

While the world is running, check the agents/ folder where each agent has a txt file with a summary of their current state.

How do I set up Discord integration?

Follow the dedicated Discord setup documentation in the DISCORD.md file.

📊 Repository

Stars★ 1,723
Forks🍴 251
Open issues🐛 40
Last commit🕒 Sep 3, 2026
Created📅 Apr 2023
Language💻 Python
License⚖️ MIT

🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.