Skip to content

simulatrex/possible-worlds

 
 

Repository files navigation

Simulatrex

Simulatrex is an open-source project focused on Generative Agent-Based Modeling (GABM), utilizing large language models for more accurate simulations. It's designed for researchers and developers interested in exploring human behavior and social dynamics. GABM in Simulatrex enhances agents with cognitive capabilities, allowing for more realistic decision-making processes in simulations. This tool is particularly useful in social sciences, policy analysis, and digital service design, offering a platform for innovative and relevant experimentation in a variety of settings.

Schedule Demo · Feature Request

Documentation

For more detailed information about Simulatrex, please refer to our documentation.

Features

  • Multi-Agent Simulations: Simulatrex allows you to create simulations with multiple agents, each with their own identities, initial conditions, and cognitive models.
  • Dynamic Environments: Simulatrex supports both static and dynamic environments, allowing for a wide range of simulation scenarios.
  • Event-Driven: Simulatrex simulations are event-driven, with a built-in event engine to process events and update the environment.
  • Evaluation Engine: Simulatrex includes an evaluation engine to evaluate the outputs of the agents based on predefined objectives and metrics.
  • Language Model Integration: Simulatrex integrates with language models like OpenAI's GPT-4, enabling agents to generate human-like responses.

Installation

To install Simulatrex, you need to have Python 3.6 or higher. You can install it using pip:

pip install simulatrex

Usage

Here is a basic example of how to use Simulatrex:

import asyncio
import dotenv
from simulatrex import SimulationEngine

dotenv.load_dotenv()

async def main():
    engine = SimulationEngine("./data/1_consumer_price_simulation_config.json")
    await engine.run()


if __name__ == "__main__":
    asyncio.run(main())

In this example, we're creating a new SimulationEngine with a configuration file and then running the simulation.

Simulation Examples

Simulatrex can be used for a variety of simulations. Here are a few examples:

1. Consumer Price Simulation

Simulate the impact of price changes on consumer behavior. This can help businesses understand how consumers might react to price increases or decreases, and make informed decisions about pricing strategies.

Possible outcome: 4 out of 10 agents stated that the price is too high.

2. Product Launch Simulation

Simulate the market response to a new product launch. By modeling different consumer personas and their potential reactions, businesses can get a sense of how a new product might be received and plan their marketing strategies accordingly.

Possible outcome: 7 out of 10 agents stated a positive buying intention.

3. Market Trend Simulation

Simulate broader market trends. This can help businesses anticipate changes in the market, identify opportunities for growth, and stay ahead of the competition.

Possible outcome: 6 out of 10 agents predicted a rising trend in the tech market due to increased interest in AI technologies.


Each simulation can be configured with specific metrics and targets. For example, in a product launch simulation, you might set the metric to "Buying intention among personas".

Contributing

To contribute: Clone the repo locally -> Make a change -> Submit a PR with the change.

Here's how to modify the repo locally: Step 1: Clone the repo

git clone https://github.com/simulatrex/simulatrex

Step 2: Navigate into the project, setup a new virtual env (recommended) and install dependencies:

cd simulatrex
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Step 3: Submit a PR with your changes! 🚀

  • push your fork to your GitHub repo
  • submit a PR from there

Support / talk with founders

Why did we build this

With Simulatrex we want to make rapid market simulations accessible to every professional out in the world. We aim for:

  • Accessibility

    We allow everyone to run simulations, fast. That means the setup should be simple, intuitive, and explainable. As outlined social simulations following complex environments are currently hard to conduct. It takes days to outline the starting conditions. By fine-tuning our own models, we want to rapidly decrease the setup time.

  • Performance

    By paralleling processes we aim for the maximum speed so that simulations take hours instead of days or weeks.

  • Dynamic without limits

    Our world is constantly changing, so it’s a preliminary requirement for a social simulation framework to model dynamic environments. Simulatrex allows that by introducing a novel event engine, that releases an event at a certain time or follows natural language-described triggers.

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%