README.md

LLM Mediator Simulations

Simulate online debates using LLMs. This project runs on Python 3.12.

WARNING: as this project deals with toxicity simulation, you may encounter shocking language in prompt configurations source code. See the full warning.

See the overview for more details.

Project Structure

├── examples                  # Example scripts
│
├── src/llm_mediator_simulations  # Main package
│   │
│   ├── metrics        # Metrics computations
│   ├── models         # LLM model wrappers
│   ├── simulation     # Debate simulation handler classes
│   ├── utils          # Utilities
│   └── visualization  # Visualization tools

Get Started

This project was setup using hatch.

pip install --user hatch
hatch env create
source venv/bin/activate  # Activate the python virtual environment
pip install -e .  # Install the current package

Examples

Example scripts are located in the examples/ folder.

python examples/example_async.py

Run a local LLM with the example_server.py script. Analyze generated debates with the example_analysis.py script.

See the guide for more information.