mirror of
https://github.com/hanzoai/godot-sdk.git
synced 2026-11-14 21:30:44 +00:00
1.3 KiB
1.3 KiB
hanzoai/godot-sdk — notes for maintainers & agents
Home: github.com/hanzoai/godot-sdk. Checkout: ~/work/hanzo/godot-sdk.
Addon path: addons/hanzo_ai/.
Architecture
addons/hanzo_ai/hanzo_client.gd(HanzoClient): Pure-GDScript client over Godot 4'sHTTPClient+TLSOptions.client(). ReadsHANZO_API_KEY,HANZO_BASE_URL(defaulthttps://api.hanzo.ai), andHANZO_ORG_ID(X-Org-Id) once inreload_config().- Godot 4
HTTPClientquirk: Always readhttp.has_response()beforehttp.get_response_headers_as_dictionary()— the latter clears internal response headers and makes subsequenthas_response()returnfalse.
- Godot 4
addons/hanzo_ai/hanzo_agent_3d.gd(HanzoAgent3D): Non-blockingNode3Dwrapper dispatchingzen6,kai, andzen-voicecalls ontoWorkerThreadPooland emitting signals (decision_ready,reply_ready,speech_ready) viacall_deferred.- Models: Default to Zen 6 (
zen6,zen6-flash,zen6-coder,zen6-max),kaifor/v1/decisions, andzen-voicefor/v1/audio/speech.
Testing
# Offline wire & node checks
HANZO_OFFLINE=1 godot --headless --path . -s res://tests/sdk_check.gd
# Live gateway verification against https://api.hanzo.ai
HANZO_API_KEY=$(hanzo auth token) godot --headless --path . -s res://tests/sdk_check.gd