> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oasis.camel-ai.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to OASIS: Open Agent Social Interaction Simulations with One Million Agents

<img className="block dark:hidden" src="https://mintcdn.com/camel-6d2d1ad0/qz42Fcu6qdIlm5lr/images/oasis_intro.png?fit=max&auto=format&n=qz42Fcu6qdIlm5lr&q=85&s=07ac3f09ac14b68fcdc23efb404d9378" alt="Hero Light" width="3068" height="858" data-path="images/oasis_intro.png" />

<img className="hidden dark:block" src="https://mintcdn.com/camel-6d2d1ad0/qz42Fcu6qdIlm5lr/images/oasis_intro.png?fit=max&auto=format&n=qz42Fcu6qdIlm5lr&q=85&s=07ac3f09ac14b68fcdc23efb404d9378" alt="Hero Dark" width="3068" height="858" data-path="images/oasis_intro.png" />

## What is OASIS?

🏝️ OASIS is a scalable, open-source social media simulator that integrates large language models with rule-based 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.

<img className="block" src="https://mintcdn.com/camel-6d2d1ad0/qz42Fcu6qdIlm5lr/images/oasis_main.png?fit=max&auto=format&n=qz42Fcu6qdIlm5lr&q=85&s=a3ac099fd30c9de804f39933ce596bbe" alt="OASIS Main" width="3068" height="1408" data-path="images/oasis_main.png" />

## Key Features

<CardGroup cols={2}>
  <Card title="Scalability" icon="chart-line" href="https://github.com/camel-ai/oasis/blob/main/oasis/social_agent/agent.py">
    Supports simulations of up to <b>one million agents</b>, enabling studies of social media dynamics at a scale comparable to real-world platforms
  </Card>

  <Card title="Dynamic Environments" icon="mobile-screen" href="https://github.com/camel-ai/oasis/blob/main/oasis/social_platform/platform.py">
    Adapts to real-time changes in social networks and content, mirroring the fluid dynamics of platforms like <b>Twitter</b> and <b>Reddit</b> for authentic simulation experiences
  </Card>

  <Card title="Diverse Action Spaces" icon="thumbs-up" href="https://github.com/camel-ai/oasis/blob/main/oasis/social_agent/agent_action.py">
    Agents can perform <b>23 different actions</b>, such as following, commenting, reposting, and quoting for rich, multi-faceted interactions
  </Card>

  <Card title="Recommendation Systems" icon="fire" href="https://github.com/camel-ai/oasis/blob/main/oasis/social_platform/recsys.py">
    Features <b>interest-based</b> and <b>hot-score-based</b> recommendation algorithms, simulating how users discover content on real social media platforms
  </Card>
</CardGroup>

## Use Cases

<CardGroup cols={2}>
  <Card title="Research Simulations" icon="flask" href="https://arxiv.org/abs/2411.11581">
    Study complex social phenomena like information spread, group polarization, and collective behavior at scale
  </Card>

  <Card title="Interactive Environments" icon="users" href="https://arxiv.org/abs/2411.11581">
    Create dynamic environments for testing human-agent interactions and social dynamics
  </Card>

  <Card title="Content Creation" icon="pen-to-square" href="https://arxiv.org/abs/2411.11581">
    Generate realistic social media content and interactions for creative or educational purposes
  </Card>

  <Card title="Behavior Prediction" icon="chart-simple" href="https://arxiv.org/abs/2411.11581">
    Model and predict how information and behaviors might spread through social networks
  </Card>
</CardGroup>

## Getting Started

Learn how to set up and use OASIS for your social simulation needs.

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="https://docs.oasis.camel-ai.org/quickstart">
    Get OASIS set up on your local environment with our step-by-step guide
  </Card>

  <Card title="Tutorials" icon="book-open" href="https://docs.oasis.camel-ai.org/user_generation/generation">
    Learn how to create user profiles and run your first simulation
  </Card>

  <Card title="Documentation" icon="file-code" href="https://docs.oasis.camel-ai.org">
    Explore the full capabilities of OASIS through our comprehensive docs
  </Card>

  <Card title="Community" icon="users" href="https://github.com/camel-ai/oasis">
    Join our Discord, Reddit, X, and WeChat groups to connect with other OASIS users
  </Card>
</CardGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Research Paper" icon="file-lines" href="https://arxiv.org/abs/2411.11581">
    Read the foundational research paper detailing OASIS methodology and findings
  </Card>

  <Card title="Example Scripts" icon="code" href="https://github.com/camel-ai/oasis/tree/main/examples">
    Explore example scripts for running various types of simulations
  </Card>

  <Card title="Dataset" icon="database" href="https://huggingface.co/datasets/oasis-agent/oasis-dataset">
    Access our comprehensive dataset of agent interactions on Hugging Face
  </Card>

  <Card title="Demo Videos" icon="video" href="https://www.youtube.com/watch?v=wjLHrdZ1Smk">
    Watch demonstrations of OASIS capabilities and simulation examples
  </Card>
</CardGroup>