Should I use raw structs or the builder pattern?

Use either; the builder is a concise wrapper that produces the same EvaluationRequest used by Client.Evaluate. Raw gives direct control over structs and the question map, builder chains Noul, Choice, and Score then Build.

How should I handle a missing answer ID?

Prefer Get for safe lookup since it returns the answer plus a bool. MustGet returns the answer directly and panics when the ID is missing, so only use it when absence is a programming error.

What happens on rate limits or overload?

The client retries 429 Too Many Requests and 529 Overloaded with exponential backoff. You can customize behavior with WithHTTPClient, WithMaxRetries, and WithRetryBackoff, plus WithBaseURL for alternate endpoints.

Is this the official TypeSafe Go SDK?

No. The readme states it is not official and is community-maintained, primarily by Kisshan13. It targets the System One evaluation API and defaults to JevLatest when EvaluationRequest.Model is omitted.

How do I install the Go SDK and set the endpoint?

Run go get github.com/kisshan13/typesafe-ai-go and import it. The default model is typesafe.JevLatest and the base URL is https://api.typesafe.ai, changed with typesafe.WithBaseURL(...); an empty URL restores the default.

How does it handle rate limits and overload?

The client retries 429 Too Many Requests and 529 Overloaded responses with exponential backoff, customizable through WithHTTPClient, WithMaxRetries and WithRetryBackoff.

Which license is the SDK under?

The project is available under the MIT License, with the full text in the repository's LICENSE file.

CommunityJev Repos & SDKs

TypeSafe AI Go

Community Go client for the TypeSafe System One evaluation API with raw structs and a builder that produce the same EvaluationRequest, defaulting to jev-latest.

See highlights

Open github.com

Stars: 4
Language: Go
License: MIT
Published by: Community
Author: kisshan13
Last verified: Oct 2026

kisshan13/typesafe-ai-go

User repository on GitHub

View on GitHub

Community-maintained Go SDK for the TypeSafe AI System One evaluation API, with typed questions, fluent builders, retries, and examples.

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

Go client for the TypeSafe System One evaluation API. This is not an official TypeSafe AI Go SDK. It is a community-maintained project primarily maintained by Kisshan13. Then import it in your Go program: The default model is typesafe.JevLatest ("jev-latest"). You can omit EvaluationRequest.Model to use it, or set it explicitly. The default API base URL is configure another endpoint with typesafe.WithBaseURL(" Passing an empty URL restores the default endpoint.

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

Tagscommunity jevbest catalog-import awesomejev

Works forJev for Classification

Used inJev for Software & DevTools

Languages: Go

Highlights

Raw and builder patterns emit the same EvaluationRequest with Noul, Choice, and Score questions.
Answers.Get returns Answer plus bool for safe lookup; MustGet returns directly and panics on missing IDs.
Client retries 429 and 529 responses with exponential backoff for rate and overload handling.
Base URL defaults to https://api.typesafe.ai and can be customized, with empty string restoring the default.

Watch out

Community-maintained and not official; see the examples directory for runnable patterns and configure retries with WithBaseURL, WithHTTPClient, WithMaxRetries, and WithRetryBackoff. 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

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.