Use cargo add precice to install the rust language bindings from
Updated 02 Feb 24

The versioning scheme

The versioning scheme of the rust bindings consists of the first two parts of the preCICE version and the additional version of the rust bindings.


  • version 1 of the rust bindings for preCICE version 2.5 is 2.5.1
  • version 2.5.0 of the rust bindings are compatible will all bugfix releases of 2.5.


Install cargo, pkg-config and preCICE. The rust bindings rely on pkg-config to locate preCICE.


The rust bindings for preCICE are published on with the package precice.

You can install the bindings directly from

cargo add precice@3.0

Alternatively, you can install the bindings from the git repository:

cargo add --git --rev v3.0.0 precice


The usage of the rust language bindings for preCICE is very similar to the C++ API. Therefore, please refer to our section on coupling your code for getting started. The main important differences are:

  • Import the crate use precice
  • Create a precice::Participant using precice::Participant::new()
  • The rust bindings follow rust naming scheme, so read_data instead of readData.
  • The bindings use slices for data [f64] and indices [i32] or [VertexID]
  • Refer to the rust version of the elastic tube 1D and the corresponding source code for a complete example of the precice crate.