NOTE: We are now integrated into AgentVerse!
🌎GPTWorld is an experimental multi-agent sandbox world. Unlike typical sandbox games, interactions in GPTWorld are not fully defined by pre-written scripts 📜 and rules📏, but rather inferred by a world engine based on large models 🤖. In this world, the whole environment, including agents and objects, is supported by large models, providing great autonomy and diversity.
The creation of a sandbox world is often considered to require advanced game development techniques that are beyond the reach of most individuals. This is where 🌎GPTWorld comes to the rescue! 🛠️ Our goal is to make the process of creating a diverse range of sandboxes more accessible by enabling players to construct custom worlds using simple configuration files or even natural language 🤩.
Through this easy-to-use world creation feature, we hope to inspire everyone to construct their own unique worlds. As a result, a vibrant sandbox environment community will emerge, allowing intelligent agents to explore various creations through community sharing 🤝.
👨💻👩💻 Join us on this exciting journey of creating a groundbreaking sandbox world with limitless possibilities 🚀!
👨💻 Create with JSON: Easily creating your environment and entities using JSON and mounting them onto your world
🏃 Start World Engine: Starting the environment's autonomous operation with just one command.
👀 Demo: Observing the behavior of the agent in your web browser.
🗣️ Create with NL: Creating environments with natural languages.
❗️ Polishing: Feeling that the current behavior of agents is not very reasonable? Don't worry, we are improving it!
❗️ Refactoring: We are also using AgentVerse to refactor the behavior of agents!
🤝 Distributed: Allowing players to build and share environments in a distributed way.
We strongly recommend to use python=3.8 on all platforms.
- Download project by
git clone https://github.com/ShengdingHu/GPT-World.git- (Optional) Create a python virtual enviornment by
conda create -n gptworld python=3.8
- Please note that Python 3.8 provides the best support for
flask-socketio, whereas other versions of Python may currently encounter issues with web display. *
- Go to project directory by
cd GPT-World
- Install dependencies by
pip install -r requirements.txt- Then install this library by
pip install .- Build the front end
cd io/frontend/rpg-game/
npm install
npm run buildWe currently provide some example sandboxes in world_instances/, choose one that you want to launch.
Take alice_home as an example.
- start the world engine
python gptworld/run.py -W alice_home
- start the web server
python io/app.py -W alice_home
now open the 5001 port of your localhost(http://0.0.0.0:5001/), and you will be able to see a wonderful
environment full of GPT-drived agents and objects!
If
http://0.0.0.0:5001/is not working, you may tryhttp://127.0.0.1:5001/.
If you want to create your world instance,
run gptworld/create_world.py -W <world_instance> -I <info>, where <world_instance> stands for the name of the world
directory in the ./world_instances/ directory, and <info> stands for the
initial information about the world to be created. Remember to add specific information into the <info> argument,
the more detailed, the better.
e.g. -W neighborhood -I "A neighborhood with some Chinese restaurants (with a cook, tables, chairs, delicious foods), and coffee bar (coffee machine, coffee staff), 711 shop (stocks, drinks, snacks, etc), trees, grass area (with flower, old people, etc), roads (with some cars, bikes), Alice's house and Bob's house (includes some furniture , like sofa, bed, bookshelf, cooker, and their families, a yard with two apple trees, etc), all above should be areas, each task could be a subtask, assign the jobs with lots of details, no overlapping areas. Add some people and animals and plants, evenly distributed. Expect more details. Areas should not overlap with each other."
- Log Level:
export GPTWORLD_LOG_LEVEL=<log_level><log_level> can be DEBUG, INFO, WARNING ...) to set the logging level, DEBUG will have a lot of print in command line :
- OpenAI Key
export OPENAI_API_KEY=<your_openai_api_key><your_openai_api_key> refers to your own api key to access to the ChatGPT.
In Windows OS, please add environment variables instead of export methods.
This project was greatly inspired by Generative Agents: Interactive Simulacra of Human Behavior during development, where the mechanism of agents' behavior takes the reflection-summary-plan framework.
This project is for academic and experimental purposes only. We currently suspect that it is far from a usable game product.
Made with contrib.rocks.