User repository on GitHub
Ruby client for the TypeSafe AI(Jev) System One API
- Forks
- 0
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
CommunityJev Repos & SDKs
TypeSafe AI Ruby
Ruby gem wrapping the TypeSafe System One API: send state with noul, choice, and score questions from plain hashes and read structured answers with probabilities and confidence.
- Stars
- 1
- Language
- Ruby
- License
- MIT
- Published by
- Community
- Author
- hnegishi
- Last verified
- Oct 2026
About this project
The TypeSafe AI Ruby library provides convenient access to the TypeSafe System One API from applications written in Ruby. Send state and typed questions to Jev, and get back structured answers with probabilities and confidence that your code can use directly. See the TypeSafe documentation for the concepts behind the API. Add this line to your application's Gemfile: No runtime dependencies beyond the Ruby standard library. Get an API key from the TypeSafe console and export it as TYPESAFEAPIKEY:
Quoted from the project's README. Read the full README.
Highlights
- Installs as `typesafe-ai-ruby` on Ruby 3.1 or newer with no runtime dependencies beyond stdlib.
- Reads `TYPESAFE_API_KEY` automatically; `TypeSafe::Client.new` takes no arguments unless overriding.
- Reuses frozen `TypeSafe::Noul`, `Choice`, and `Score` constants; extra question keys pass through untouched.
- Retries 408, 429, 5xx, connection errors, and timeouts twice with backoff honoring `Retry-After`.
Watch out
No Rails-specific code is included; configure the default client in an initializer and layer ActiveJob retries on top. 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.
Use `confidence` to choose between acting automatically and handing to a human; the examples show confidence-gated routing. Responses expose typed answers plus usage, request IDs, and the raw body via `to_h`.
Rescue `RateLimitError` and sleep `retry_after`, log `APIError` with status, body, headers, endpoint, and request ID, expect connection and timeout errors with no response, and fix `ValidationError` before sending.
Explicit options beat environment variables, which beat defaults for model, base URL, and timeout. Per-call `request_options` override model, timeout, and headers; `extra_body` shallow-merges over the request.
There is none in the library. The digest says to configure the default client in an initializer, keep questions in frozen constants, and layer ActiveJob retries above the built-ins; `examples/rails/` shows each pattern.
Add `gem "typesafe-ai-ruby"` to the Gemfile or run gem install. It needs Ruby 3.1 or newer and carries no runtime dependencies beyond the Ruby standard library. Export TYPESAFE_API_KEY from a key in the TypeSafe console and the client reads it automatically, so `TypeSafe::Client.new` takes no arguments. The gem is MIT-licensed.
noul, choice and score, each defined as a plain Hash with a type, optional instructions, and type-specific criteria. Responses are keyed by question name and expose answers, nouls, choices with choice, probabilities and confidence, scores with score, legend, probabilities and confidence, plus usage.input_tokens, request_id, model, and the raw body via to_h. Extra keys pass through untouched.
Requests that fail with 408, 429, 5xx, a connection error or a timeout are retried twice with exponential backoff that honors Retry-After, and retry_policy adjusts max_retries and backoff_max or turns retries off per call. At :info the client logs one line per request and per retry; at :debug it adds headers and bodies with credential headers redacted.
More Jev resources like this
4.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_llmRuby13GitHub stars
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.
Jev Repos & SDKs#community#github
Community
stefafafan/jevGo
stefafafan/jevGo7GitHub stars
Unofficial Go and Rust clients for the System One API covering noul, choice and score questions, with env-based config, retries, typed errors and gateway support.
Jev Repos & SDKs#community#github
Community
haileyok/typesafe-clientRust
haileyok/typesafe-clientRust3GitHub stars
Zero-dependency Go client for the TypeSafe System One API with typed noul, choice, and score questions, strict response validation, and safe concurrent use.
Jev Repos & SDKs#community#github
Community
KKloudTarus/taurus-jev-sdk-goGo
KKloudTarus/taurus-jev-sdk-goGo3GitHub stars
Community Rust client for the TypeSafe API with async and optional blocking clients, typed Noul, Choice, and Score questions, retries, and structured errors.
Jev Repos & SDKs#community#github
Community
abeldzan/jev-rsRust
abeldzan/jev-rsRust5GitHub stars
Ruby gem that groups noul, choice, and score questions into one parallel Jev query, exposing a typed result plus raw probabilities.
Jev Repos & SDKs#community#awesomejev#catalog-import
Community
virolea/jevRuby
virolea/jevRubyFrom 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.