Skip to main content
System Architecture

Built on Your Computer

A desktop shell, a local backend, and a frontend workspace working together on your machine, with the website kept separate for licensing and updates.

Three Layers, One System

Each layer has a different job. Together, they create the local runtime that powers the app without turning the website into the prompt relay path.

Desktop Shell

The native Tauri shell handles windowing, sidecar lifecycle, updater wiring, and OS integration.

  • Native window controls
  • Sidecar supervision
  • Updater orchestration

Local Backend Runtime

The local Python backend owns provider dispatch, auth bootstrap, persistence, key handling, and orchestration.

  • Direct provider dispatch
  • Local persistence
  • Request orchestration

Frontend Workspace

The React interface provides Chatroom, module controls, settings, history, metrics, and workflow surfaces.

  • Multi-provider UI
  • Module surfaces
  • Local workflow control

How It Works

1

You Type a Prompt

Enter your question or task in the frontend workspace, with files, settings, and other local workflow context layered in as needed.

2

Local Backend Routes It

The local backend applies the request logic, reads the local key material, and dispatches the prompt to the selected provider.

3

Response Returns to the Workspace

The result comes back into the desktop workspace, where local history, metrics, exports, and workflow modules can act on it.

Design Principles

Local Execution

The working runtime lives on your machine, which narrows the trust boundary for normal prompt execution and local state.

Encrypted by Default

Sensitive data handling is local-first, with the desktop stack responsible for key handling and local persistence rather than a central relay service.

Direct Connections

Normal provider requests are dispatched from the local runtime to the selected provider instead of being routed through website APIs.

Transparent Design

The system is easier to reason about when the shell, local runtime, provider path, and website layer each have distinct responsibilities.

See It in Action

Download KeyRing AI and inspect the local workflow yourself. The desktop shell, local backend, and frontend workspace are the operating surface; the website stays in its own lane.