Locara

Getting started

A Locara app is a standalone Tauri app that uses the Locara framework. The CLI scaffolds, the SDK provides typed APIs, and the runtime enforces capabilities.

Prerequisites

  • Bun ≥ 1.1
  • Rust ≥ 1.95 (for building Tauri shells)

Scaffold

locara init blank my-app
cd my-app
bun install
locara dev

A window opens with a default chat UI. Edit src/App.tsx; changes hot-reload.

Add a model

Open locara.json and adjust capabilities.models. The framework will refuse to load any model not in this list — by design.

{
  "capabilities": {
    "models": [
      "qwen2.5-3b-instruct-q4@sha256:abcdef..."
    ]
  }
}

Add a capability

Want microphone access? Declare it:

{
  "capabilities": {
    "device": { "microphone": true }
  }
}

If you call mic-related SDK methods without declaring this, locara verify will tell you, and the runtime will deny.

Verify

locara verify

This checks the manifest schema and runs the static capability analyzer. Every error is a hard fail — fix before publishing.

Test

bun test

The default scaffold includes capability tests. Add your own using @locara/test.

Next