# The Truman Platform

## Introduction

The Truman Platform (Truman) is a **complete, open-source social media simulation**, which can be used as a testbed to explore different research questions. 

For example, how do social norms spread on social media through a behavioral contagion process? How to encourage people to be upstanders when encountering cyberbullying? How to mitigate the effects of misinformation prevalence in social media?

## Try it out!

Explore the look, features, and functionality of [**The Truman Platform**](#user-content-fn-1)[^1] [here](https://truman-2023-82f66bc03792.herokuapp.com/)! You may enter a random 6-digit ID when prompted to provide a Mechanical Turk ID.

We have additionally created a video-based adaptation of The Truman Platform, called [**VidShare**](#user-content-fn-1)[^1], which you can explore it [here](https://vidshare-f16879bf4e3c.herokuapp.com/).

Or check out our video demos!

{% content-ref url="demo" %}
[demo](https://truman.gitbook.io/the-truman-platform/demo)
{% endcontent-ref %}

## What is The Truman Platform?

Named after the 1998 film, *The Truman Show*, the Truman Platform is a social media simulation platform created by [The Cornell Social Media Lab](https://socialmedialab.cornell.edu/) to provide researchers a community research infrastructure to conduct social media experiments in ecologically-valid realistic environments. 

Researchers can create different social media environments with a repertoire of features and affordances that fit their research goals and purposes, while ensuring participants have a naturalistic social media experience.

<figure><img src="https://797468930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOR396HK0xjvBHL78w6Qi%2Fuploads%2Fp9GSuany5p5deLNvQuOY%2Fprojects1.jpg?alt=media&#x26;token=1cfbd428-ab20-46bc-a9ee-4e8fad23a6f4" alt=""><figcaption></figcaption></figure>

Specifically, researchers can:&#x20;

* Simulate realistic and interactive timelines and newsfeeds, by curating, creating, and controlling every "actor" (a simulated user on the website), post, like, comment, notification, and interaction that appears on the platform
* Customize the social media simulation platform's interface and functionality
* Create experiments with random assignment and exposure of participants' to different experimental conditions
* Collect a variety of participant behavioral metrics on the platform (including how they interact with posts and comments, how long they are on the site, and more.)

The Truman Platform manages parallel simulations for all study participants. So, study participants don't connect or interact with any other real participant on the website, even though they believe they do, and all participants receive the same social media experience, except for variations controlled by the experimental condition of the study and the participant's own posting behavior.&#x20;

As a result, The Truman Platform gives researchers lab-like control over study conditions while maintaining a realistic, naturalistic, ecologically-valid social media setting, making Truman a great tool for social scientists to study different research questions.

## Want to install Truman?

Start exploring our codebase and the steps on how to deploy your version of The Truman Platform:

{% content-ref url="setting-up-truman/installing-truman" %}
[installing-truman](https://truman.gitbook.io/the-truman-platform/setting-up-truman/installing-truman)
{% endcontent-ref %}

## Want to explore more?

Curious to see how you can use it for your experiment? Jump in to our start docs:

{% content-ref url="getting-started/initial-experimental-design" %}
[initial-experimental-design](https://truman.gitbook.io/the-truman-platform/getting-started/initial-experimental-design)
{% endcontent-ref %}

[^1]: Note: The website may take a few minutes to load if it has not been loaded recently since we are deploying it on a low-tier as a demo site.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://truman.gitbook.io/the-truman-platform/the-truman-platform.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.