Skip to content

everything-about-jev

Chinese-first guide to Jev with runnable Python, TypeScript, Node and curl demos plus a catalogue of community projects.

ProjectbetaMIT

This repository is mostly documentation or write-up rather than runnable code.

Overview

Everything about Jev collects usage notes, example code, community projects and discussions about TypeSafe's decision model, written primarily in Chinese with an English version. It explains Choice, Noul and Score with return fields, what Jev suits (classification, routing, screening, bounded action selection) and what it does not, and warns that confidence and the chosen option's probability are different fields.

The quickstart uses a community API at jevai.org by default, with a separate guide for the official TypeSafe SDK. Demos cover a command palette (mapping a sentence to actions such as dark mode), ticket triage with queue, human-needed and urgency, research claim checking, model routing, tool-call guarding and completion checking, in Python, TypeScript, Node.js and curl. CI checks run on the repository.

What the decision model decides

TypeQuestionAnswers
ChoiceWhich command palette action matches this sentence?dark_mode · export · help
Yes / noDoes this ticket need human handling?yes · no
ScoreHow urgent is this ticket?—

How it works

  1. Clone the repo and install requirements
  2. Add a community or official API key to .env
  3. Run a demo case
  4. Explore the project catalogue and docs

Strengths

  • Many small runnable examples across languages
  • Clear explanation of confidence vs probability
  • Community project catalogue

Caveats

  • Default quickstart uses a third-party community API
  • Chinese-first documentation

Getting started

python -m pip install -r requirements.txt, set JEVAI_API_KEY in .env, then python demos/python/quickstart.py.

At a glance

Type
Project
Status
beta
Language
Python
Runtime
demo scripts (Python, TypeScript, Node, curl)
Has code
yes
Has tests
yes
License
MIT

Use cases and integrations

How curated lists describe it

Frequently asked questions

Which API does it use?

A community API at jevai.org by default; official SDK examples are also documented.

What demos are included?

Command palette, ticket triage, research checks, model routing, tool guard and completion checks.

Is it in English?

Chinese first, with an English README.

Related projects

  • Awesome list and guide to System One models (Jev, Laya and others) organized around a five-stage agent lifecycle, with comparison tables.

    Projectproduction
  • Opinionated catalog of 84 Jev projects in 11 categories, each with a hand-written reason it is worth looking at.

    Projectproduction
  • Unofficial collection of Jev state formats, question patterns, cookbook index and case studies, plus a ranked Top 30 of community builds.

    Projectproduction
  • Bilingual catalogue of 183 Jev applications in 11 categories, explaining how each works and what its demo actually proves.

    Projectproduction
  • Repository behind jevhub.io: plain-English Jev guide, ready-to-run examples, cost data and a directory of community builds.

    Projectproduction
  • Public contribution repo for modelsystem.one, a curated catalog of System One decision models such as Jev.

    Projectproduction