Skip to content

Download

Get Calango Studio 26.8.46

MIT licensed. A disk image for macOS and a package for Linux, or build it from source, which takes three commands.

Prebuilt packages

Version 26.8.46 for macOS and Linux today, with Windows packaging on the way.

macOS

Apple Silicon

Drag-and-drop disk image. The embedded Python interpreter ships inside the bundle, so there is nothing to install alongside it.

Download .dmg

calango_26.8.46_macOS.dmg · 196 MB

SHA-256 .sha256

Linux

amd64

System package with its Qt 6, OpenGL and Python dependencies declared. Installs the desktop entry and icon.

$ sudo apt install ./calango_26.8.46_amd64.deb
Download .deb

calango_26.8.46_amd64.deb · 8.4 MB

SHA-256 .sha256

Windows

64-bit

NSIS installer with the .calproj and .extxyz file associations wired in, so double-clicking a project opens it straight into Calango Studio.

Coming soon — Windows packaging hasn't shipped yet.

Build from source

Clone seixas-research/calango-studio, then work through the three steps below.

Requirements

  • A C++20 compiler
  • CMake 3.21 or newer
  • Qt 6.4+ with Widgets, OpenGLWidgets, Concurrent, Svg
  • Python 3.9+ with development headers

  1. 1. Python environment for the embedded interpreter

    $ python3 -m venv .venv $ .venv/bin/pip install ase numpy spglib pillow imageio imageio-ffmpeg paramiko

  2. 2. Configure and build

    $ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ -DPython3_EXECUTABLE=$PWD/.venv/bin/python \ -DCMAKE_PREFIX_PATH=/path/to/Qt # e.g. /opt/homebrew/opt/qt $ cmake --build build -j

  3. 3. Run

    $ ./build/calango examples/Si_diamond.vasp # verify the embedded interpreter finds ASE $ ./build/calango --probe-python

The embedded interpreter is resolved as $CALANGO_PYTHON → $VIRTUAL_ENV → bundled interpreter → configure-time default. Simulation jobs are independent of it: every wizard has an execution-environment selector for any other virtual environment or explicit interpreter.

Running the tests

Configure with -DCALANGO_BUILD_TESTS=ON, then ctest --test-dir build. The suite covers the pure C++ physics (builders, unfolding, magnetic groups, phonon thermodynamics), the generated Python scripts, parsed back by AST and exercised directly, and live GPAW benchmarks that self-skip when the response stack is absent.

Stuck on the build?

The Packaging Guide covers the embedded Python environment and dependency resolution in detail. That is where build problems usually live.

Documentation