> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-coustics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Compatibility matrix

> Compatibility matrix for core SDK, language bindings and model file versions.

Match the binding, core SDK and model file format before upgrading. Binding versions are independent of the core SDK version. For example, Python 3.3.0 embeds core SDK 0.25.0. A model's product version is also separate from its file format version.

## Versions used by the quickstarts

| Route | Pinned package | Core SDK | Model file format |
| - | - | - | - |
| Python | `aic-sdk==3.3.0` | 0.25.0 | 7 |
| Node.js | `@ai-coustics/aic-sdk@0.25.0` | 0.25.0 | 7 |
| C | SDK archive 0.25.0 | 0.25.0 | 7 |
| C++ | Wrapper 0.25.0 | 0.25.0 | 7 |
| Rust | `aic-sdk = 0.25.0` | 0.25.0 | 7 |
| WebAssembly | `@ai-coustics/aic-sdk-wasm@0.25.0` | 0.25.0 | 7 |
| ai-coustics LiveKit plugin | Python/Node plugin 0.2.0 | 0.24.0 | 7 |
| Pipecat | `pipecat-ai==1.11.0`, `aic-sdk==3.1.0` | 0.23.0 | 7 |

Use each [language guide](/reference/sdk/language-bindings) for runtime and platform prerequisites. Test audio processing on your deployment target and lock transitive dependencies.

The ai-coustics LiveKit plugin and LiveKit's official plugin are different packages with different capabilities and authentication. See [plugin scope](/reference/livekit/plugin-scope). Pipecat 1.11.0 constrains its `aic` extra to the SDK 3.1 series; do not force SDK 3.3.0 into that environment.

The ai-coustics LiveKit plugin 0.2.0 stays on core SDK 0.24.0 and does not move with the quickstart pins above. The Python package accepts `aic-sdk>=3.2.0,<4`, so it resolves 3.3.0. The Node package depends on `@ai-coustics/aic-sdk@^0.24.0`, which excludes 0.25.0; keep that environment on the 0.24 series until the plugin is released against 0.25.0.

## Release history

The tables below preserve historical release mappings. They do not extend an old dependency pin to every later framework release. Before core SDK 0.13.0, models were embedded in the SDK and had no separate file format version.

<Tabs>
  <Tab title="LiveKit">
    This table applies to ai-coustics' `ai-coustics-livekit-plugin` and `@ai-coustics/livekit-plugin` packages.

    | LiveKit Plugin Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 0.2.0 | 0.24.0 with the quickstart pins | 7 |
    | 0.1.0 | 0.23.0 | 7 |

    This table applies to LiveKit's `livekit-plugins-ai-coustics` and `@livekit/plugins-ai-coustics` packages.

    | LiveKit Plugin Version | Core SDK Version |
    | :-: | :-: |
    | 0.3.0 | 0.17.1 |
    | 0.2.15 | 0.17.1 |
    | 0.2.14 | 0.17.1 |
    | 0.2.12 | 0.17.1 |
    | 0.2.6 - 0.2.11 | 0.15.1 |
    | 0.2.1 - 0.2.5 | 0.15.0 |
    | 0.1.9 - 0.2.0 | 0.14.0 |
    | 0.1.7 | 0.13.1 |
    | 0.1.5 - 0.1.6 | 0.13.0 |
    | 0.1.2 - 0.1.4 | 0.10.1 |
  </Tab>

  <Tab title="Pipecat">
    | Pipecat Version | Python Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: | :-: |
    | 1.11.0 (quickstart pin) | 3.1.0 | 0.23.0 | 7 |
    | 1.4.0 | 2.3.0 | 0.19.0 | 4 |
    | 1.1.0 - 1.3.0 | 2.2.0 | 0.17.0 | 3 |
    | 0.0.105 - 1.0.0 | 2.1.1 | 0.15.1 | 2 |
    | 0.0.101 - 0.0.104 | 2.0.1 | 0.14.0 | 1 |
    | 0.0.97 - 0.0.100 | 1.2.0 | 0.10.0 | N/A |
    | 0.0.95 - 0.0.96 | 1.1.0 | 0.9.0 | N/A |
    | 0.0.83 - 0.0.94 | 1.0.1 - 1.0.3 | 0.6.2 - 0.8.0 | N/A |
  </Tab>

  <Tab title="Python">
    Python bindings are versioned independently from the core SDK.

    | Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 3.3.0 | 0.25.0 | 7 |
    | 3.2.0 | 0.24.0 | 7 |
    | 3.1.1 | 0.23.1 | 7 |
    | 3.1.0 | 0.23.0 | 7 |
    | 3.0.0 | 0.22.0 | 6 |
    | 2.5.0 | 0.21.0 | 5 |
    | 2.4.0 | 0.20.0 | 5 |
    | 2.3.0 | 0.19.0 | 4 |
    | 2.2.1 | 0.17.1 | 3 |
    | 2.2.0 | 0.17.0 | 3 |
    | 2.1.2 | 0.16.0 | 2 |
    | 2.1.1 | 0.15.1 | 2 |
    | 2.1.0 | 0.15.0 | 2 |
    | 2.0.1 | 0.14.0 | 1 |
    | 2.0.0 | 0.13.1 | 1 |
    | 1.3.0 | 0.12.0 | N/A |
    | 1.2.0 | 0.10.0 | N/A |
    | 1.1.0 | 0.9.0 | N/A |
    | 1.0.3 | 0.8.0 | N/A |
    | 1.0.2 | 0.6.3 | N/A |
    | 1.0.1 | 0.6.2 | N/A |
    | 0.6.1 | 0.6.1 | N/A |
    | 0.6.0 | 0.6.0 | N/A |
  </Tab>

  <Tab title="Node.js">
    | Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 0.25.0 | 0.25.0 | 7 |
    | 0.24.0 | 0.24.0 | 7 |
    | 0.23.1 | 0.23.1 | 7 |
    | 0.23.0 | 0.23.0 | 7 |
    | 0.22.0 | 0.22.0 | 6 |
    | 0.21.0 | 0.21.0 | 5 |
    | 0.20.0 | 0.20.0 | 5 |
    | 0.19.0 | 0.19.0 | 4 |
    | 0.17.1 | 0.17.1 | 3 |
    | 0.17.0 | 0.17.0 | 3 |
    | 0.15.1 | 0.15.1 | 2 |
    | 0.15.0 | 0.15.0 | 2 |
    | 0.14.0 | 0.14.0 | 1 |
    | 0.13.0 | 0.13.1 | 1 |
    | 0.12.0 | 0.12.0 | N/A |
    | 0.10.0 | 0.10.0 | N/A |
    | 0.6.3 | 0.6.3 | N/A |
  </Tab>

  <Tab title="Rust">
    | Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 0.25.0 | 0.25.0 | 7 |
    | 0.24.0 | 0.24.0 | 7 |
    | 0.23.1 | 0.23.1 | 7 |
    | 0.23.0 | 0.23.0 | 7 |
    | 0.22.0 | 0.22.0 | 6 |
    | 0.21.4 | 0.21.4 | 5 |
    | 0.21.3 | 0.21.3 | 5 |
    | 0.21.2 | 0.21.2 | 5 |
    | 0.21.1 | 0.21.1 | 5 |
    | 0.21.0 | 0.21.0 | 5 |
    | 0.20.0 | 0.20.0 | 5 |
    | 0.19.3 | 0.19.3 | 4 |
    | 0.19.2 | 0.19.2 | 4 |
    | 0.19.1 | 0.19.1 | 4 |
    | 0.19.0 | 0.19.0 | 4 |
    | 0.18.0 | 0.18.0 | 3 |
    | 0.17.1 | 0.17.1 | 3 |
    | 0.17.0 | 0.17.0 | 3 |
    | 0.16.0 | 0.16.0 | 2 |
    | 0.15.1 | 0.15.1 | 2 |
    | 0.15.0 | 0.15.0 | 2 |
    | 0.14.0 | 0.14.0 | 1 |
    | 0.13.1 | 0.13.1 | 1 |
    | 0.13.0 | 0.13.0 | 1 |
    | 0.12.0 | 0.12.0 | N/A |
    | 0.11.0 | 0.11.0 | N/A |
    | 0.10.1 | 0.10.1 | N/A |
    | 0.10.0 | 0.10.0 | N/A |
    | 0.9.1 | 0.9.1 | N/A |
    | 0.9.0 | 0.9.0 | N/A |
    | 0.8.2 | 0.8.0 | N/A |
    | 0.8.1 | 0.8.0 | N/A |
    | 0.8.0 | 0.8.0 | N/A |
    | 0.6.3 | 0.6.3 | N/A |
  </Tab>

  <Tab title="C++">
    | Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 0.25.0 | 0.25.0 | 7 |
    | 0.24.0 | 0.24.0 | 7 |
    | 0.23.0 | 0.23.0 | 7 |
    | 0.22.0 | 0.22.0 | 6 |
    | 0.21.0 | 0.21.0 | 5 |
    | 0.20.0 | 0.20.0 | 5 |
    | 0.19.0 | 0.19.0 | 4 |
    | 0.17.1 | 0.17.1 | 3 |
    | 0.17.0 | 0.17.0 | 3 |
    | 0.15.0 | 0.15.0 | 2 |
    | 0.14.0 | 0.14.0 | 1 |
    | 0.12.0 | 0.12.0 | N/A |
    | 0.11.0 | 0.11.0 | N/A |
    | 0.10.0 | 0.10.0 | N/A |
    | 0.9.1 | 0.9.1 | N/A |
    | 0.9.0 | 0.9.0 | N/A |
    | 0.8.0 | 0.8.0 | N/A |
    | 0.7.0 | 0.7.0 | N/A |
    | 0.6.3 | 0.6.3 | N/A |
  </Tab>

  <Tab title="WebAssembly">
    | Bindings Version | Core SDK Version | Model File Version |
    | :-: | :-: | :-: |
    | 0.25.0 | 0.25.0 | 7 |
    | 0.23.0 | 0.23.0 | 7 |
    | 0.22.0 | 0.22.0 | 6 |
    | 0.21.0 | 0.21.0 | 5 |
    | 0.20.0 | 0.20.0 | 5 |
    | 0.19.0 | 0.19.0 | 4 |
    | 0.17.5 | 0.17.1 | 3 |
    | 0.17.4 | 0.17.0 | 3 |
    | 0.15.0 | 0.15.0 | 2 |
    | 0.14.1 | 0.14.0 | 1 |
  </Tab>
</Tabs>

## Upgrade without mixing artifacts

Keep the old application lockfile, SDK binary and model files together until the candidate passes your audio and operational checks. If the new core requires a different model file format, download compatible models into a separate cache location. See [SDK and model versions](/reference/sdk/upgrading) for how these versions fit together.

Repeat your checks when the package, model hash, runtime, operating system, CPU architecture or dependency lockfile changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.