// 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.
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 / flag | Notes | What |
|---|---|---|
| <video> | required; repeatable | The driving videos to ask about, in order (MP4, QuickTime or WebM, at most 2 GiB each; 1 to 10) |
| --prompt TEXT | required | The question about the driving scene (1 to 4,000 characters) |
| --context TEXT | Facts the answer may use, such as ego speed, route intent or camera names (at most 16,000 characters) | |
| --preset PRESET | one of driving-qa, causal-chain, hazards, scene-describe | The kind of answer (default driving-qa) |
| --thinking THINKING | one of low, medium, high | How long SimForge Oracle reasons before it answers (default medium) |
| --detail DETAIL | one of standard, high | How much of each frame SimForge Oracle sees: high reads finer detail (default standard) |
| --fps N | Frames per second read from every video, 0.1 to 5 (default 1) | |
| --start S | Where every video's clip starts, in seconds (default 0) | |
| --end S | Where every video's clip ends, in seconds (default the video's end) | |
| --schema FILE | A JSON schema file (a JSON object, at most 16 KB): each answer is also returned as JSON of that shape | |
| --samples N | Independent answers to the same question, 1 to 4 (default 1); each is charged | |
| --max-output-tokens N | The longest answer, in tokens, 256 to 16,384 (default 8,192) | |
| --max-cost CENTS | The most this question may charge, in cents: samples x each clip's max(50, 5 per second) | |
| --out DIR | Save the answer's result.json in this folder | |
| --no-wait | Print 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 / flag | Notes | What |
|---|---|---|
| --bind BIND | default 127.0.0.1 | The address to listen on; 127.0.0.1 is this machine only |
| --port PORT | default 8787 | The port to listen on |
| --max-cost CENTS | The most one question may charge, in cents, when its request sets no maxCostCents | |
| --concurrency CONCURRENCY | default 4 | Questions answered at once; later ones wait their turn (1 to 32) |