whatisgithub

What is oasis?

camel-ai/oasis — explained in plain English

Analysis updated 2026-06-26

4,568PythonAudience · researcherComplexity · 4/5Setup · moderate

In one sentence

A Python research framework for simulating social media platforms with up to one million AI-powered user agents, used to study how misinformation spreads, echo chambers form, and online crowds behave.

Mindmap

mindmap
  root((OASIS))
    Simulation
      AI user agents
      Platform replica
      Time steps
    Research Questions
      Misinformation spread
      Echo chambers
      Polarization
    Agent Actions
      Post and comment
      Follow users
      Like and search
    Setup
      pip install
      API key required
      Cost scales with size
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a simulation to model how a piece of misinformation spreads across a network of thousands of AI-powered agents.

USE CASE 2

Study what conditions cause echo chambers or political polarization to form in a controlled simulated social network.

USE CASE 3

Test how different recommendation algorithm settings change the way content spreads among simulated users.

USE CASE 4

Prototype a content moderation policy and measure its effect on information flow in the simulation.

What is it built with?

PythonOpenAI API

How does it compare?

camel-ai/oasisantgroup/echomimic_v2intelowlproject/intelowl
Stars4,5684,5684,569
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/54/5
Audienceresearcherresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires an OpenAI-compatible API key, token costs scale steeply with simulation size and number of time steps.

So what is it?

OASIS is an open-source Python framework for simulating social media platforms at scale, supporting up to one million AI-powered agents. Built by the CAMEL-AI research team and accompanied by an academic paper, it is a research tool for studying how information spreads, how polarization forms, and how crowds behave online, without running experiments on real platforms with real people. The system works by creating a simulated version of platforms like Twitter or Reddit. Each agent in the simulation represents a user, driven by a large language model. These agents can browse posts, create content, follow other users, comment, like, dislike, search, and more. The simulation includes recommendation algorithms similar to what real platforms use, so agents encounter content based on their interests or on what is trending. Researchers set up a simulation by defining profiles for their agents, choosing which actions agents are allowed to take, and running the environment for a set number of time steps. Each step, agents decide what to do based on what they see in their feed. Results are stored in a local database for later analysis and visualization. The framework is designed for questions like: how does a piece of misinformation spread through a large network, and what slows it down? What conditions lead to echo chambers? These are hard to study on real platforms because researchers cannot control the environment or see everything happening. Installation is via pip. An OpenAI-compatible API key is required to power the agents. The README includes a token consumption table to help estimate costs: running 100 agents for one time step uses several hundred thousand tokens, so expenses scale with simulation size and number of steps.

Copy-paste prompts

Prompt 1
Using OASIS, write Python code to set up a 500-agent simulation and track how a tagged post spreads over 10 time steps.
Prompt 2
Help me define agent profiles in OASIS for a simulation studying health misinformation among different demographic groups.
Prompt 3
How do I configure OASIS to use a custom recommendation algorithm instead of the default one?
Prompt 4
Write code to query an OASIS simulation database and visualize which agents spread content most across the network.

Frequently asked questions

What is oasis?

A Python research framework for simulating social media platforms with up to one million AI-powered user agents, used to study how misinformation spreads, echo chambers form, and online crowds behave.

What language is oasis written in?

Mainly Python. The stack also includes Python, OpenAI API.

How hard is oasis to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is oasis for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.