Getting Started

This guide assumes you are working from the repository root.

Requirements

• Rust toolchain with edition 2024 support.
• cargo.
• protoc if protobuf compilation fails during server builds.
• Flutter and Dart for the mobile client.

Run the CLI

Check the CLI:

cargo run -p cli -- --help

Start the server:

cargo run -p cli -- serve

The server listens on 0.0.0.0:50051 by default.

Pair the app

When the server starts, it prints a loka://pair URL. The URL contains:

• The server address and port.
• The TLS certificate fingerprint.
• A time-limited pairing token.

Open the mobile app and use this URL to connect.

Use demo mode

Demo mode starts the server with a bundled deterministic ACP demo agent and demo workspace:

LOKA_DEMO=1 cargo run -p cli -- serve

Demo mode is useful for review and onboarding because it does not require an external agent or LLM provider.