How does this compare with the official SDKs?

It uses only the standard library and the same TYPESAFE_* environment variables, supports structured state and derived clients, and states it is independent rather than endorsed by TypeSafe.

What setup and call shape should I expect?

Install with go get on Go 1.24 or later, create a client from the environment, then call Ask with one state and any number of named questions or use single-question shortcuts.

What state shapes are accepted or rejected?

State can be a JSON string, object, or array, with an object recommended; a struct with json tags works, while a bare bool or number is rejected locally before any request.

Where should gating logic live and how do retries act?

Keep thresholds in your code because the model reports findings while policy decides outcomes. Retries cover 408, 429, 5xx, and connection errors, honor Retry-After, and stop on context cancellation.

How do I read an answer without risking a panic on a typo?

Answers come back through a map. A missing name returns an error wrapping ErrNoAnswer and reading an answer as the wrong type wraps ErrAnswerType; neither panics, so check the returned errors instead of asserting.

What are the default retry settings, and do I have to configure them?

Only MaxRetries needs setting. Defaults are two retries, 500ms initial backoff, a 5s cap, 0.25 jitter, honoring Retry-After up to 60s and retrying connection errors, so a literal is the default policy plus whatever you change.

How do immutable derived clients work for per-call overrides?

WithModel, WithTimeout, WithRetry, WithHeader and WithExtraBody return a modified copy and leave the receiver unchanged, like context.WithTimeout, so you can chain a one-off override onto a call or build a reusable client once and share it.

CommunityJev Repos & SDKs

Gosys1

Go SDK for the SystemOne API using only the standard library, sending state plus Noul, Choice, and Score questions and returning structured answers with retries and typed errors.

See highlights

Open github.com

Stars: 2
Language: Go
License: MIT
Published by: Community
Author: robertjndw
Last verified: Oct 2026

robertjndw/gosys1

User repository on GitHub

View on GitHub

Unofficial Go client for TypeSafe's SystemOne API: typed questions in, typed answers out. Standard library only.

Forks: 0
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.Homepage

About this project

gosys1 is a Go client (SDK) for TypeSafe's SystemOne API, which runs TypeSafe's Jev models. You send a piece of content as state plus one or more typed questions (yes/no, multiple choice or a graded score) and get back structured, typed answers instead of parsing JSON by hand. It uses only the Go standard library and comes with retries, typed errors and configuration through the same TYPESAFE environment variables as the official SDKs.

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

Tagscommunity github

Works forJev for Classification

Used inJev for Software & DevTools

Languages: Go

Highlights

Sends one state with many named Noul, Choice, and Score questions and keys answers by those names on the wire.
Accepts structured JSON state, rejects blank or duplicate names and bare scalars locally, and offers single-question shortcuts.
Reads probabilities, rankings, nearest levels, labels, legends, and confidence without panicking on missing or mistyped answers.
Configures key, base URL, model, timeout, retries, headers, and body through env plus immutable derived clients.

Watch out

Independent community client with no TypeSafe affiliation; thresholds and policy stay in caller code and context deadlines stop retries. 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

jev

Go Unix CLI that pipes state on stdin into one Jev question — noul, choice, or score — across TypeSafe, Cloudflare, and Vercel providers, printing machine-readable JSON and signaling success by exit code.