CGE-Core

CGE-Core#

A practitioner-first Python/Pyomo toolkit for computable general equilibrium modelling and reproducible policy simulation.

CGE-Core keeps the economic model families distinct while giving ordinary users a common way to work:

choose an economy → solve the benchmark → create a scenario → apply an economic shock → solve → compare

Start here#

Interactive Control Room ↗ — a six-step visual guide to model choice, economic structure, data, closure, policy shocks, runnable code, and outputs.
Quickstart — the shortest complete Standard CGE experiment.
Colab notebooks — the browser-based course.
Architecture — the public v0.8 architecture and the lower-level PyCGE engine.
Economic theory — the economic structure and interactive Mermaid diagrams.
Validation — Hosoe/GAMS, IFPRI, and CAMCGE evidence.
API reference — Python API reference.

The v0.8 practitioner workflow#

from cge_core import StandardCGE

base = StandardCGE.example().solve()

reform = base.scenario("Tariff abolition")
reform.tariff("BRD", 0)

result = reform.solve()
result.summary()
result.compare(base)

The ordinary workflow does not ask the modeller to choose a solver name, manipulate PATH, select a numeraire, drop a Walras equation, change directories, or manage repository state. Those are implementation details rather than policy assumptions.

A scenario is a new internally consistent equilibrium, not a spreadsheet-style recalculation of one changed cell. Prices and quantities adjust together until the model’s equilibrium conditions are satisfied.

Four bundled model families#

Model	Main use	Public entry point
Simple CGE	Learn general-equilibrium mechanics in a closed economy	`SimpleCGE`
Standard CGE	Open-economy policy analysis with government, trade and intermediates	`StandardCGE`
IFPRI Standard CGE	Richer institutions and explicit named macro-closure experiments	`IFPRICGE`
CAMCGE	Published Cameroon replication and historical validation	`CamCGE`

The shared surface is a workflow, not a claim that these models have the same equations.

Advanced lower-level API#

For SimpleCGE, StandardCGE, and CamCGE, the CGE → Equilibrium → Scenario → Result lifecycle sits above CoreEngine and the retained lower-level PyCGE engine. IFPRICGE uses its own IFPRI-specific equilibrium/scenario/result adapter while sharing the same Pyomo and solver boundary.

These are intentional advanced implementation distinctions; new practitioner material should still start with the four model-specific entry points above.

Note

CGE-Core is an independent project. It is not affiliated with or endorsed by the Policy Simulation Library.

For provenance, licensing, and citation metadata, see CITATION.cff.