SymbolicDSGE

Pre-release

This release is a pre-release and may not be stable for production use.

by Güney Kıymaç

Documentation | PyPI

Installation

pip install SymbolicDSGE
pip install "SymbolicDSGE[fred]"  # FRED API utilities
pip install "SymbolicDSGE[sr]"    # Symbolic Regression Deps
pip install "SymbolicDSGE[ui]"    # Web based GUI

Useful Links

Overview

SymbolicDSGE is a Python DSGE engine with a JIT compiled backend for linear and linearized DSGE models, supporting symbolic manipulation features for in-place model modification. It also provides measurement-equation augmentation tools, including symbolic regression for complete or restricted free-form function discovery and OLS, Ridge, Lasso, and Elastic Net for structured linear coefficient estimation. The library supports a wide set of features beyond augmentation:

DSGE model specification, symbolic manipulation, and linearization
Bayesian and maximum-likelihood estimation
Simulation and impulse-response-function utilities
Gaussian and extended Kalman filtering
Automatic data retrieval from FRED
Custom shock distributions via SciPy or user-defined samplers
Monte Carlo pipelines for comparing models or model-generated samples, including:
- Statistical tests
- Regression setups
- Output transformations
- Filtering
- Data generation

Web-UI

SymbolicDSGE ships a [ui] dependency with the goal of making DSGE basic experiments accessible to non-programmers. GUI users can:

Create a model config
Load and adjust existing configs
Estimate
Solve
Simulate
Create and run Monte Carlo experiments
Apply data transformations to outputs
Produce figures
Access raw output data

There are two intended ways to access the GUI:

# Option 1: Serve the GUI from the command line
#           This launches an empty GUI and the configuration should be done through the Builder tab.
sdsge-ui

# Option 2: Serve the GUI with a pre-loaded SolvedModel object

# Read a config and solve the model as usual
from SymbolicDSGE import ModelParser, DSGESolver

model, kalman = ModelParser(...).get_all()
solver = DSGESolver(model, kalman)
compiled = solver.compile(...)
sol = solver.solve(compiled, ...)

# Serve the GUI with the solved model pre-loaded in the reference slot
sol.serve(open_browser=True)

Although SymbolicDSGE is still a fast-moving project; the UI effectively supports all features with the exception of integration with the [sr] extra as of v1.4.2. Symbolic Regression requires extensive configuration and templating posing unique difficulties in a no-code environment. Therefore, it's presence as a GUI component is not planned for the future.

Read the Docs

Alongside API references and implementation conventions, the documentation includes guides covering model setup, estimation, simulation, and filtering. The documentation is kept up to date and aims to clarify conventions, workflows, and implementation choices throughout SymbolicDSGE. Suggestions for improving or extending the documentation are welcome as issues.

AI Parsability

The documentation is a static Material MkDocs site, so web-enabled AI tools should be able to search, parse, and summarize it reliably.

Minimal Example

from SymbolicDSGE import ModelParser
from SymbolicDSGE import DSGESolver

# Read the YAML config (Equations, Measurements, Parameters, Optional Filter Spec)
parsed = ModelParser("<path-to-config>.yaml").get_all()
model, kalman = parsed

# Compile the model
solver = DSGESolver(model, kalman)
compiled = solver.compile()

print("Equations with symbols removed: \n", "\n".join(map(str, compiled.objective_eqs)), "\n")

>>> Equations with symbols removed:
 -beta*fwd_Pi + cur_Pi - cur_x*kappa - cur_z
-cur_g + cur_x - fwd_x + tau_inv*(cur_r - fwd_Pi)
-cur_r*rho_r - e_R + fwd_r + (rho_r - 1)*(fwd_Pi*psi_pi + fwd_x*psi_x)
-cur_g*rho_g - e_g + fwd_g
-cur_z*rho_z - e_z + fwd_z

# Solve the compiled model
sol = solver.solve(
    compiled,
    parameters=None,
    ss_seed=[0.0, 0.0, 0.0, 0.0, 0.0],
)
print("Is stable: ", sol.policy.stab == 0)
print("Eigenvalues: ", sol.policy.eig)

>>> Is stable:  True
Eigenvalues:  [0.27920118+0.j 0.83000003+0.j 0.84999992+0.j 2.56517116+0.j 1.18470582+0.j]

# Plot IRFs (single or multi shock)
sol.transition_plot(
    T=25,
    shocks=["g", "z"],
    scale=1.0,
    observables=True,
)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

symbolicdsge-2.0.0.dev5.tar.gz (4.4 MB view details)

Uploaded Jul 25, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

symbolicdsge-2.0.0.dev5-cp314-cp314-win_amd64.whl (5.8 MB view details)

Uploaded Jul 25, 2026 CPython 3.14Windows x86-64

symbolicdsge-2.0.0.dev5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (13.3 MB view details)

Uploaded Jul 25, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

symbolicdsge-2.0.0.dev5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (13.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

symbolicdsge-2.0.0.dev5-cp314-cp314-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.14macOS 11.0+ ARM64

symbolicdsge-2.0.0.dev5-cp313-cp313-win_amd64.whl (5.8 MB view details)

Uploaded Jul 25, 2026 CPython 3.13Windows x86-64

symbolicdsge-2.0.0.dev5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (13.4 MB view details)

Uploaded Jul 25, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

symbolicdsge-2.0.0.dev5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (13.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

symbolicdsge-2.0.0.dev5-cp313-cp313-macosx_11_0_arm64.whl (6.0 MB view details)

Uploaded Jul 25, 2026 CPython 3.13macOS 11.0+ ARM64

symbolicdsge-2.0.0.dev5-cp312-cp312-win_amd64.whl (5.8 MB view details)

Uploaded Jul 25, 2026 CPython 3.12Windows x86-64

symbolicdsge-2.0.0.dev5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (13.5 MB view details)

Uploaded Jul 25, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

symbolicdsge-2.0.0.dev5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (13.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

symbolicdsge-2.0.0.dev5-cp312-cp312-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.12macOS 11.0+ ARM64

symbolicdsge-2.0.0.dev5-cp311-cp311-win_amd64.whl (5.8 MB view details)

Uploaded Jul 25, 2026 CPython 3.11Windows x86-64

symbolicdsge-2.0.0.dev5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (13.8 MB view details)

Uploaded Jul 25, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

symbolicdsge-2.0.0.dev5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (13.5 MB view details)

Uploaded Jul 25, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

symbolicdsge-2.0.0.dev5-cp311-cp311-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Jul 25, 2026 CPython 3.11macOS 11.0+ ARM64

File details

Details for the file symbolicdsge-2.0.0.dev5.tar.gz.

File metadata

Download URL: symbolicdsge-2.0.0.dev5.tar.gz
Upload date: Jul 25, 2026
Size: 4.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for symbolicdsge-2.0.0.dev5.tar.gz
Algorithm	Hash digest
SHA256	`a05bbdf492611a9084554306f7ab412ada3f8995f2c5e9dd17d9e0c2ffeace52`
MD5	`8dec36e2967b7ccaa944b015a45f271d`
BLAKE2b-256	`55e8693bf7e51bdb3a95bf3e0c215f329cbcd5dea4d62cfff242acda73f1d258`

Algorithm	Hash digest
SHA256	`1416786dcea7fc6825e2505696ddf4960a88239175fb56ba26d8fdde274b7229`
MD5	`7a92b8c2efc0d4d2692b42bb86ee7656`
BLAKE2b-256	`6addd5eed89183c7cabf65c5be16bd5990ab4aae10cafe9ce6a449e7a9ca3fb8`

Algorithm	Hash digest
SHA256	`c020375f51aae4b99f0865626654b88267669418eedf0ddc3bb6e35dfac75da9`
MD5	`6ba1e8c151a62ca9f255d277abe15baa`
BLAKE2b-256	`4eefadd7ef0827187cea2e716edc4d1c1b77126b6d81a02270530f2be90bcc14`

Algorithm	Hash digest
SHA256	`669ad2a9adb8f397f0dca8d943f0f940020f90341f558285ca3465b2f36e9df1`
MD5	`0494b2e0b6070026fcae02102731c103`
BLAKE2b-256	`d65128078d5ebc7b189c1908f387f8b662df477aac30c0d02c65bb66ba61af93`

Algorithm	Hash digest
SHA256	`8b9332cc3c8f4901a8bf2d81fdd3d66d57b35ffc4443ba19760dc2824e1dd636`
MD5	`624f2f9b05d3267b63236bdd29aecbaf`
BLAKE2b-256	`67aaede789b3a74001f5147d96754ce5d78a2d017bb5aa9ef7d317e980d7c0b5`

Algorithm	Hash digest
SHA256	`be0b74c26543f4c44385cfd5268b2f97c37bf840ecbd478eab30c80876e389d3`
MD5	`358c9e0345327ab20f89505b4582157f`
BLAKE2b-256	`d186b1f89cf3fa240cd1b8724b3282347453c808804095e7ce6f83dc025c0487`

Algorithm	Hash digest
SHA256	`1e9bc2d2f4cffe62d8459e5bcbe6de5ce02ad48d15aad38b4ae058fb39ce415c`
MD5	`a682553063b21dd02250d93e28a6c05d`
BLAKE2b-256	`bcd6d4f73636f3d092bec663933230079e0b1db8867c5424a4b5d103376d944f`

Algorithm	Hash digest
SHA256	`b396a9440927eb7b5e9cdc5966a03549509634fccfb1c8372e9d9b9eb303b21b`
MD5	`61122aca4fef6fb284d5b26b78945f2c`
BLAKE2b-256	`6941655574614b19873b6deaba03968c9122591ba3dc0a3df867d2d2d3f917d2`

Algorithm	Hash digest
SHA256	`2e1a2302da646badbbb4b2a2571f9b2816ccbcc300a025f2d98bbf814edf4d5a`
MD5	`2ecf082eaa91c0c7fdefb36c6235fc9c`
BLAKE2b-256	`5d489d286f36534cbf679f6085a06551ac11996549d58fe4b49825cc9699a02e`

Algorithm	Hash digest
SHA256	`a7845f1be116fc321eff494a3a65faa5be7259e54dc0f4d88ac2182c101b1dc2`
MD5	`293f5d0bc6ad4cbba66821f4a9c7c681`
BLAKE2b-256	`b228a70b8cd5dda4b2b2dd13f69d8faf131bbd88703a6af5e053f4a6f59f39e8`

Algorithm	Hash digest
SHA256	`fa19e1f7e1a0ef10a9f084ddcba629463d4af1b642b10343bd5a549d939cc83b`
MD5	`894a47391f8b37aab33b6d57fa19e1c1`
BLAKE2b-256	`a0d8b03d36d8f33c3bedfa33821f98d95a80a31303c46a5a8b0810ad69a22b52`

Algorithm	Hash digest
SHA256	`aa29b1da4e670d5c070ef946fe6c3b67e444e107d5776e1407f919bfc0476a29`
MD5	`9fc8749be23272c42559ab2ee5531412`
BLAKE2b-256	`f23b273c50d99f6d0b5811de0d7b2747461ca211b40cc9fd176e653ec4cf48cf`

Algorithm	Hash digest
SHA256	`a0daa10ffec55a3f06870b1c9cdc908e864a28253cd03fae3859e55a1af7db6b`
MD5	`a8e4216473974d72c2e6877814e765e0`
BLAKE2b-256	`2fc249ef4bba0b4ff79138be267fe8152a3b0fdd7e92983a216804c3a7d375ea`

Algorithm	Hash digest
SHA256	`229dceff5693a3ce6219de254136f90a790bcef91441d2db3b0b669d00622827`
MD5	`871910d1b4ec18f4ac8c2cfadb370a56`
BLAKE2b-256	`d54270a57e591804da12f394f0fda60c428cd87850ec20f6e9e63eb338c69600`

Algorithm	Hash digest
SHA256	`625bef14c251963b65d2880ec69fe872b808918bfe279033a4e45b7c641eb44c`
MD5	`902f26dbaa5e65d9e8c0010345527954`
BLAKE2b-256	`d47b9cb5517a8dff7a5aa81e103998c63f2f4bd200474d717ad496df919b3bbd`

Algorithm	Hash digest
SHA256	`891f3872bd211c72ba64308f6a2a56aa858f05dc8ab9f38a82276093b71690ee`
MD5	`45ea259a6d1f88947a71b13ac1e52522`
BLAKE2b-256	`5529cc96d1ef6da3d3bca035fda3a82cf97ca8736df8fb19ec36e45a6c18621f`

Algorithm	Hash digest
SHA256	`c1b2053913db39c35d83625414a1e8f4a964ee104d6f0d1fc96c99494d00dbab`
MD5	`4944e715f7c340c192d3e013607392a2`
BLAKE2b-256	`b9cde24e560f3a54e841820c5bc8b841b8eef862c89a1207368ca509d3c1069d`

SymbolicDSGE 2.0.0.dev5

by Güney Kıymaç

Installation

Useful Links

Overview

Web-UI

Read the Docs

Minimal Example

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed