Developer SDKs — build on Kohala with a typed client & framework adapters

Frequently Asked Questions

What are the Kohala Developer SDKs?

The Kohala Developer SDKs are a first-party, typed client over the Kohala public REST API plus framework adapters for React, Next.js, Vue, Node.js, and Python. They let you create and edit Agents, trigger runs, read health and history, manage Skills, and drive Koans and Reports with the same field names you see in the workspace.

Do I need an account to use the SDK?

Yes. The SDK authenticates every request with a pk_ API key tied to your account and meters it against your credit balance. A free personal account is enough to start — each one includes 1,000 credits at registration, then pay-as-you-go top-ups.

How do I get an API key?

Create a free personal account, open the Developer tab in your profile, and generate a key. Keys start with pk_ and carry your account's scope and credit balance. Keep them server-side — the framework adapters render Koans and reports in the browser without ever exposing the key.

Which frameworks are supported?

The core client is isomorphic and runs anywhere JavaScript does, with dedicated adapters for React, Next.js, Vue, and Node.js, plus a first-party Python client for data teams and scripts. Every adapter targets the same public API endpoints.

Is there an SDK for building native mobile apps?

Yes, for both platforms. KohalaMobile is the first-party Swift package for iOS and macOS, and kohala-mobile is the matching Kotlin library for Android (coroutines-based, with the chat stream as a Flow). Both wrap the mobile-token API rather than the pk_ key surface: users sign in with their Kohala credentials or by scanning a QR pairing code, then the app can chat with Lani (including file attachments), act on Canvas activity and approvals, render Koans and reports in a WebView, and check the account's balance. Mobile tokens are available on every Kohala plan.

What's the difference between the SDK and the Devkit?

The SDK is the typed client and framework adapters that talk to the hosted Kohala platform. The Devkit is an open-source, local-only toolset (CLI, emulator, MCP memory server) that lets you build and test agents on your own machine without an account. You can start with the Devkit and later push the same agent to the platform unchanged.

Can I run agents locally before deploying to the platform?

Yes. The open-source Devkit includes a local emulator that runs the full agent loop with governance, memory, and validation — no account or metering required. When you're ready, one command pushes the same agent to your Kohala account with zero migration.

How do I rotate or revoke an API key?

Open the Developer tab in your profile, find the key you want to rotate, and click Revoke. The key is invalidated immediately and all requests using it stop. Generate a new key and update it in your codebase. There is no grace period — revocation is instant.