explaingit

oranai-ltd/oransim

Analysis updated 2026-05-18

1,102PythonAudience · pm founderComplexity · 3/5LicenseSetup · moderate

TLDR

A causal simulation tool that lets marketing teams test what if campaign decisions in about 60 seconds instead of running real A/B tests.

Mindmap

mindmap
  root((oransim))
    What it does
      Causal simulation
      Counterfactual testing
    Tech stack
      Python
    Use cases
      Budget allocation testing
      Campaign attribution
    Audience
      Marketing teams
      Founders

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

Simulate how different creators, platforms, or budget splits would perform before spending money

USE CASE 2

Test how a mid-campaign change would affect the following two weeks

USE CASE 3

Attribute past campaign performance by replaying it with different choices

USE CASE 4

Explore the causal logic using the included 21,000-item demo dataset

What is it built with?

Python

How does it compare?

oranai-ltd/oransimgudong2003/xianyu-auto-reply-fixlyra81604/zhengxi-views
Stars1,1021,0841,151
LanguagePythonPythonPython
Last pushed2026-06-30
MaintenanceActive
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencepm founderdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

The open-source version ships with a 21,000-item demo dataset, a paid license is needed for the larger real-world dataset.

The open-source causal engine can be used freely, including commercially, under the Apache-2.0 license.

In plain English

Oransim is a marketing simulation tool aimed at enterprise marketing teams, specifically the people who decide where to spend campaign budgets. The core problem it addresses is that traditional marketing analysis tools tell you what already happened, but can't answer "what would have happened if we'd made a different decision?", for example, if you'd picked different content creators, shifted budget to a different platform, or changed your timing mid-campaign. Oransim uses a technique called causal simulation: it models a large virtual population of consumers and runs "what if" experiments (called counterfactuals) against that population. Instead of A/B testing a campaign for two weeks at real cost, you can simulate it in about 60 seconds. The engine can rank combinations of creative content, creator choices, and budget allocations before you spend any money, show you how a mid-campaign change (like swapping one creator for another on day three) would affect outcomes over the following two weeks, and attribute performance after a campaign ends by replaying it with different platform choices. The open-source version runs on a 21,000-item demo dataset so you can inspect the full causal logic yourself. An enterprise data license unlocks a much larger dataset of indexed social media content and creator profiles. The tool is built in Python and the causal engine is open source under the Apache-2.0 license. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
How do I run a counterfactual simulation with oransim's demo dataset?
Prompt 2
How do I compare different creator and budget allocation scenarios in oransim?
Prompt 3
What does oransim's enterprise data license add over the open-source version?

Frequently asked questions

What is oransim?

A causal simulation tool that lets marketing teams test what if campaign decisions in about 60 seconds instead of running real A/B tests.

What language is oransim written in?

Mainly Python. The stack also includes Python.

What license does oransim use?

The open-source causal engine can be used freely, including commercially, under the Apache-2.0 license.

How hard is oransim to set up?

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

Who is oransim for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.