Skip to content

Installation

Gitronics is distributed as a Python package containing a compiled Rust extension. Pre-built wheels are published to PyPI for the most common platforms; no Rust toolchain is required for end users.

Requirements

  • Python 3.9 or later
  • A supported platform: Linux x86_64 / aarch64, macOS x86_64 / Apple Silicon, Windows x86_64

Install from PyPI

pip install gitronics

After installation the gitronics command is available in your shell:

gitronics --help

Install from source

Building from source requires:

git clone https://github.com/gitronics/gitronics  # TODO: update URL
cd gitronics
pip install maturin
maturin develop --release

Verifying the installation

gitronics --help
# Usage: gitronics <COMMAND>
# Commands:
#   build    Build an MCNP model from a project configuration
#   migrate  Take a traditional monolithic MCNP model and migrate it to a Gitronics project structure
#   help     Print this message or the help of the given subcommand(s)

Building the documentation locally

pip install -r docs/requirements.txt
mkdocs serve

Open http://127.0.0.1:8000 in your browser.