User repository on GitHub
- Forks
- 2
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
Jev directory
CommunityJev Repos & SDKs
TypeSafe AI SDK for PHP
An 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.
- Stars
- 2
- Language
- PHP
- License
- MIT
- Reading time
- 3 min
- Published by
- Community
- Author
- Butochnikov
- Last verified
- Sep 2026
About this project
PHP client for the TypeSafe AI System One API. Ask yes/no questions, select categories, and score text or structured data with typed responses. Community-maintained and unofficial; this package is not affiliated with TypeSafe AI. Noul, Choice and Score questions with typed answers and probabilities. Synchronous calls and asynchronous requests through Guzzle promises. Model discovery, configurable retries and timeouts, and PSR-3 logging. PHP 8.2 or later in the PHP 8 series.
Quoted from the project's README. Read the full README.
Works forJev for Scoring
Used inJev for Software & DevTools
Highlights
- Noul returns the probability of a yes answer, not a boolean; Score returns a possibly fractional expected score on a zero-based rubric.
- AsyncTypeSafeClient returns Guzzle promises with then(), rejection handlers, wait(), and cancel(); closing cancels pending operations and is idempotent.
- RetryPolicy defaults to two retries for 408, 429, 5xx, connection errors, and timeouts, with per-call policies that do not mutate client state.
- Failures map to typed exceptions such as TypeSafeRateLimitError and TypeSafeAuthenticationError; debug logs redact credentials, not bodies.
- Requires PHP 8.2 or later, cURL and JSON extensions, Composer 2, and a TypeSafe API key; environment variables are read directly, not from .env files.
Quickstart
php
use TypeSafe\{Choice, Noul, Score, TypeSafeClient};
$client = new TypeSafeClient();
$result = $client->systemOne(
state: ['document' => 'I was charged twice. Please help ASAP.'],
questions: [
'billing' => new Noul(instructions: 'Is this about billing?'),
'urgency' => new Score(criteria: ['low', 'medium', 'high'], instructions: 'Urgency?'),
],
);
$client->close();Watch out
MIT-licensed. Community-maintained and unofficial, not affiliated with TypeSafe AI; the default test suite is offline, and live API compatibility and exhaustive equivalence with the Python SDK have not been verified.
Questions about this entry
Short answers drawn from the linked project or page.
It is community-maintained and the README states plainly that the package is not affiliated with TypeSafe AI. Version 0.1.0 is the initial PHP release based on Python SDK 0.6.0, and the two packages version independently, so pin the 0.1.x series and expect breaking minor bumps while it is 0.x.
The README says the default test suite is offline and covers selected SDK contracts, and that live API compatibility and exhaustive equivalence with the Python SDK have not been verified. Files under examples do make live requests when executed, and Composer autoload does not run them, so live behaviour is something you confirm yourself.
You get the probability of a yes answer, not a boolean, so the decision threshold stays in your code. Score returns an expected value on a zero-based rubric and can be fractional, and Choice returns the selected option. With an open client you can also pass raw question arrays for API fields the typed classes do not expose.
Keys are handled: header values for authorization, cookies, API keys, token and secret names and proxy authorization are replaced with ***. Bodies are deliberately not redacted, matching upstream behaviour, so keep sensitive payloads out of state. The SDK also reads environment variables directly and never loads .env files.
PHP 8.2 or later within the PHP 8 series, the cURL and JSON extensions, Composer 2, and a TypeSafe API key for live requests. Then composer require butochnikov/typesafe-sdk-php:^0.1, which needs a release indexed on Packagist, export TYPESAFE_API_KEY, and you are set. There is a Russian-language README, and the local-installation route in docs/publishing.md covers running from source before publication.
AsyncTypeSafeClient returns a GuzzleHttp\Promise\PromiseInterface that resolves to a typed response, and Guzzle and cURL keep several operations in flight. A promise supports then(), rejection handlers, wait() and cancel(). Closing the async client cancels anything pending and is idempotent, so it is safe in a finally block. Successful responses expose typed DTOs and $response->answers.
The defaults are https://api.typesafe.ai, jev-latest and a 10 second timeout, and the environment variables are TYPESAFE_API_KEY, TYPESAFE_BASE_URL, TYPESAFE_DEFAULT_MODEL and TYPESAFE_LOG_LEVEL, where debug, info, warn or warning, error and off are accepted. Empty environment values are ignored, and explicit constructor or per-call values take precedence over all of them.
More Jev resources like this
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.
Jev Repos & SDKs#community#ruby#sdk
Community
joshmn/typesafe-sdkRuby
joshmn/typesafe-sdkRubyA small PHP 8.1 library, extracted from LLPhant, giving typed value objects for Jev's Noul, Choice and Score answers, with probabilities and token usage. Unofficial and community-built; you supply a TypeSafe API key, or point it at Laya.
Jev Repos & SDKs#community#catalog-import#logicrw
Community
f-lombardo/jev-phpPHP
f-lombardo/jev-phpPHPA 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 PHP and Laravel SDK for the Jev model series, wrapping typed questions and probability answers for the PHP ecosystem.
Jev Repos & SDKs#community#sdk#php
Community
binnash/typesafe-sdkPHP
binnash/typesafe-sdkPHPA 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/eveTypeScriptA 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-jevPythonFrom 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.