Tictacjev

JevClient.choose_move builds a Choice question whose criteria are only the empty cells, sends the board as natural-language state, and returns the chosen cell with confidence and per-cell probabilities.

Full move history stays on the game state with confidence and per-cell probabilities. Expand any Jev entry in the frontend log to see a probability bar per considered cell.

Nine cells with at most eight legal moves keeps every option watchable end to end. Larger boards would need their own question design and UI work.

Run the FastAPI backend on localhost port 8000 after setting JEV_KEY, then npm install and npm run dev for the Vite frontend on 5173. Override the API URL with VITE_API_BASE_URL.

Two routes. POST /games creates a game with a chosen human symbol and who goes first, and POST /games/{id}/moves submits a human move and then, if the game is not over, asks Jev for its reply. The client itself lives at backend/app/jev_client.py as JevClient.choose_move, which is where the Choice question over empty cells is built.

Python 3.12+, uv and a Jev key for the backend: cp .env.example .env, set JEV_KEY, uv sync, then uv run uvicorn app.main:app --reload on http://localhost:8000. The frontend needs Node with npm install and npm run dev on 5173, and VITE_API_BASE_URL overrides the backend URL. The API allows CORS from the Vite dev origin only.

Four variables in backend/.env: JEV_KEY, which is required; JEV_BASE_URL to override the API root; JEV_DEFAULT_MODEL to override the default model; and JEV_TIMEOUT in seconds, default 10.0. Both sides ship tests, uv run pytest on the backend and npm test on the frontend, so the local loop does not need a working key beyond the app itself.