Godot 4

git clone https://github.com/hanzoai/godot-sdk.git /tmp/hanzo-godot-sdk
cp -r /tmp/hanzo-godot-sdk/addons/hanzo_ai ./addons/hanzo_ai

dotnet add package Hanzo --version 8.5.1027

extends Node

const HanzoClient := preload("res://addons/hanzo_ai/hanzo_client.gd")

var hanzo: RefCounted
var emitter_3d: AudioStreamPlayer3D

func _ready() -> void:
    hanzo = HanzoClient.new()
    emitter_3d = AudioStreamPlayer3D.new()
    add_child(emitter_3d)

# 1. Revisioned Cloud KV Checkpoints (/v1/kv/{bucket}/{key})
# Bucket names take 1-64 [A-Za-z0-9_] characters (underscores, no hyphens).
func save_run(slot: String, state: Dictionary) -> Dictionary:
    var bucket := "my_godot_game_saves"
    hanzo.create_kv_bucket(bucket, 10)
    return hanzo.put_kv(bucket, slot, JSON.stringify(state))

func load_run(slot: String) -> Dictionary:
    var res: Dictionary = hanzo.get_kv("my_godot_game_saves", slot)
    if not bool(res.get("ok", false)):
        return {}
    var raw := str(res.get("data", {}).get("value", ""))
    var parsed: Variant = JSON.parse_string(raw)
    return parsed if parsed is Dictionary else {}

# 2. Zero-Output-Token NPC & Director Decisions (/v1/decisions on kai)
func pick_npc_action(world_state: Dictionary) -> String:
    var res: Dictionary = hanzo.decide(world_state, {
        "action": {
            "type": "choice",
            "instructions": "Select the NPC's immediate combat action.",
            "criteria": {
                "patrol": "Area is quiet; no target or sound.",
                "investigate_noise": "Gunshot or footsteps heard nearby.",
                "stalk": "Target seen beyond 15m; shadow from cover.",
                "attack": "Target visible within 15m and health above 40%.",
                "flank": "Under fire at medium range with lateral cover.",
                "retreat": "Health below 25% under active fire."
            }
        }
    })
    return str(res.get("data", {}).get("answers", {}).get("action", {}).get("choice", "patrol"))

# 3. Zen 6 Dialogue + Zen Voice Spatial 3D AudioStreamMP3
func speak_radio_line(situation: String) -> void:
    var chat: Dictionary = hanzo.chat_completion(
        [
            {"role": "system", "content": "Give one terse 12-word radio callout in character."},
            {"role": "user", "content": situation}
        ],
        "zen6-flash",
        {"max_tokens": 120, "temperature": 0.6}
    )
    var line: String = hanzo.extract_message_text(chat)
    if line == "":
        return
    var tts: Dictionary = hanzo.speech_mp3(line, "af_heart", "zen-voice")
    var stream: AudioStreamMP3 = tts.get("stream")
    if stream != null:
        emitter_3d.stream = stream
        emitter_3d.play()

using Godot;
using Hanzo.AI;
using Hanzo.AI.Api;

public partial class HanzoGameDirector : Node3D
{
    private AiApi _ai = null!;
    private KvApi _kv = null!;
    private AudioStreamPlayer3D _voice3D = null!;

    public override async void _Ready()
    {
        var cfg = Gateway.Configuration();
        _ai = new AiApi(cfg);
        _kv = new KvApi(cfg);
        _voice3D = new AudioStreamPlayer3D();
        AddChild(_voice3D);

        await _kv.PostKvByBucketAsync("godot_net_saves", new { history = 5 });
        await _kv.PutKvByBucketAndKeyAsync("godot_net_saves", "autosave", new
        {
            value = "{\"wave\":3,\"tension\":0.74}"
        });

        byte[] mp3 = await _ai.PostAudioSpeechBytesAsync(new
        {
            model = "zen-voice",
            voice = "af_heart",
            input = "Autosave synced. Wave three approaching."
        });
        _voice3D.Stream = new AudioStreamMP3 { Data = mp3 };
        _voice3D.Play();
    }
}

# Offline unit & schema assertions (no API key needed)
HANZO_OFFLINE=1 godot --headless --path . -s res://tests/sdk_check.gd

# Live end-to-end verification against https://api.hanzo.ai/v1
export HANZO_API_KEY="$(hanzo auth token)"
godot --headless --path . -s res://tests/sdk_check.gd
godot --headless --path . -s res://examples/game_backend.gd