Operance
Public Beta · v0.1.0

Your ComputerUnderstands You Now.

Operance is a local-first AI desktop action layer. Say or type what you want, then route it through typed actions, validation, policy, and OS adapters before anything runs.

Install the Fedora beta View on GitHub

Fedora KDE Plasma Wayland first · Windows and macOS are architecture targets

How It Works · One Command, Five Safe Steps
|
1 · Input
You speak or type
tray / CLI / voice loop
2 · Match
Known command matched instantly
no AI needed for common phrases
3 · Plan
Local AI can fill the gap
optional · bounded typed output
4 · Check
Validated before it runs
destructive ops need confirmation
5 · Run
Your OS does the work
native adapter dispatch
What Is Operance

No Raw Shell Access. No Guessing.

Every command turns into a typed, checked action instead of an arbitrary shell call. Common phrases are matched deterministically. Optional local model planning is still constrained to Operance's typed action schema, validation, policy, and confirmation gates.

The current public beta is honest about scope: Fedora KDE Plasma Wayland first, source checkout for contributors, and an RPM runtime path for early testers.

What You Get

Powerful. Private. Safe by Design.

Voice or Text, Your Choice

Click the tray to talk, type a command, or run the local voice loop during development.

Easy to Extend

Add commands or port to a new OS by working through providers and adapters, not by branching the core.

Local-First by Architecture.
Not just a preference.

Operance keeps the core desktop workflow on your machine. The tray and verified commands work without an AI model; optional planner fallback can be enabled only after readiness checks pass.

  • + No cloud required for core use. Verified commands work offline without a model.
  • + No account required. Install, smoke test, and file issues from a local setup.
  • + No arbitrary shell execution. Tools must pass typed schema, validation, and policy.
  • + Open source. Inspect the runtime, adapters, planner, and safety code.
  • + AI is optional. Local planner fallback is bounded and disabled unless configured.
Try It Now

Install the Packaged Fedora Beta.

Download setup.sh and the RPM from the same GitHub release, then run these commands to install, verify, and list the commands available on your host. 

bash ./setup.sh --package ./operance-0.1.0-1.noarch.rpm
operance --installed-smoke
operance --supported-commands --supported-commands-available-only
Things You Can Say

Just Say What You Mean.

Current Fedora KDE Wayland beta examples. Availability depends on host readiness; destructive actions ask for confirmation.

open browser open google.com open firefox what time is it wifi status what is my battery level what is the volume set volume to 50 percent mute audio list windows switch to window <title> show recent files create folder on desktop called <name> delete file on desktop called <name>
Developers

Read the Docs. Build What's Missing.

All guidance lives in the repo as Markdown. Start with the README, then pick the doc that matches what you want to build.

Start here README.md Scope, install path, current status. Install docs/release/public-beta.md Release assets, setup, feedback loop. Architecture docs/architecture/overview.md Core, providers, adapters, runtime flow. Port to a new OS docs/architecture/adapter-authoring.md Add OS support without rewriting core. Add commands docs/contributing/command-authoring.md Typed actions, validation, promotion. Linux setup docs/requirements/linux.md Fedora/KDE packaging, systemd, diagnostics.
How It's Built

One Engine. Many Operating Systems.

Your words pass through shared safety layers before any native desktop action runs. Intent, planner, policy, validation, daemon, and runtime orchestration stay portable while providers and adapters own host readiness and OS-native execution.

Windows and macOS provider scaffolds exist for adapter authors, but the public beta runtime is Linux first.

1You speak or type
2Command matched to safe action
3Validated and confirmed if needed
4Platform provider checks readiness
5OS adapter runs the action
Security by Design

Safe Because of How It's Built.

Operance does not rely on a model deciding what is safe. Safety is structural: every command has to resolve to an approved typed action before it can reach an adapter.

x
No raw shell commands

The planner cannot invent an arbitrary command. Every action must be in the typed tool catalog.

x
No cloud required for core use

Verified tray and command flows work locally without an AI model or hosted account.

x
No silent destructive file changes

Move, rename, quit, and delete flows are confirmation-gated where policy requires it.

x
No AI required for basic use

Common commands are matched deterministically, so the beta remains useful without planner setup.

Where It Runs

Linux Now. More Later.

+ Linux · Fedora KDE Wayland
~ Windows · adapter target
~ macOS · adapter target

Ready to Turn Intent into Action?

Public beta · Open source · MIT licensed

Get started on GitHub File an issue Contribute

operance --version · v0.1.0 · MIT License