goose/crates/goose-sdk/README.md

goose-sdk

The bindings layer for Goose. It houses the shared types used for both ACP and SDK access, and exposes a cross-language version of the Goose API.

With --features uniffi the crate compiles to native bindings for Python and Kotlin (namespace goose / io.aaif.goose). The UniFFI surface currently lets callers construct declarative providers from JSON and stream provider completions.

just python   # build bindings + run examples/uniffi/provider.py
just kotlin   # build bindings + run examples/uniffi/Provider.kt

Python package

The PyPI package is published as goose-sdk and imports as goose. Build a local wheel from the repository root with:

just --justfile crates/goose-sdk/justfile python-wheel

This regenerates the UniFFI Python bindings, copies the release native library into the package, and writes the wheel to crates/goose-sdk/python/dist/.