How to Use Jev

Using Jev is a function call, not a chat session. You send evidence plus typed questions; you get values your code can if on.

This page is the “how to use Jev / how to use Jev AI” path. The first raw request lives on Getting Started. Language-specific walks are Python, TypeScript, and cURL.

1. Get access

TypeSafe's 2026-09-15 launch post says Jev is in early access and that they are bringing people off the waitlist. We have not independently timed how long that takes.

Practical paths people use:

There is no public “run Jev on your laptop” weight download. Jev GitHub covers SDKs and why “Jev local” still hits a hosted API.

2. One request shape

Every useful call has model, state, and questions:

{
  "model": "jev-latest",
  "state": "I was charged twice. Please fix this ASAP.",
  "questions": {
    "billing": {
      "type": "noul",
      "instructions": "Is this ticket about billing?"
    },
    "tone": {
      "type": "choice",
      "instructions": "What is the customer's tone?",
      "criteria": { "calm": null, "frustrated": null, "angry": null }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": ["can wait", "this week", "today"]
    }
  }
}

Read answers.billing.noul, answers.tone.choice, answers.urgency.score. Log model so you know which version answered.

3. Pick a client

• cURL / HTTP — Getting Started and the API guide.
• Python — pip install typesafe-sdk, then TypeSafeClient().system_one(...).
• TypeScript — npm install @typesafe-ai/sdk, then client.systemOne(...).

Official SDKs read TYPESAFE_API_KEY and default to jev-latest.

4. Put the decision in your code

Jev does not refund, page, or send email. Your code does:

if (response.answers.billing.noul > 0.8) {
  assignTo("billing");
} else if (response.answers.tone.choice === "angry") {
  assignTo("priority_support");
} else {
  assignTo("triage");
}

Tune thresholds on your own tickets. Official confidence examples (0.5, 0.9) are examples, not shipped defaults.

5. Using Jev next to an agent

Jev is not an “AI agent”. An agent (or your workflow) calls Jev when it needs a typed judgment: which tool, whether to escalate, whether a retrieved chunk is usable.

That pattern is the agent tool selection example. Keep tool execution, file I/O, and prose generation in the host.

When to use this page

You already believe Jev is the right tool and want the shortest path to a working call.

When not to

If you are still asking “is Jev an LLM?”, read Is Jev an LLM? first.

Common mistakes

• Waiting for a chat box. There isn’t one in the API.
• Putting the English question only in the dict key. Official docs say IDs are not sent to the model.
• Treating a gateway (Vercel / OpenRouter) as a different model. It is still Jev; the key and base URL change.

Next: Getting Started or a copy-paste example.