Skip to main content

Chipify

Chipify

License Python

(c) 2026 Santiago Hofwimmer BSc

Institute for Integrated Circuits and Quantum Computing, Johannes Kepler University (JKU), Linz, Austria

Link to repository

Link to Youtube Channel (tutorials following soon)

GUI

Chipify is a high-performance EDA (Electronic Design Automation) tool for mismatch simulations, parameter sweeping, and yield analysis. It wraps Xschem (schematic capture) and Ngspice (circuit simulation) to automate Monte-Carlo and corner sweeps, run them in parallel, and turn the raw results into plots, yield matrices, and reports.

It ships with both a PySide6 (Qt) desktop GUI and a headless CLI, plus a plugin system for custom plots, reports, and expressions.

Histogram View Scatter Plot

Features

  • Parallel sweeps — multiprocessing pool runs Monte-Carlo / corner cases across all cores.
  • Datasheet-driven — describe parameters, tests, and pass/fail specs in a single YAML file.
  • Range DSL — range, linspace, and logspace parameter sweeps (safely parsed, no eval).
  • Yield & statistics — pass/fail yield, histograms with distribution fits, corner yield matrices.
  • Safe custom expressions — derive new metrics with a sandboxed evaluator (no arbitrary code execution).
  • Reports — export to PDF, Markdown, and LaTeX; PNG/SVG plot exporters.
  • Pluggable — add your own plots, reports, expressions, and exporters (see PLUGINS.md).
  • Multi Plot Dashboard - arrange a selection of plots on a second window.

Multi Plot Dashboard

Prerequisites

Chipify is a wrapper around external EDA tools, so these must be installed and available on your PATH:

  • Python 3.11+

  • Ngspice — the SPICE simulator

  • Xschem — schematic capture / netlist generation

  • (optional) VACASK + PyOPUS — alternative simulation backend

  • (Linux) PySide6 system libraries — the Qt GUI runs on PySide6-Essentials (installed automatically by pip; only QtCore/QtGui/QtWidgets are used, so the larger PySide6 Addons aren't needed). Qt still needs a few shared libraries that pip can't install:

    • libegl1 / libgl1 (libEGL.so.1 / libGL.so.1) are dlopened when Qt is imported — required even for the headless test suite. Without them you get ImportError: libEGL.so.1: cannot open shared object file.
    • libxcb-cursor0 (Qt ≥ 6.5) is needed by the xcb/XWayland platform for the on-screen GUI; without it a Wayland session falls back to native Wayland, where dropdown menus don't close on selection.

    install.sh installs all of these automatically on Debian/Ubuntu; elsewhere install them with your package manager (e.g. apt install libegl1 libgl1 libxcb-cursor0). System libraries can't be declared in setup.py/pyproject.toml, so they're handled by install.sh.

It is highly recommended to install and run Chipify inside the IIC-OSIC-TOOLS docker container. This way, all the required tools plus a bunch of open source PDKs are already installed.

Installation

python3 -m pip install chipify

Quick start

Desktop GUI

chipify

This opens the desktop application where you can edit datasheets, launch sweeps, and explore results interactively.

Headless CLI

See examples/datasheet.yaml for a documented datasheet template (and examples/README.md for how to run it). Place your datasheet YAML in the input folder (datasheets/ by default), then:

chipify-cli -c my_design.yaml          # run a single datasheet
chipify-cli --batch ./datasheets       # run every *.yaml in a directory
chipify-cli -c my_design.yaml --json   # also print a JSON summary (handy for CI)
chipify-cli -c my_design.yaml --markdown report.md

Results are written to the output folder (out/ by default), including simulation_results.csv and any generated reports. Run chipify-cli --help for the full list of options.

Configuration

User preferences are stored in settings.json in the directory you launch Chipify from (CPU cores, simulator engine, theme, live plotting, …). The file is created/updated by the GUI's settings dialog. Custom equations live in the datasheet YAML (equations: / transient_equations:), not in settings.json.

Folder paths

By default Chipify uses this layout under the working directory:

Folder settings.json key Default
Input datasheets in_dir datasheets/
Simulation output out_dir out/
Model files (*.lib/*.mod/*.inc staged for simulation) work_dir work/
Testbench files tb_dir tb/

To relocate any of them, set the corresponding key in settings.json to an absolute or relative path, e.g.:

{
  "out_dir": "results",
  "in_dir": "/data/chipify/datasheets"
}

Any key that is missing or blank falls back to its default. Paths are resolved when Chipify starts, so changes take effect on the next launch.

Importing SPICE netlists (skip schematic entry)

By default each testbench netlists an Xschem schematic (tb/<name>.sch) for you. If you don't use schematic entry, set the optional per-testbench source: netlist key — Chipify then loads an existing SPICE deck for that testbench directly and skips Xschem. The deck is located by convention, next to where the schematic would live: tb/<name>.spice for ngspice, tb/<name>.sim for vacask.

tests:
  gain_tb:                # loads tb/gain_tb.spice instead of tb/gain_tb.sch
    engine: ngspice       # selects the simulator (and the .spice/.sim extension)
    source: netlist       # default is "xschem"
    gain:
      min: 40
      unit: dB

In the desktop GUI this is the per-testbench Source dropdown (xschem / netlist). The engine: key still chooses the simulator. Downstream everything is unchanged — parameter sweeps, measurement capture, pass/fail specs, and reports all work exactly as with a schematic.

Authoring an imported netlist:

  • Swept parameters are substituted via Jinja2 {{ param }} placeholders in the deck (e.g. V1 vdd 0 {{ vdd }}). A value that isn't a placeholder is the same for every sweep point.
  • The whole deck is rendered as a Jinja2 template, so avoid stray literal {...} braces (inline expressions like {R*2}) — they raise a template error. Precompute such values in a .control/.param form that doesn't use bare braces.
  • ngspice (managed capture): name your let/meas vectors after the datasheet measurement keys and add your analysis (tran/dc/ac) in a .control block. Do not hand-write echo MY_DATA:/wrdata lines — Chipify injects those from the datasheet, just as it does for Xschem output.
  • vacask: provide a .sim deck that writes a .raw consistent with the Spectre path; Chipify extracts scalars/waveforms from the .raw file (and any measure: expressions) in the datasheet.
  • Model files referenced via .include/.lib must resolve from the staged scratch dir — put them in work/ (*.lib/*.mod/*.inc are staged automatically) and reference them by bare filename.

Re-running against pre-generated templates (the --templates-dir flag) still takes precedence over a per-testbench source: netlist.

Running the examples

The examples for chipify can be found here

Project layout

chipify/            # engine (no GUI-toolkit deps)
  cli.py            # CLI entry point + GUI launcher
  simulator.py      # multiprocessing simulation engine
  schema.py         # datasheet validation + range DSL
  expression.py     # sandboxed expression evaluation
  settings.py       # project folder paths (configurable via settings.json)
  app_config.py     # persistent preferences + logging
  data_loader.py    # results loading / pass-fail / history (shared, headless)
  uikit/            # toolkit-agnostic GUI-support layer (state, services, plugin facade)
  gui_qt/           # PySide6 (Qt) desktop GUI (tabs / controllers / workers / widgets)
tests/              # pytest suite for the core engine + GUI smoke tests

See context.md for the full architecture overview and PLUGINS.md for the plugin API.

Development

pip install -e .
pytest                                   # run the test suite
python -m mypy chipify/settings.py       # strict type-checking (see pyproject.toml)

License

Licensed under the Apache License 2.0.

Metadata

Release files for chipify 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chipify 0.2.2
File Size Uploaded Provenance Actions
chipify-0.2.2.tar.gz 249.7 kB With provenance Details for chipify-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chipify 0.2.2
File Interpreter ABI Platform Actions
chipify-0.2.2-py3-none-any.whl Python 3 none any Details for chipify-0.2.2-py3-none-any.whl

Total release size: 516.7 kB

Release files / chipify-0.2.2.tar.gz

Download URL chipify-0.2.2.tar.gz
Size 249.7 kB
Tags Source
SHA-256 checksum
How to use checksums
9b5f49f9476bc500a685c2cbe0b211bc4ba7bd73df4077120ee085c03c701494
BLAKE2b-256 checksum
How to use checksums
3028eb9172f99bfff7adfd5742da232c229f792759d89fa53b7304a8d566a2a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.

Transparency log

Release files / chipify-0.2.2-py3-none-any.whl

Download URL chipify-0.2.2-py3-none-any.whl
Size 266.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b527c4023d39bb4cef01512fde260e71633c5cfe2896134ad194c094a01722c8
BLAKE2b-256 checksum
How to use checksums
cd0d3e8d4c8747198b8b6c68662be73fcc3b8757a35c5c233f18e6cdfb76eb40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.

Transparency log

Security for chipify 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for chipify-0.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page