ai-coustics Speech Enhancement SDK for C++

A modern C++ wrapper around the ai-coustics Speech Enhancement SDK, providing type-safe enums and RAII resource management while maintaining a thin layer over the underlying C API.

What is this SDK?

Our Speech Enhancement SDK delivers state-of-the-art audio processing capabilities, enabling you to enhance speech clarity and intelligibility in real-time.

Quick Start

Generate your SDK License Key

To use this SDK, you'll need to generate an SDK license key from our Development Portal.

Please note: The SDK license key is different from our cloud API product. If you have an API license key for our cloud services, it won't work with the SDK - you'll need to create a separate SDK license key in the portal.

CMake Integration

Whith this CMake example you can add the SDK to your application and let CMake download all necessary files automatically:

include(FetchContent)

set(AIC_SDK_ALLOW_DOWNLOAD ON CACHE BOOL "Allow C SDK download at configure time")

FetchContent_Declare(
        aic_sdk
        GIT_REPOSITORY https://github.com/ai-coustics/aic-sdk-cpp.git
        GIT_TAG        0.8.0
        GIT_SHALLOW    TRUE
    )
FetchContent_MakeAvailable(aic_sdk)

target_link_libraries(my_app PRIVATE aic-sdk)

Example Usage

Here's a simple example showing the core SDK workflow. Error handling is omitted for clarity - see the complete example for production-ready code:

#include "aic.hpp"

#include <vector>
#include <cstdlib>

int main() {
    // Load your license key
    const char* license = std::getenv("AIC_SDK_LICENSE");

    // Create a new model
    auto creation_result = aic::AicModel::create(aic::ModelType::Quail_S48, license);
    std::unique_ptr<aic::AicModel>& model = creation_result.first;

    // Initialize with your audio settings
    model->initialize(48000, 2, 480, false);

    // Configure enhancement parameters
    model->set_parameter(aic::Parameter::EnhancementLevel, 0.7f);

    // Process audio (interleaved version available as well)
    std::vector<float> audio_buffer_left(480, 0.0f);
    std::vector<float> audio_buffer_right(480, 0.0f);
    std::vector<float*> audio_buffer_planar = {audio_buffer_left.data(), audio_buffer_right.data()};

    model->process_planar(audio_buffer_planar.data(), 2, 480);

    return 0;
}

Compatibility

The wrapper is fully C++11 compatible and on Linux you will need at least GLIBC 2.27 / Ubuntu 18.04.

Running the Example

To run the example, make sure you have set your license key as an environment variable:

export AIC_SDK_LICENSE="your_license_key_here"

Then use the following commands to configure, build and run the example:

cmake -B build ./example
cmake --build build -j
./build/my_app

Support & Resources

Documentation

• Basic Example - Sample code and integration patterns
• CMake Integration Guide - Build configuration and SDK integration

Looking for Other Languages?

The ai-coustics Speech Enhancement SDK is available in multiple programming languages to fit your development needs:

Platform	Repository	Description
C	aic-sdk-c	Core C-Interface
Python	aic-sdk-py	Idiomatic Python interface
Rust	aic-sdk-rs	Safe Rust bindings with zero-cost abstractions
JavaScript/TypeScript	aic-sdk-node	Native bindings for Node.js applications
Web (WASM)	aic-sdk-wasm	WebAssembly build for browser applications

All SDKs provide the same core functionality with language-specific optimizations and idioms.

Demo Plugin

Experience our speech enhancement models firsthand with our Demo Plugin - a complete audio plugin that showcases all available models while serving as a comprehensive C++ integration example.

Get Help

Need assistance? We're here to support you:

• Issues: GitHub Issues
• Technical Support: info@ai-coustics.com

License

This C++ wrapper is distributed under the Apache 2.0 license, while the core C SDK is distributed under the proprietary AIC-SDK license.

---

Made with ❤️ by the ai-coustics team