Skip to content

jev (kataras)

Unofficial Go client for the System One API with Noul, Choice and Score types and rate limiting, by kataras.

LibrarybetaMIT

Overview

jev by kataras is an unofficial Go client for TypeSafe's System One API. You send a state (a string or JSON such as a ticket, log or program state) and named questions, and get back a typed answer and probability per question; adding questions to the same call adds no round trip. Question names are yours and come back as answer keys rather than being part of the prompt.

It requires Go 1.27 or newer and depends only on golang.org/x/time/rate. The README notes that jev-latest is a moving alias and recommends pinning, for example WithModel("jev-1.13.0"), when runs must hit the same model, and points to the official JavaScript and Python SDKs as references.

What the decision model decides

TypeQuestionAnswers
Yes / noIs this ticket about billing?—
ChoiceWhich team should handle this?billing · technical
ScoreHow urgent is this ticket?—

How it works

  1. go get the module
  2. jev.New() reads TYPESAFE_API_KEY
  3. Call SystemOne with state and named questions
  4. Read typed answers by your keys

Strengths

  • Single small dependency
  • Model pinning guidance
  • Built-in rate limiting

Caveats

  • Unofficial
  • Requires a very recent Go version

Getting started

`go get github.com/kataras/jev`, then `client, _ := jev.New()` and `client.SystemOne(ctx, jev.Request{...})`.

At a glance

Type
Library
Status
beta
Language
Go
Runtime
Library
Has code
yes
License
MIT

Use cases and integrations

How curated lists describe it

Frequently asked questions

Is it official?

No; the official clients are the JavaScript and Python SDKs.

Should I pin a model?

Yes, if runs must be reproducible, since jev-latest moves.

Which Go version?

Go 1.27 or newer.

Related projects

  • Hack Club's lightweight LLM proxy, listed for adding a Jev forwarding endpoint behind its auth, limits and usage logging.

    MCP serverproductionTypeScript
  • Ax, a DSPy-style multi-language LLM framework, listed with a native TypeSafe provider for Boolean, Choice, Score and raw Jev questions.

    PluginproductionTypeScript
  • Effect TypeScript library whose @effect/ai-typesafe package maps classify, probability and rating operations to Jev questions.

    ProjectproductionTypeScript
  • PHP monorepo whose Polyglot module adds a TypeSafe driver for typed Noul, Choice and Score decisions alongside LLM inference.

    ProjectproductionPHP
  • Go MCP server giving any client typed Jev decisions via OpenRouter or TypeSafe, with validated answers and no paid retries.

    MCP serverproductionGo
  • Simon Willison's LLM plugin that adds Jev as a model for yes/no, choice and score questions from the command line.

    PluginproductionPython