Hanzo AIDocs
Sign inAPI key

C++

A native client over every /v1 service, taken from a tag with CMake. C++17, cpprestsdk, generated from the API's own document.

One typed client over every /v1 capability, generated from the document hanzoai/cloud emits at the commit the repository's .spec-lock names. Nothing under include/ or src/ is hand-written.

No registry, so it comes from a tag

C++ has no package registry, so a consumer pins a tag or a commit rather than a version range. Both forms below are supported by GIT_TAG.

Install

Requires C++17, CMake 3.20+, and cpprestsdk with Boost and OpenSSL (apt install libcpprest-dev libboost-dev libssl-dev).

Fetch it as part of your build:

include(FetchContent)
FetchContent_Declare(
  hanzo
  GIT_REPOSITORY https://github.com/hanzo-cpp/sdk.git
  GIT_TAG        v8.5.156
)
FetchContent_MakeAvailable(hanzo)

add_executable(app main.cpp)
target_link_libraries(app PRIVATE hanzo::hanzo)

Or install it once and resolve it as a package:

cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local
cmake --build build -j"$(nproc)" --target install
find_package(hanzo CONFIG REQUIRED)
target_link_libraries(app PRIVATE hanzo::hanzo)

The shape

A configuration, a client, and one class per capability:

#include <cstdlib>
#include <iostream>

#include "hanzo/ApiClient.h"
#include "hanzo/ApiConfiguration.h"
#include "hanzo/ApiException.h"
#include "hanzo/api/AskApi.h"

int main() {
    const char* key = std::getenv("HANZO_API_KEY");
    if (key == nullptr) {
        std::cerr << "HANZO_API_KEY is not set" << std::endl;
        return 1;
    }

    auto config = std::make_shared<hanzo::api::ApiConfiguration>();
    config->setBaseUrl(U("https://api.hanzo.ai"));
    config->getDefaultHeaders()[U("Authorization")] =
        U("Bearer ") + utility::conversions::to_string_t(key);

    hanzo::api::AskApi ask(std::make_shared<hanzo::api::ApiClient>(config));

    auto question = std::make_shared<hanzo::model::WebQuestion>();
    question->setQ(U("What are the three laws of thermodynamics?"));

    auto report = ask.researchWeb(question).get();
    std::cout << utility::conversions::to_utf8string(report->getAnswer()) << std::endl;
}

Every call returns a pplx::task, so .get() blocks and .then() composes. Failures arrive as hanzo::api::ApiException. The class is the capability and the method is the operation — the reference prints the pair per operation, and Authentication covers the key in that header.

Resources

Was this page useful?
PreviousJavaNextIAM SDK
Last updated Oct 15, 2026