User repository on GitHub
Ruby client for typesafe.ai
- Forks
- 4
- Last pushed
- Updated Oct 2026
Repo stats from the GitHub API, cached Oct 2026.
Jev directory
CommunityJev Repos & SDKs
typesafe-sdk (Ruby client)
A Ruby client for TypeSafe's System One API that returns typed Noul, Choice, and Score answers, validates obvious input mistakes before spending a request, and pools HTTP connections across threads.
- Stars
- 7
- Language
- Ruby
- License
- MIT
- Reading time
- 3 min
- Published by
- Community
- Author
- joshmn
- Last verified
- Sep 2026
About this project
A Ruby client for the TypeSafe System One API. Grab an API key from the TypeSafe console and hand it to the client. It uses jev-latest unless you tell it otherwise. There are three question types. Every question takes optional instructions, and instructions and criteria can be a string, a hash, or an array if you need more structure than a sentence. See primitives for when to reach for which. Noul is a yes/no question. The answer is the probability of yes, from 0 to 1. Criteria are optional.
Quoted from the project's README. Read the full README.
Works forJev for Scoring
Used inJev for Software & DevTools
Highlights
- One system_one call mixes hashes and typed question objects; extra keys pass through to the API untouched for forward compatibility.
- ScoreAnswer#score is probability-weighted and can land between levels (1.6 is a real answer), with legend and probabilities keyed by integer level.
- The SDK checks no questions, a score with fewer than two levels, a hash choice without criteria, and Float::NAN in state before sending.
- The client never reads environment variables, takes the key explicitly, and the transport is thread-safe.
- Unknown answer types log a warning and are skipped instead of raising, so a newer API field does not break the call.
Watch out
MIT-licensed. Requires Ruby 3.1 or newer; there is no async client or separate connect and read timeouts, and it is a community gem not affiliated with TypeSafe.
Questions about this entry
Short answers drawn from the linked project or page.
It logs a warning and skips it instead of raising, so a newer field cannot break the call, and the untouched body stays on response.http_response if you need it. The forward direction is covered too: extra_body is shallow-merged over the request body last, so you can pass a request field the API has and the gem does not yet. Which specific fields may arrive is not documented.
Not documented. The README carries no maintenance status, support policy or version history section, and states only that Ruby 3.1 or newer is required and installation is via bundle add or gem install. Check the repository's commit and release history before depending on it.
No, on purpose. Everything is set on the client, so where the key comes from, Rails credentials, ENV.fetch or a vault, is your call. Defaults are jev-latest as the model, https://api.typesafe.ai as the base URL, and a 10.0 second timeout per HTTP operation, with retry_policy and transport injectable.
It retries 408, 429 and every 5xx including TypeSafe's 529 overloaded, plus connection failures and timeouts. That is two retries by default with exponential backoff and jitter, honoring Retry-After and retry-after-ms, giving up once the whole call would pass a 30-second budget, and sending X-TypeSafe-Retry-Count on every retry after the first.
Ruby 3.1 or newer; install with bundle add typesafe-sdk or gem install typesafe-sdk, and the client defaults to the jev-latest model unless you pass another.
Extra keys on a question hash go to the API untouched, and extra_body on a call is shallow-merged over the request body last, so it wins a collision with state, model or questions for request fields the gem does not yet have.
It raises Typesafe::SDK::Error for obvious mistakes such as no questions, a score with fewer than two levels, a hash choice with no criteria, or a Float::NAN buried in your state, so you do not burn a round trip finding out.
More Jev resources like this
A Ruby client for Noul, Choice, and Score decision models, reaching OpenRouter by default or TypeSafe's native API, with no runtime dependencies beyond the standard library.
Jev Repos & SDKs#community#ruby#sdk
Community
obie/ruby_decision_modelRuby
obie/ruby_decision_modelRubyA dependency-free Swift 6 client for the TypeSafe AI System One API, ported from the official JavaScript and Python SDKs, with Choice, Score, and Noul questions, strict concurrency, and configurable retries.
Jev Repos & SDKs#community#swift#sdk
Community
alterhq/typesafe-sdk-swiftSwift
alterhq/typesafe-sdk-swiftSwiftA community Rails integration built on the typesafe-sdk Ruby gem that adds Rails configuration, persisted usage and cost telemetry, and persistence-backed confidence policies for Choice and Score answers.
Jev Repos & SDKs#community#ruby#sdk
Community
GenieRobot/typesafe-ai-railsRuby
GenieRobot/typesafe-ai-railsRubyA zero-dependency Ruby client for Jev: ask typed Noul, Choice and Score questions about your application state and get frozen, typed answers with probabilities, confidence and token usage. Pure Net::HTTP and JSON, so it fits plain Ruby and Rails alike.
Jev Repos & SDKs#community#catalog-import#logicrw
Community
dtheofr/typesafe-jev-rubyRuby
dtheofr/typesafe-jev-rubyRubyAn unofficial PHP client for the TypeSafe AI System One API with typed Noul, Choice, and Score responses, synchronous and Guzzle-promise calls, model discovery, retries, and PSR-3 logging.
Jev Repos & SDKs#community#php#sdk
Community
Butochnikov/typesafe-sdk-phpPHP
Butochnikov/typesafe-sdk-phpPHPA filesystem-first framework for durable AI agents whose auto model router defaults to Jev through Vercel AI Gateway and whose evaluate helper asks typed Choice, Score, and Boolean questions inside tools.
Jev Repos & SDKs#community#typescript#agents
Community
vercel/eveTypeScript
vercel/eveTypeScriptFrom the Jev guides
Original write-ups on what this entry is for.
From the Jev AI model community
Posts from builders shipping with Jev right now.