Docs menu

// Command reference

simforge oracle

Generated from the CLI's own help (CLI 0.2.0-rc.9). Global flags and exit codes are on the reference index.

All commands

simforge oracle ask

Ask SimForge Oracle a question about driving videos: uploads them, waits and prints the answer and its cost ($0.05 per second of video, at least $0.50 per clip)

simforge oracle ask [OPTIONS] --prompt <TEXT> <VIDEO>...
Argument / flagNotesWhat
<video>required; repeatableThe driving videos to ask about, in order (MP4, QuickTime or WebM, at most 2 GiB each; 1 to 10)
--prompt TEXTrequiredThe question about the driving scene (1 to 4,000 characters)
--context TEXTFacts the answer may use, such as ego speed, route intent or camera names (at most 16,000 characters)
--preset PRESETone of driving-qa, causal-chain, hazards, scene-describeThe kind of answer (default driving-qa)
--thinking THINKINGone of low, medium, highHow long SimForge Oracle reasons before it answers (default medium)
--detail DETAILone of standard, highHow much of each frame SimForge Oracle sees: high reads finer detail (default standard)
--fps NFrames per second read from every video, 0.1 to 5 (default 1)
--start SWhere every video's clip starts, in seconds (default 0)
--end SWhere every video's clip ends, in seconds (default the video's end)
--schema FILEA JSON schema file (a JSON object, at most 16 KB): each answer is also returned as JSON of that shape
--samples NIndependent answers to the same question, 1 to 4 (default 1); each is charged
--max-output-tokens NThe longest answer, in tokens, 256 to 16,384 (default 8,192)
--max-cost CENTSThe most this question may charge, in cents: samples x each clip's max(50, 5 per second)
--out DIRSave the answer's result.json in this folder
--no-waitPrint the submitted run and return; follow it with simforge runs watch

simforge oracle serve

Serve SimForge Oracle on a local HTTP endpoint (POST /v1/oracle, GET /healthz) with this machine's sign-in; runs until stopped

simforge oracle serve [OPTIONS]
Argument / flagNotesWhat
--bind BINDdefault 127.0.0.1The address to listen on; 127.0.0.1 is this machine only
--port PORTdefault 8787The port to listen on
--max-cost CENTSThe most one question may charge, in cents, when its request sets no maxCostCents
--concurrency CONCURRENCYdefault 4Questions answered at once; later ones wait their turn (1 to 32)