🏝️ OASIS is a scalable, open-source social media simulator that incorporates large language model agents to realistically mimic the behavior of up to one million users on platforms like Twitter and Reddit. It's designed to facilitate the study of complex social phenomena such as information spread, group polarization, and herd behavior, offering a versatile tool for exploring diverse social dynamics and user interactions in digital environments.

✨ Key Features

📈 Scalability

OASIS supports simulations of up to one million agents, enabling studies of social media dynamics at a scale comparable to real-world platforms.

📲 Dynamic Environments

Adapts to real-time changes in social networks and content, mirroring the fluid dynamics of platforms like Twitter and Reddit for authentic simulation experiences.

👍🏼 Diverse Action Spaces

Agents can perform 23 actions, such as following, commenting, and reposting, allowing for rich, multi-faceted interactions.

🔥 Integrated Recommendation Systems

Features interest-based and hot-score-based recommendation algorithms, simulating how users discover content and interact within social media platforms.

📺 Demo Video

Introducing OASIS: Open Agent Social Interaction Simulations with One Million Agents

https://github.com/user-attachments/assets/3bd2553c-d25d-4d8c-a739-1af51354b15a

For more showcaes:

• Can 1,000,000 AI agents simulate social media? →Watch demo

🎯 Usecase

⚙️ Quick Start

1. Install the OASIS package:

Installing OASIS is a breeze thanks to its availability on PyPI. Simply open your terminal and run:

pip install camel-oasis

2. Set up your OpenAI API key:

# For Bash shell (Linux, macOS, Git Bash on Windows):
export OPENAI_API_KEY=<insert your OpenAI API key>

# For Windows Command Prompt:
set OPENAI_API_KEY=<insert your OpenAI API key>

3. Prepare the agent profile file:

Create the profile you want to assign to the agent. As an example, you can download user_data_36.json and place it in your local ./data/reddit folder.

4. Run the following Python code:

import asyncio
import os

from camel.models import ModelFact