How do I provide the API key without breaking CI builds?

Put the real key in .env.local or Symfony secrets and run jev:models to check it. The key is checked when a request is sent, so cache:clear and keyless CI builds still work.

When should I use a named client instead of the default?

Define named clients under jev:clients inheriting root settings, for example a moderation client on jev-preview or a region-specific base URL and key. Inject by argument name.

What happens when the API is down during validation?

It fails closed by default: a validator violation is added when the API is unavailable. Set fail_open or validator fail_open to accept instead.

How do I test application code without HTTP calls?

Flip fake to true so every client becomes JevClientFake with no HTTP calls, or inject the fake directly in application tests.

What are the PHP and Symfony requirements, and how is it installed?

PHP 8.4 or newer and Symfony 7.4 or 8.x, with validator, messenger, workflow plus property-access, and web-profiler-bundle all optional. Install with `composer require vbcherepanov/jev-symfony-bundle`; the Symfony Flex recipe registers the bundle and creates config/packages/jev.yaml, or you register JevBundle manually in config/bundles.php.

Which failures are retried, and which never are?

Statuses 408, 429 and 5xx including 529, plus connection errors and timeouts, are retried up to max_retries. The server's retry-after-ms header wins, then Retry-After capped at max_retry_after_ms, otherwise it backs off exponentially with jitter, and each retry carries X-TypeSafe-Retry-Count. Statuses 400, 401, 403, 404 and 422 are never retried.

What question types and limits does the bundle support?

Noul, Choice with up to 255 options, and Score with an ordered list of 2 to 10 levels. State and instructions accept a string, array, stdClass or JsonSerializable, and numeric ids or labels such as "0" and "1" are always sent as JSON objects; answer types the version does not know are kept as UnknownAnswer rather than failing the decision.

CommunityJev Tools & CLIs

Jev Symfony Bundle

Unofficial Symfony bundle exposing Jev noul, choice, and score questions through a typed client, validator constraints, Messenger background evaluation, Workflow guards, and a profiler panel.

See highlights

Open github.com

Stars: 1
Language: PHP
License: APACHE-2.0
Published by: Community
Author: vbcherepanov
Last verified: Oct 2026

vbcherepanov/jev-symfony-bundle

User repository on GitHub

View on GitHub

Unofficial Symfony bundle for TypeSafe AI's Jev: typed client, validator constraints, Messenger, Workflow guards and profiler panel

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

Unofficial Symfony integration for TypeSafe AI's Jev model. Jev answers yes/no (noul), multiple-choice (choice) and rubric (score) questions about any text or JSON, and returns calibrated probabilities. This bundle is not affiliated with or endorsed by TypeSafe AI. "TypeSafe" and "Jev" are used only to name the API this package talks to.

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

Tagscommunity github

Works forJev for Classification

Used inJev for Software & DevTools

Languages: PHP

Highlights

JevClientInterface on Symfony HttpClient with named clients and retries matching official SDKs.
JevNoul and JevChoice validator constraints for checks like probable spam rejection.
Messenger background evaluation with DecisionMadeEvent plus Workflow transition guards.
Profiler panel shows questions, answers, probabilities, tokens, request ids, retries, and timing.

Watch out

Unofficial and unaffiliated; requires PHP 8.4 plus Symfony 7.4 or 8.x with optional validator, messenger, and workflow packages. 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

SwiftJev

Swift provider adapter that sends typed noul, choice, and score prompts to the hosted System One API through SwiftDecision DecisionBackend, returning validated probability distributions.

Jev Tools & CLIs#community#github

Community

SoundBlaster/SwiftJevSwift

ai-provider-for-jev

WordPress plugin that exposes Jev noul, choice, and score questions to PHP with settings-page and constant-based key, model, and endpoint configuration.

Jev Tools & CLIs#community#awesomejev#catalog-import

Community

soderlind/ai-provider-for-jevPHP

jev-deep-dive

Long-form Jev writeup that maps each conclusion to official docs, vendor evals, integrations, community reproductions, and press, separating contract facts from unverified claims.

Jev Tools & CLIs#community#github

Community

LouisUltra/jev-deep-divePython

Jevest

GitHub Action that reviews pull requests with a read-only finder agent plus a refuting verifier, using Jev only to triage, route, label, and gate merging.

Jev Tools & CLIs#community#github

Community

tincke10/JevestTypeScript

using-typesafe-and-pinecone

Example collection pairing Pinecone retrieval with Jev judgments, including a reranking demo that narrows full-text candidates by natural-language criteria.

Jev Tools & CLIs#community#github

Community

pinecone-io/using-typesafe-and-pineconeJavaScript

jev-trader

Chrome side-panel bot that consults Jev each interval for trade direction on an NSE stock via the Zerodha web session, with paper trading on by default.

Jev Tools & CLIs#community#github

Community

Shashank-H/jev-traderJavaScript

From the Jev guides

Original write-ups on what this entry is for.

Jev on the Gateways: Vercel, Workers AI, and OpenRouter

Oct 12, 2026

The request shape barely changes across surfaces; the surrounding contract does. When to call the API directly and when a gateway, a Worker binding, or a router entry earns its extra hop.

Jev Tools & CLIs#gateway#vercel#cloudflare

Read article

Exporting Decision Models: GGUF, ONNX, and Device Runtimes

Oct 10, 2026

Taking a decision checkpoint out of Python: what the GGUF and browser WebGPU exports preserve, what they change, and the parity evidence the model cards publish.

Jev Tools & CLIs#open-models#local#onnx

Read article

Records at Rest: Documents, Inboxes, and Risk Queues

Sep 28, 2026

Jev labels a record that already exists. Code moves, flags, or holds it. How the document, mail, and transfer tools keep the action out of the model.

Jev Tools & CLIs#classification#email#security

Read article

Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai