General Introduction
OASIS (Open Agent Social Interaction Simulations) is an open source social media simulator capable of simulating the behavior of up to one million users. The platform combines large-scale language models and rule-based agents designed to realistically reproduce user behavior on social media platforms such as Twitter and Reddit.OASIS is designed to study complex social phenomena such as information dissemination, group polarization, and herding effects. Through its dynamically updated environment and diverse operating space, OASIS provides a powerful tool for studying social dynamics in digital environments.
Function List
- Large-scale simulation: Supports the interaction of up to one million agents, simulating the dynamics of real social media platforms.
- dynamic environment: Adapt to real-time changes in social networks and content to provide a realistic simulation experience.
- Multiple operations: Agents can perform 21 actions such as following, commenting and retweeting, enriching the diversity of interactions.
- recommender system: Integrates interest and heat-based recommendation algorithms to simulate how users discover and interact with content.
- open source platform: Provides flexibility and scalability to be applied to different social media platforms.
Using Help
Installation process
- clone warehouse
git clone https://github.com/camel-ai/oasis.git
cd oasis
- Create and activate a virtual environment
- Using Conda (for Linux, macOS and Windows)
bash
conda create --name oasis python=3.10
conda activate oasis
- Using venv (for Linux and macOS)
bash
python -m venv oasis-venv
source oasis-venv/bin/activate
- Using venv (for Windows)
bash
python -m venv oasis-venv
oasis-venv\Scripts\activate
- Using Conda (for Linux, macOS and Windows)
- Install the necessary packages
pip install --upgrade pip setuptools
pip install --e .
Guidelines for use
- Setting environment variables First, the OpenAI API key needs to be added to the system's environment variables. After obtaining the API key, set the environment variable according to the operating system and the shell used.
- running simulation
- Configure simulation parameters: Configure the number of agents, type of operation and environment dynamics according to the study requirements.
- Launching a simulation: running a simulation script to observe the agent's interactive behavior on social media platforms.
- Data analysis: Use built-in analytical tools to study phenomena such as information dissemination and group polarization.
- Extended functionality
- Customizing Proxy Behavior: Modify the agent's behavioral rules and interaction patterns according to research needs.
- Integration of new platforms: Expand OASIS to support new social media platforms and study social dynamics on different platforms.