git404hub

what is oasis fr?

camel-ai/oasis — explained in plain English

Analysis updated 2026-06-26

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

tl;dr

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.

vibe map

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

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

PythonOpenAI API

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 1h+

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

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.