Getting started

Set up the package, then choose a guide for the analysis you want to run.

Prepare the checkout

Clone the repository and install its locked development environment:

git clone --recurse-submodules https://github.com/ShabbyGayBar/victoria3-analysis.git
cd victoria3-analysis
uv sync

For an existing checkout, initialize the pinned artifact submodule with git submodule update --init --recursive. The examples require this artifact checkout. Generate parsed datasets first, then the production table, then study results; see the parsing guide for commands and output paths.

Continue from here

• Parse your installed game to refresh the source tables.
• Model economies and evaluate building levels directly.
• Optimize production with objectives and constraints.
• Trace supply chains and compare scenarios.
• Browse every generated result and its runnable script.