kieranklaassen/ruby_llm-typesafe
User repository on GitHub
TypeSafe structured-output provider for RubyLLM 2
- Forks
- 1
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
Jev directory
CommunityJev Repos & SDKs
Ruby LLM TypeSafe
A RubyLLM 2 provider that adds Jev through structured output: build Noul, Choice, and Score questions with a schema builder, pass them to chat.with_schema, and read typed answers from response.parsed.
- Stars
- 18
- Language
- Ruby
- License
- MIT
- Reading time
- 3 min
- Published by
- Community
- Author
- kieranklaassen
- Last verified
- Sep 2026
About this project
A RubyLLM 2 provider for TypeSafe. TypeSafe runs Jev, a System One model. Jev does not write text. You give it one piece of state (a string, or JSON your application already has) and a batch of typed questions. It answers each question with a probability your code can act on. There are three question types, which TypeSafe calls primitives: Noul asks whether something is true and returns the probability of yes. Choice picks one option from a set you define and returns a probability for each option.
Quoted from the project's README. Read the full README.
Works forJev for Scoring
Used inJev for E-commerce & Retail
Highlights
- Registers a :typesafe provider with RubyLLM 2, so Jev requests travel through RubyLLM's structured output API rather than text generation.
- Calling ask without a schema, streaming, and tools raise an error before any request is sent.
- Validation runs when a question is added: duplicate ids, missing instructions, an empty Choice map, or a Score under two levels raise ArgumentError.
- Supports RubyLLM >= 2.0.0.rc3, < 3 on Ruby 3.1.3 and newer and adds a packaged TypeSafe model catalog to RubyLLM's registry.
- The key goes only in the Authorization: Bearer header, and timeouts, proxies, retries, and logging come from RubyLLM's own configuration.
Watch out
MIT-licensed. Needs Ruby 3.1.3+ and a TYPESAFE_API_KEY; it works through structured output only, so schema-less asks, streaming, and tools are refused before any request.
Questions about this entry
Short answers drawn from the linked project or page.
The built-in ones if you can wait for the release. The README says the next RubyLLM release adds judgments with RubyLLM::Judge classes answered by TypeSafe's Jev through a provider built into RubyLLM. Both register a provider named :typesafe, so do not load both; when you upgrade, remove this gem from the Gemfile.
No. The provider works through RubyLLM's structured output API and nothing else, so calling ask without a schema, streaming, and tools each raise an error before any request is sent. Build questions with the Schema builder, pass them to chat.with_schema, and read the typed answers from response.parsed.
It judges whatever you hand it. The latest user message is the state: plain text is sent as a string, and a message that is a JSON object or array is decoded and sent as structured state, so records, chat logs and application state pass through as they are. Instructions and criteria also accept hashes, arrays and nil.
You find out before spending anything. Validation runs when you add a question: duplicate or unsafe ids, missing instructions, an empty Choice map, a Score with fewer than two levels, and values that are not JSON all raise ArgumentError. A Choice also wants a no-match option, since the model cannot choose one you did not list.
Add gem 'ruby_llm', '>= 2.0.0.rc3' and gem 'ruby_llm-typesafe' to your Gemfile. Requiring the gem registers the :typesafe provider, its config options, and a packaged TypeSafe model catalog. It supports RubyLLM >= 2.0.0.rc3, < 3 on Ruby 3.1.3 and newer, and requests run through RubyLLM's own Faraday stack.
A Noul returns the probability of yes as noul between 0 and 1, where a value near 0.5 means equally likely rather than medium. A Choice returns the winning choice plus a probabilities map over every option and a confidence. A Score returns a probability-weighted score that can land between levels, a legend, per-level probabilities, and a confidence.
Yes. The latest user message is the state: plain text is sent as a string, and a message that is a JSON object or array is decoded and sent as structured state, so records, chat logs, and application state pass through as they are. Instructions and criteria also accept hashes, arrays, and nil for multi-part questions.
More Jev resources like this
A local server and Python package that runs open models with Hugging Face Transformers or PyTorch and returns Choice, Score, and Noul answers read from next-token logits instead of generated JSON.
Jev Repos & SDKs#community#python#open-models
Community
featherless-ai/simple-jevPython
featherless-ai/simple-jevPythonA 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_modelRubyAn Elixir client that treats Jev as a peer GenServer: you reply with questions and its typed answers arrive as messages you pattern-match, with network-free tests.
Jev Repos & SDKs#community#elixir#sdk
Community
dannote/jevElixir
dannote/jevElixirA 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.
Jev Repos & SDKs#community#ruby#sdk
Community
joshmn/typesafe-sdkRuby
joshmn/typesafe-sdkRubyA TypeScript library that walks a taxonomy and calls Jev once per level, so a choice can cover thousands of leaves despite Jev's 255-option limit per question.
Jev Repos & SDKs#community#typescript#sdk
Community
reachjalil/jev-treeTypeScript
reachjalil/jev-treeTypeScriptAn async Python client for Jev with typed Noul, Choice, and Score helpers: questions batch into one request, and callers get probabilities, choices, and weighted scores instead of text to parse.
Jev Repos & SDKs#community#python#sdk
Community
AboveColin/jevclientPython
AboveColin/jevclientPythonFrom 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.