Skip to content
Metatext Decide — typed decisions for your agents, with a probability on every answerGet early access
Metatext
Sign Up

nanojev-arena

Local Snake battle where four NanoJev AI snakes pick moves from a candidate distribution while you play the fifth.

AppprototypeMIT
View on GitHub ↗

Overview

NanoJev Arena is a local game demo for NanoJev, the 0.6B open Jev replica. In a 1-vs-4 Snake match you steer a gold snake while four NanoJev snakes compete for food; a side panel shows each AI snake's current direction probabilities. The README is in Chinese.

Decisions are hybrid. A code planner runs every frame to exclude reversing, wall and self collisions, computes a BFS shortest path to the nearest food and narrows to 2-4 candidate moves. NanoJev then answers a batched choice question for all four snakes (about 0.2 s) and the argmax is used; until the response arrives the planner steers, so snakes never crash while waiting. The README reports that in a full-map comparison NanoJev ate 27 food items and survived to the step limit while base Qwen3-0.6B got stuck at step 211. An installer clones NanoJev, sets up the environment and downloads the 2.3 GB checkpoint.

What the decision model decides

TypeQuestionAnswers
ChoiceWhich direction should this snake move?(inferred)up · down · left · right

How it works

  1. Code planner filters unsafe moves and proposes 2-4 candidates.
  2. NanoJev scores candidates for all AI snakes in one batch.
  3. Take the argmax; planner covers until the response arrives.
  4. Display per-snake probability bars.

Strengths

  • Shows a clean code-plus-model hybrid with safe fallbacks.
  • Runs locally with no API.
  • Visualises the model's distribution in real time.

Caveats

  • Requires an NVIDIA GPU with at least 6 GB VRAM.
  • Turing GPUs need fp32 to avoid slow inference.
  • Docs in Chinese.

Getting started

git clone https://github.com/caijinchun/nanojev-arena.git && cd nanojev-arena && python install.py, then run scripts/serve_decisions.py in NanoJev and open http://127.0.0.1:8766/snake.html.

At a glance

Type
App
Status
prototype
Language
Python
Runtime
local server, browser
Has code
yes
License
MIT
Stars
7

Use cases and integrations

How curated lists describe it

  • NanoJev Snake Arena: 1v4 human-vs-AI battleship + 100-agent swarm simulator. Local demo of Jev System-One model (open-source mini replica).

    wh000wh000/awesome-jev-live

  • NanoJev Snake Arena: 1v4 human-vs-AI battleship + 100-agent swarm simulator. Local demo of Jev System-One model (open-source mini replica).

    hellogumbo/awesome-jev

Frequently asked questions

What does NanoJev decide?

Each AI snake's next direction from a small set of safe candidates.

Can I play without a GPU?

Live inference needs CUDA; upstream NanoJev has browser replays that need no model.

Why can't the AI crash while waiting?

The code planner steers until the model's response arrives.

Related projects

  • jev-arena

    Real-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.

    ProjectbetaTypeScript
  • ra2web-jev-player

    Bot that plays Red Alert 2 web skirmishes, with code handling mechanics and a decision model making stance, threat and timing calls.

    ServicebetaPython
  • river-oaks

    Multiplayer 3D science-fantasy version of Houston's River Oaks District with Jev-powered NPC companion, chauffeur and smart drive.

    ProjectbetaTypeScript
  • roverlab

    Browser 3D planetary rover sandbox where a TypeSafe controller chooses the next action from complete candidates, versus a baseline.

    ProjectbetaTypeScript
  • DoomSat

    Doom runs as a spacecraft payload over real flight software; Jev pilots from the ground every half second while Claude reviews.

    ProjectprototypePython
  • hermes-and-jev-play-minecraft

    Minecraft agent where Hermes plans, Jev picks one bounded action at a time and a Mineflayer harness validates and executes.

    ProjectprototypeJavaScript