jevocks

# Jevinik

Jevinik is a stock decision terminal that retrieves live market evidence with Valyu and estimates whether a stock will trade higher in 30 days.

## Demo

[](docs/assets/jevinik-demo.mp4)

[Watch the 26-second Jevinik demo](docs/assets/jevinik-demo.mp4)

Jevinik uses **Jev**, TypeSafe AI's System One evaluation model, to make typed, probabilistic decisions without calling a general-purpose generative LLM.

The interface reports the probability of a higher price, overall outlook, evidence quality, category-level signals, supporting sources, evidence retrieval time, decision time, and browser-observed completion time.

## Features

- Autocomplete for common US and European stocks
- Five Valyu searches executed in parallel
- Fast Valyu web mode for analyst and macro evidence
- Fast, structured Jev evaluation
- Bullish, neutral, and bearish signals by evidence category
- Source-level evidence inspection
- Separate evidence, decision, and end-to-end timing
- Responsive Bloomberg-inspired terminal interface

## How It Works

1. The user enters a ticker.
2. The API validates and normalizes the ticker.
3. Valyu searches five evidence categories in parallel:
   - Market data
   - Company news
   - Industry news
   - Analyst views
   - Macro risks
4. Price history is condensed into returns, range, volume, and recent-close statistics.
5. Jev evaluates the compact evidence state using typed boolean, score, and choice questions.
6. The API returns the probability, outlook, evidence quality, category signals, source evidence, and server-side timing breakdown.

SEC filings are currently disabled in the application flow. The Valyu SEC source can be re-enabled later when desired.

## Requirements

- Node.js 20.9.0 or newer
- npm
- A Valyu API key
- A Vercel AI Gateway API key