When should I pick the SDK over the command-line tool?

Use the SDK when branching in code over choice, probability, score, and confidence values, and the CLI when piping text through shell filters and exit statuses.

Can I run this against a local compatible server?

Yes: point the client at a local endpoint and bare hostnames expand to the versioned path, so a compatible local server works without code changes.

How do I score thousands of lines without one failure killing the run?

Yes. Line mode turns each stdin line into its own state and prints answers alongside input lines, with configurable concurrency and failures isolated to stderr.

What do the CLI exit statuses mean in shell scripts?

Zero means ok or yes, one means no or no match for quiet checks and semantic grep, and two signals an error; throttled responses retry with backoff first.

What is the Go client's default retry behavior?

WithMaxRetries defaults to 3, retrying HTTP 429 and 529 with exponential backoff, and WithTimeout caps each request including retries at 60 seconds by default, with 0 meaning no limit.

How do I point the SDK at a local server?

jev.Endpoint("localhost:8080") expands to http://localhost:8080/v1/systemone, so a local tensai server that speaks the same API works as is.

How does the Go client handle API keys?

WithAPIKey sets the key; without one no Authorization header is sent, and the package reads no environment variables itself, so configuration is entirely explicit.

CommunityJev Repos & SDKs

Go Jev

Go SDK plus a pipeline-friendly CLI for typed decisions, covering single questions, batched question maps, retries, and line-oriented filtering over stdin.

See highlights

Open github.com

Stars: 45
Language: Go
License: MIT
Published by: Community
Author: mattn
Last verified: Oct 2026

mattn/go-jev

User repository on GitHub

View on GitHub

Go SDK and CLI for TypeSafe Jev: typed decisions (yes/no, choice, score) from a model

Forks: 1
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

Go SDK for TypeSafe Jev, a decision-only model that returns typed answers (yes/no probability, choice, score) instead of text. Comes with jev-cli, a command-line tool built on it for UNIX pipelines. state, Instructions and Criteria take any value that marshals to JSON; a json.RawMessage is sent verbatim. 429 and 529 are retried with exponential backoff. A local tensai server speaks the same API:

Quoted from the project's README. Read the full README.

Tagscommunity jevbest catalog-import awesomejev

Works forJev for Classification Jev for Ranking

Used inJev for Software & DevTools

Languages: Go

Highlights

One-question and multi-question calls return labels, probabilities, scores, and confidence values.
Ordered option lists preserve author intent; unstructured values marshal to JSON transparently.
CLI adds semantic grep, quiet boolean mode for exit statuses, and JSON output flags.
Throttled responses retry with exponential backoff; local servers work via endpoint override.

Watch out

The package reads no environment variables itself; the CLI resolves keys, model, endpoint, and timeouts with flags overriding them. Copy reviewed against the repository README on 2026-10-04, not from running it.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

typesafe-sdk-go

Go SDK for the TypeSafe API that asks typed Noul, Choice, and Score questions about a state and returns probability distributions with confidence and typed accessors.