HomayoonAlimohammadi/jev-sdk-go
User repository on GitHub
Jev SDK in Go
- Forks
- 0
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
CommunityJev Repos & SDKs
Jev SDK Go
Dependency-free Go 1.24+ client for Jev Noul, Choice, and Score questions: ChoiceOf[T] and ScoreOf[L] return the caller's own types and reject labels the question never offered, with validation before sending, retries that honor Retry-After, OpenRouter support, and eleven tested examples.
- Stars
- 1
- Language
- Go
- License
- MIT
- Published by
- Community
- Last verified
- Oct 2026
About this project
A Go client for the TypeSafe AI API. TypeSafe answers structured questions about a piece of content. You name each question; the answers come back under those names, with the probabilities behind them. Zero dependencies — standard library only. A Choice's criteria maps each label to a description of when it applies. For labels that speak for themselves, jev.Labels saves writing the nils:
Quoted from the project's README. Read the full README.
Used inJev for Software & DevTools
- Languages
- Go
- Platforms
- APIOpenRouter
- Capabilities
- Open sourceRequires API key
Highlights
- Zero dependencies beyond the Go standard library; requires Go 1.24 or later and TYPESAFE_API_KEY (or the WithAPIKey option).
- ChoiceOf[T] and ScoreOf[L] return the caller's own types and reject any label or level the question never offered.
- Default retry policy retries twice on 408, 429, and 5xx with exponential backoff from 500 ms to 5 s inside a 30 second budget.
- Eleven runnable examples cover basic, triage, moderation, rerank, batch, config, decode, resilience, observability, openrouter, and gateway.
- Response bodies are read under a 1 MiB cap, and the SDK's own HTTP client refuses to follow redirects to avoid leaking Authorization headers.
Watch out
MIT license; defaults are 10s per attempt and jev-latest, and the README notes that one-level Score floors follow observed service behavior as of 2026-09-20 which departs from the documentation's two-level minimum.
Questions about this entry
Short answers drawn from the linked project or page.
No. The README states it uses the standard library only, with a pooled HTTP client of its own; you can inject your own with WithHTTPClient, but then raise MaxIdleConnsPerHost for concurrent use.
Yes. Point WithBaseURL at https://openrouter.ai/api and use an OpenRouter key; the default jev-latest maps to ~typesafe/jev-latest. ListModels does not work there, and OpenRouter's separate Decisions API is not supported.
ChoiceOf[T] and ScoreOf[L] take labels and levels of your own types. Register each question with jev.Ask, which returns a typed handle, and the answer comes back as your type so the compiler checks the switch over it. Key.Answer also validates the answer against the question, so a label the question never offered fails with a ResponseError rather than yielding a value that is none of your constants.
State must encode to a string, object or array, every question needs a non-empty name, a Choice needs 1 to 255 labels, a Score needs 1 to 10 non-null levels, and a Noul must ask something. The one-level Score floor and the Noul rule follow the service's reported behavior as of 2026-09-20, which departs from the documentation's two-level minimum, and are not yet confirmed by the SDK's own live tests.
APIError covers an unsuccessful HTTP response and carries status, body, headers, request ID and the server's RetryAfter, matched by errors.Is against ErrBadRequest, ErrUnauthorized, ErrForbidden, ErrNotFound, ErrUnprocessable, ErrRateLimited and ErrServer. TransportError means the request never arrived, and ResponseError names the missing field. By default a call is retried twice on 408, 429 and 5xx with backoff from 500 ms to 5 s inside a 30 s budget, and a server asking for longer than MaxRetryAfter is taken at its word.
On purpose: the threshold depends on what a wrong yes and a wrong no cost you, which is the one part of the decision the SDK cannot know. A Client is safe for concurrent use and keeps its own pool, response bodies are read under a 1 MiB cap so a runaway server cannot exhaust memory, and the SDK's own HTTP client refuses to follow redirects so Authorization headers cannot leak. MIT licensed, Go 1.24 or later.
Answers carry readings you would otherwise compute: Ranked returns labels from most to least probable with the runner-up at index one, Level returns the rubric level a score rounds to clamped to the rubric, and Description returns what the rubric says about that level. Every question you ask must come back answered and answered in kind, or the call fails with a ResponseError naming it, because a missing Noul would otherwise read as a confident zero.
More Jev resources like this
1.9kGitHub stars
A Go-based team workspace with optional Jev AI for agent auto-routing, task auto-fill, auto-assign, and automation condition nodes.
Jev Tools & CLIs#community#go#agents
Community
Paca-AI/pacaGo
Paca-AI/pacaGo2GitHub stars
Ruby gem that makes System One measurement a language primitive: psi prepares a state, judge/choose/score return calibrated distributions, and ? collapses them for control flow. Ships TypeSafe, protocol (/v1/systemone) and CUA providers behind one interface with its own spec suite.
Jev Repos & SDKs#community#ruby-gem#sdk
Community
innocentdiaz/s1_rubyRuby
innocentdiaz/s1_rubyRuby1GitHub stars
Unofficial portable Clojure SDK for TypeSafe System One. It posts state and typed questions to /v1/systemone, lists available models, and returns validated Clojure data with keyword or string answer keys, on a JVM backend or a native Jolt backend.
Jev Repos & SDKs#community#clojure#sdk
Community
antlobach/clojevClojure
antlobach/clojevClojure4.5kGitHub stars
Ruby-native AI framework whose RubyLLM::Judge class asks typed judgment questions: a probability that a statement holds, choices or scores, answered by the TypeSafe provider alongside 18 other hosted and local providers under one consistent API.
Jev Repos & SDKs#community#ruby#framework
Community
crmne/ruby_llmRuby
crmne/ruby_llmRuby73GitHub stars
High-performance Go event bus with a bounded MPMC ring buffer, fan-out and ordered handlers, plus an optional routing layer that evaluates deterministic rules first, reuses cached decisions, and asks Jev a typed Choice only for ambiguous cache misses.
Jev Integrations & Adapters#community#go#event-bus
Community
Protocol-Lattice/GoEventBusGo
Protocol-Lattice/GoEventBusGo21GitHub stars
Self-hosted Python SDK and System One-compatible API for runtime-defined Choice, Boolean and Score decisions on pinned open models, across Torch, vLLM, MLX, llama.cpp and WebGPU. Each result records probabilities, token usage, timing, model revision and prompt version, with committed row-level benchmarks.
Jev Repos & SDKs#community#sdk#self-hosted
Community
chengyongru/fastjevPython
chengyongru/fastjevPythonFrom the Jev guides
Original write-ups on what this entry is for.
Closed weights have not stopped the ecosystem from rebuilding the shape in the open. API-compatible servers, retrained heads on small models, and inference-time tricks that skip generation entirely.
Jev Repos & SDKs#open-models#research#local
Read article
From the Jev community
Posts from builders shipping with Jev right now.