Skip to content
Metatext Decide — typed decisions for your agents, with a probability on every answerGet early access
Metatext
Sign Up

system-one (asynq-io)

Vendor-neutral Python SDK for System One models with one ask(state, questions) contract over hosted APIs or local ONNX.

Librarybeta
View on GitHub ↗

Overview

system-one from asynq-io is a vendor-neutral Python SDK for System One models built on one contract, ask(state, questions) returning answers, over the three primitives noul, choice and score. Switching providers is a configuration object rather than a code change: TypesafeConfig for hosted Jev, OpenRouterConfig for the same body at a different endpoint, HTTPConfig for any /v1/systemone host, ONNXConfig for a local in-process graph with no network or key, and a preset for Fastino's GLiDE, which serves the same contract. An async client mirrors the sync one.

Settings come from SYSTEM_ONE_* environment variables or a .env file, including backend, model, base URL, path, timeout and retries (on 408, 429 and 5xx only). Answers expose noul probabilities with confidence, choice probabilities and scores. The README stresses these are decision models, not chat models: no messages, streaming or temperature.

What the decision model decides

TypeQuestionAnswers
Yes / noDoes this need a human now?—
ChoiceWhich queue?billing · technical · other
ScoreHow severe?minor · normal · major · critical

How it works

  1. Pick a config: Typesafe, OpenRouter, HTTP, ONNX or GLiDE
  2. agent.ask(state, questions)
  3. Read typed answers
  4. Switch providers by changing the config only

Strengths

  • Hosted and local backends behind one API
  • Async support
  • Simple environment configuration

Caveats

  • Local ONNX needs model files
  • Limited retry policy by design

Getting started

pip install "system-one[http]" (or [onnx]), set SYSTEM_ONE_API_KEY, then SystemOne(TypesafeConfig()).ask(state, questions).

At a glance

Type
Library
Status
beta
Language
Python
Runtime
Python library
Has code
yes

Use cases and integrations

How curated lists describe it

  • Vendor-neutral SDK for typed decision-making (yes/no, choice, score) — hosted and local.

    hellogumbo/awesome-jev

Frequently asked questions

Which providers are supported?

TypeSafe, OpenRouter, any /v1/systemone host, Fastino GLiDE, and local ONNX.

Can it run offline?

Yes, with the ONNX backend.

Is there an async client?

Yes, AsyncSystemOne.

Related projects

  • gojev

    Go harness for System One models: hosted Jev, open Kev in-process via llama.cpp, and Cloudflare Clef, with typed helpers and a CLI.

    ServicebetaGo
  • jev

    TypeScript library for one-line local decisions with open models (kev-0.6b, kev-4b, open-jev), no API keys or cloud.

    ProjectbetaTypeScript
  • jev-foundation-models

    Swift 6 bridge that runs System One decision models behind Apple's Foundation Models API, on device with Laya or via hosted endpoints.

    ProjectbetaSwift
  • jev-php

    PHP library, extracted from LLPhant, for typed Jev Noul, Choice and Score calls, also usable with a Laya endpoint.

    LibrarybetaPHP
  • jev-switch

    Unofficial Rust gateway routing /v1/systemone requests to TypeSafe, Vercel, OpenRouter or local Laya via an editable DAG.

    ProxybetaRust
  • Jeview

    Zero-dependency local gateway and live visualiser that proxies Jev calls, logs every decision to SQLite and draws them on a real-time map.

    ProxybetaJavaScript