The perception runtime

Program whatdeserves attention.

LiveStream + Watch (Goal + Policy) -> stream<PerceptEvent>

Percept is the Apache-2.0 perception runtime for standing watches over continuous streams. State a condition in plain language; the runtime samples, judges, and gates it into one useful interruption — a durable incident with evidence and a trace.

01 · The gate

Known → act. Not → silent. Unknown → ask.

Every decision maps to exactly one of three states. The system never guesses — an unknown is never rounded up to a fire or rounded down to silence. One firing path, one gate: every fire type reaches you through the same single authority.

FIRE

The condition is confidently true and this is its rising edge — the moment it became true. One delivered incident, not one per frame: a kettle that boils for three minutes is one event, not 720 notifications.

ASK

The system cannot tell. Instead of guessing, it requests confirmation. Asks are refusals to guess, and they are counted — refused is a first-class funnel stage, never hidden.

SILENT

The condition is not true, or it already fired for this edge. Suppressed — and the suppression itself is observable, never a dropped-on-the-floor mystery.

03 · Go deeper

Run it, read it, or try it hosted.

The runtime is open source under Apache-2.0. The same boundary powers the managed path: Percept Cloud owns projects, uploads, and operations around the open engine.

QUICKSTART

Install locally.

pip install percept-vision, then the watch() one-liner — offline, with deterministic fakes and no API keys.

Open quickstart →

DOCUMENTATION

Understand the seams.

Canonical guides for the OSS runtime, Cloud, APIs, and integrations.

Read documentation →

PLAYGROUND · PREVIEW

Run a guided sample.

Use the hosted Playground for projects, uploads, and inspectable results.

Open Playground →

Release notes, compatibility, and checksums are intentionally marked Preview until the public site is connected to a clean, immutable OSS release manifest. See release status.