Question 1

What does Jev decide here that parsing the text could not?

Accepted Answer

One call answers 14 typed questions in parallel: which card to show, plus signals like whether it is a video call or whether it is urgent. Dates, amounts, units and math are left to deterministic code, one parser per card type, under the rule that Jev decides and code computes. Adding a card type means a question criterion, a parser, a component and a registry entry.

Question 2

Will it work without a TypeSafe account?

Accepted Answer

Yes. It runs fully offline by default on a built-in keyword classifier that returns the same output shape, so you can try it with no key at all. Setting TYPESAFE_API_KEY switches the latency readout from jev-offline to the pinned online model. The key is read only on the server at /api/intent and never reaches the browser.

Question 3

What happens if the API call fails or rate-limits me?

Accepted Answer

It quietly falls back to offline mode instead of failing your input. Empty or placeholder key values keep you offline, and NEXT_PUBLIC_USE_MOCK set to true forces offline even with a valid key. The model version is pinned separately with JEV_MODEL, so it does not drift when the hosted default changes.

Question 4

Why does the card not flicker while I type?

Accepted Answer

Raw model output flickers, so a state machine turns confidence into calm UI states: a card only changes when a challenger wins twice in a row or is very sure, and signal badges use an on/off hysteresis band. Add ?debug=1 to the URL if you want to see every probability it is working from.

Question 5

How do I run Shapeshift locally?

Accepted Answer

It needs Bun 1.2 or newer. Run bun install then bun dev and open http://localhost:3000; press the slash key to see every card type. It works fully offline by default with the built-in keyword classifier, so no account is needed.

Question 6

How do I enable the online Jev model?

Accepted Answer

Copy .env.example to .env.local and set TYPESAFE_API_KEY, then restart bun dev. The latency readout in the bottom-right switches from jev-offline to jev-1.13.0. The key is only read on the server route /api/intent and never reaches the browser, and JEV_MODEL pins the version, defaulting to jev-1.13.0.

Question 7

Are saved cards stored or sent anywhere?

Accepted Answer

Saved cards live in your browser's localStorage until you delete them, and clicking one edits it. With a key, the intent request goes to the server route /api/intent before it reaches the model; with no key everything stays offline under the keyword classifier.

Shapeshift

About this project

Highlights

Quickstart

Questions about this entry

Reactions & coverage

From the Jev guides

From the Jev AI model community