Universal Model Runtime (Python)
The tracdap-runtime is a lightweight package for building portable, production-grade Python models. Models created with the runtime can be executed anywhere, from local development environments to enterprise production systems.
The runtime can be used independently of the trac platform and provides a simple framework in which to build, ship, and share models.
Each model defines its parameters, inputs and outputs, and the runtime provides the execution context, ensuring that models always receive valid data and parameters. Taking responsibility for data access, marshalling and formatting out of the model code allows developers to focus on model logic, safe in the knowledge that the model will behave consistently across environments.
For a complete guide to writing models in the trac framework, see the online documentation.
📦 Requirements
- Python : 3.10 or later
- Tools : Any popular IDE (PyCharm, VS Code, etc.)
- Pandas : Version 1.3 and later are supported
- Polars : Version 1.0 and later are supported
Some 3rd party libraries may have additional version constraints, for example, Pandas 1.5 is not available for Python 3.12 or later.
🚀 Quick start
tracdap-runtime can be added to a new or existing Python project using pip:
$ pip install tracdap-runtime
You will also need to install a data framework (Pandas or Polars) and any other libraries that the model uses.
Here is a minimum working example of a TRAC model that performs aggregation on a dataset:
import tracdap.rt.api as trac
class QuickStartModel(trac.TracModel):
def define_parameters(self):
# Define any parameters the model will use
return trac.define_parameters(
trac.P("exchange_rate", trac.FLOAT, "EUR / GBP exchange rate")
)
def define_inputs(self):
# Define an input table with the columns and data types that the model needs
customer_loans = trac.define_input_table(
trac.F("id", trac.STRING, label="Customer account ID", business_key=True),
trac.F("region", trac.STRING, label="Customer home region", categorical=True),
trac.F("loan_amount", trac.FLOAT, label="Principal loan amount (EUR)"),
label="Customer loans data")
return {"customer_loans": customer_loans}
def define_outputs(self):
# Define an output table with the columns and data types that the model will produce
loans_by_region = trac.define_output_table(
trac.F("region", trac.STRING, label="Customer home region", categorical=True),
trac.F("total_lending", trac.FLOAT, label="Total lending (GBP)"),
label="Loans by region")
return {"loans_by_region": loans_by_region}
def run_model(self, ctx: trac.TracContext):
# Parameters and inputs are loaded and validated by the runtime
exchange_rate = ctx.get_parameter("exchange_rate")
customer_loans = ctx.get_pandas_table("customer_loans")
# Model code is regular Python
customer_loans["loan_amount_gbp"] = customer_loans["loan_amount"] * exchange_rate
loans_by_region = customer_loans \
.groupby("region", observed=True, as_index=False) \
.aggregate(total_lending=("loan_amount_gbp", "sum"))
# Logs written to ctx.log are captured by the platform
ctx.log().info("Aggregated loans for %d regions", len(loans_by_region))
# Outputs are handed back to the runtime for validation and saving
ctx.put_pandas_table("loans_by_region", loans_by_region)
# Use the desktop launcher to run, test and debug models locally
if __name__ == "__main__":
import tracdap.rt.launch as launch
launch.launch_model(QuickStartModel, "config/quick_start.yaml", "config/sys_config.yaml")
The model needs two config files in order to run: A job config file and a system config file.
By convention, for local development these are kept in a config folder.
The system config file defines the resources that are available for models to use. As a minimum the default storage location must be specified.
sys_config.yaml
properties:
storage.default.location: example_data
storage.default.format: CSV
resources:
example_data:
resourceType: INTERNAL_STORAGE
protocol: LOCAL
properties:
rootPath: C:\path\to\your\data
The job config file supplies the model with the parameters, inputs and outputs that it needs to run.
The default data location from sys_config.yaml is used to load input data and save output data.
The runtime checks the types and schemas of every parameter and input dataset, types are cast automatically
where it is safe to do so, otherwise the runtime will raise an error if the inputs are not valid.
quick_start.yaml
job:
runModel:
parameters:
exchange_rate: 0.865
inputs:
customer_loans: "inputs/customer_loans_data.csv"
outputs:
loans_by_region: "outputs/example_model/loans_by_region.csv"
You can run the model from your IDE (right click the model file and choose "Run", or look for the "Play" button). You will see the model logs, and an output file will be created inside your data folder.
📖 Documentation
See the online documentation for a complete guide to writing models in the trac framework, including tutorials and the full Model API.
✋ Contributing
If you'd like to contribute a feature or a fix then we'd love to hear from you! Please raise an issue on our issue tracker to discuss your suggestion before working on a PR.
Contributions are governed according to the contribution guidelines and the FINOS code of conduct.
📜 License
The TRAC model runtime is maintained by Fintrac Limited in association with the Fintech Open Source Foundation (FINOS) and distributed under the terms of the Apache License, Version 2.0.
SPDX-License-Identifier: Apache-2.0
For more information including copyright history, see the NOTICE file.
🏢 Enterprise
Professional support for the trac platform is available from Fintrac Limited, for more information about this please contact us.
3 maintainers
Release files for tracdap-runtime 0.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tracdap_runtime-0.10.1.tar.gz | 238.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tracdap_runtime-0.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 555.6 kB
Release files / tracdap_runtime-0.10.1.tar.gz
| Download URL | tracdap_runtime-0.10.1.tar.gz |
|---|---|
| Size | 238.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9195abb2be737277ea52f72bd23db4923a5078d7285e9ecc526de44431acecde
|
|
BLAKE2b-256 checksum How to use checksums |
c47a283d92af5ddb439f8f211f73b14b13309fdd84db1d468fe0e2da061c4f75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.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 Aug 26, 2026.
Transparency logRelease files / tracdap_runtime-0.10.1-py3-none-any.whl
| Download URL | tracdap_runtime-0.10.1-py3-none-any.whl |
|---|---|
| Size | 317.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4b954e62756cc9c76fc4441ebabe80c9577a5febc105a579f5b07d83ba2c62b
|
|
BLAKE2b-256 checksum How to use checksums |
be286eedba758c9238b244224cfd5e1ea69e39b5ec2a388f9eb450bea71c9191
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.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 Aug 26, 2026.
Transparency log
