The modernization engine of SciRecast.
LLM agents do the labor of modernizing legacy scientific software; RecastEngine is the part that is reusable across every such effort, and the part that refuses to let anything through that has not been checked against the original.
Python 3.11 or newer. Activate the environment once and every command after
that is a bare recast.
uv venv --python 3.11 # fetches a 3.11 if you have none
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install -e ".[fortran,translate,verify]"Without uv: python3 -m venv .venv and pip install -e with the same
extras. The core itself has zero dependencies and stays importable without a
compiler, a GPU, or a model provider — fortran, translate and verify
are the extras.
RecastEngine translates and gates Fortran with flat interfaces end to end;
the corpus of numerical libraries under corpus/ is what it is proven on.
$ recast doctor
recast 0.0.1 python 3.11.16The remaining doctor output is a live plugin count and registry inventory;
installing an out-of-tree plugin changes it without changing RecastEngine.
First time? docs/getting-started.md walks from
an empty machine to a verified translation of your own module, with what
every command prints.
recast doctor |
version, interpreter, how much is registered |
recast recipes |
the six shipped recipes |
recast plugins |
what is registered, by kind |
recast engines [--json] |
immutable translation-engine manifests for an outer pipeline builder |
recast plan <recipe> |
the stages a run would walk, and which slots nothing fills |
recast run <recipe> <tree> |
walk them over a source tree |
recast version |
the version alone |
The recipes, the config keys, the flags on run and what its exit codes
mean: docs/cli.md.
docs/ |
the CLI, the architecture, writing a plugin, the roadmap |
corpus/ |
twelve third-party Fortran libraries the engine alone is held to, the record of how far it gets, and the two small trees the shipped recipes run over end to end |
conformance/ |
what a plugin must satisfy, as a suite that runs |
| Bugs, features | issues in this repository |
| Vulnerabilities | SECURITY.md — private advisory, never a public issue |
| Collaboration, licensing | Yueqi Chen — yueqi.chen@colorado.edu |