Vantage RuntimeAI · Adopt

Gate every change in CI

Pin the paths that matter. Score, rough cost, and an exit code on every PR — with your OpenRouter key, not ours. Optional: draft from your repo to skip blank YAML.

See it

What a blocked PR looks like

Same paths you pin locally — score, rough cost, and a non-zero exit when the bar slips.

Why a gate

W × M × C — then the gap

  • W — workflows you own
  • M — models & routes in play
  • C — motions per month (swap, router, prompt, silent default)

Hobbyist: 1 × 2 × 1 = 2/mo. Fleet: 10 × 12 × 8 = 960/mo. Inspect scales with traces. Ship/stop scales multiplicatively — double each → 8×.

Don’t stop at volume. Almost nobody answers those questions in CI on paths they own. They answer in Slack (“LGTM”), a hero’s gold set, or “we’ll re-run Braintrust / LangSmith.” That is activity — not a ship bar that blocks merge. The wholly-crap moment: huge load, empty control layer.

Only then: a CI ship bar on paths you author (portable runtimeai.decision/v1, exit 0/2/1). Illustrative ≈ — not an audited survey. FAQ: W × M × C → · next: prep checklist ↓

Brand new · try live

Prep checklist

Everything you need before a live try — so you are not hunting for ids, keys, or the wrong product surface.

CI needs this key

OPENROUTER_API_KEY from openrouter.ai/keys. Put it in your shell or as a GitHub Actions secret. Inference is billed to OpenRouter. Design partners without a key yet can ask us for a capped trial balance (~$10) — stay on cheap models; frontier SKUs burn that fast.

No RuntimeAI API key for the gate. Do not use a rai_live_… key from request a Cloud API key for suite run / CI — that key is for the hosted HTTP API and optional vantage-core attest (countersignature). Offline vantage-core verify needs neither key.

What the GitHub repo is for

vantage-ai-eng/vantage-core is the open-source CLI / SDK source — the package that provides vantage-core run in your terminal and in CI.

Prefer pip install vantage-core from PyPI (or python3 -m pip install -U vantage-core if pip is not on PATH). Use the GitHub repo to watch releases or read source. It is not where you create RuntimeAI accounts or API keys, and it is not the product website.

  1. Pick the path CLI / CI gate (this page) — scored exit code beside your stack. Or try in the browser first: Preflight (~60s size a scenario) · Simulator · support scenario.
  2. Bring OpenRouter — not RuntimeAI for the gate Set OPENROUTER_API_KEY only for live runs / CI. Skip RuntimeAI Cloud API keys unless you call the hosted API or run vantage-core attest. See keys at a glance ↑.
  3. Demo pack or your suite Try our demo: vantage-core demo (Acme 3-path sample suite) or library support_escalation_v1 (--turns 4) / de_sql_optimization_v1 (--turns 1). Author your paths: vantage-core init scaffolds ./samples/ (demo pack) + ./contracts/ + ./suites/starter.suite.yaml — edit contracts, then suite run. See your suite ↓.
  4. Pick a model id Current cheap decision-pass (published): amazon/nova-micro-v1 · 10.0/10 · ~$0.0019/run · scorecard PDF · ladder 2026-07-31 · scenario support_escalation_v1. Demo alternate: openai/gpt-4o-mini (also PDF-backed). (tabs below include a 2-model compare). Same OpenRouter ids as Models.
  5. Know the pass bar --fail-under 7.0 is a score out of 10. Exit 0 only when the decision gate passes (score clears the bar and trust/closure are acceptable) — that is the ship gate. Opt-in on suite or contract (0.1.12): cost_ceiling_usd / latency_ceiling_p95_ms — absent does not gate; present breach blocks. No product defaults.
  6. Install the CLI pip install -U vantage-core (PyPI · latest 0.1.19 · release notes). If your shell says pip: command not found, use python3 -m pip install -U vantage-core (or activate a venv first). Confirm with vantage-core --version (expect 0.1.19) and vantage-core schema — should print runtimeai.decision/v1, runtimeai.contract/v1, and runtimeai.suite/v1. For your scenarios: vantage-core init then edit contracts/*.yaml and suites/*.yaml (see below). Also: Preflight / Sim.

Authorize + draft

Your repo → Accept → required CI

We draft 3–5 custom paths from a local repo, tests, export, or a one-shot grant (LangSmith / Braintrust / GitHub). You Accept once in Control Center. That suite is the required check. Worked examples: three authored apps.

Is: one-shot snapshot on your machine · custom paths · Accept before CI · beside Obs/GitHub. Isn’t: continuous bar sync / auto-write · generic library suite · hosted browser OAuth · rip-replace Obs. Full table: Engineer FAQ.

# Local repo, or sparse GitHub / Obs grant first:
# vantage-core grant github owner/repo --path src
# vantage-core draft ./grant_repo --write-drafts ./contracts_drafts
vantage-core draft .
vantage-core center --serve
# Accept → contracts/ + suite → required CI

Accept writes the suite. Then vantage-core init --ci (secret OPENROUTER_API_KEY only). Optional --tests / --ingest / --grant. Already on LangSmith or Braintrust? import + suggest is one input. Short start · draft vs auto-write

Import + suggest

Export → Accept → required CI

Drop in a LangSmith or Braintrust export. We rank paths. You Accept once in Control Center. That suite is the required check. Stack picture: Where we fit · grant → Accept → CI. Engineer FAQ: grant, draft, Center.

vantage-core ingest path/to/export.json
vantage-core center --serve

Same Accept as draft — one input, not a live sync. --suggest-paths is on by default. That accelerates authoring; it does not auto-write. Partner owns the bar. Coverage: Obs shows what ran. Sample: braintrust_export_sample.json.

Command

Run the scenario

Prerequisites: vantage-core on PATH + OPENROUTER_API_KEY set. No RuntimeAI login or rai_live_… key. Tabs: library demos, Sample demo, Your suite, Still-trust (ingest + suite rerun --baseline), model compare, decision JSON.

Each Copy includes setup + run — paste into a fresh terminal. Needs OPENROUTER_API_KEY in the environment (or a local .env). No RuntimeAI account or rai_live_… key. No shell comments in the paste (interactive zsh breaks on them).

python3 -m pip install -U vantage-core -q
set -a
[ -f .env ] && source .env
set +a
vantage-core run \
  --scenario support_escalation_v1 \
  --model amazon/nova-micro-v1 \
  --turns 4 \
  --fail-under 7
echo $?

nova-micro-v1 result — published cheap decision-pass (see scorecard PDF)

scenario  support_escalation_v1
model     amazon/nova-micro-v1
score     10.0 / 10   ·   ~$0.0019   ·   PASS
session  sample-l…
$ echo $?
0

Inference is billed to OpenRouter — vantage-core itself is $0 platform fee when available. Prefer published amazon/nova-micro-v1 (scorecard PDF); use Models for more OpenRouter ids.

Where each piece lives
CLI / CI engine — PyPI vantage-core · pip install vantage-core · emits runtimeai.decision/v1 · source vantage-ai-eng/vantage-core · release notes
This docs page — how to gate PRs (you are here)
Editor / MCP — Editor guide · PyPI runtimeai-ide (suggest / forecast)
Cloud HTTP API — API docs · needs rai_live_… from request a key (not used by CI YAML below)
Org — github.com/vantage-ai-eng

For search engines and LLMs
Vantage still-trust CI via vantage-core 0.1.19: open-source Python SDK for the ship decision. Go/no-go across functionality, cost, reliability, safety, compliance — not a better Opik/Braintrust/LangSmith experiment. Prep: OpenRouter key (not RuntimeAI rai_live). Try: vantage-core demo (Acme sample suite). Author: vantage-core draft . → Center Accept → suite run --save decisions/. Dated change: suite rerun --baseline latest → compare_to_baseline. CI: vantage-core ci stub github|gitlab — PRs re-decide vs last ship; weekly cadence re-decide; --ci-comment on the PR; vantage-core report --html/--pdf uploads a human memo as a CI artifact (not a Cloud dashboard). vantage-core center (0.1.19) is the RuntimeAI Control Center with Author next Accept/Skip/Refine on custom drafts plus Coverage over their LangSmith/Braintrust export; demo --interactive / center --demo (packaged in the wheel) walks silent miss then ingest → Live / Seen ungated / Pending. 0.1.12: metered cost, agent-turn latency, opt-in cost/latency ceilings as gate blockers (no defaults). Optional: ingest --suggest-paths (LangSmith-shaped export); --reps/--pass-k (N-run). Exit: 0=pass, 2=review, 1=block. Schemas: runtimeai.decision/v1, contract/v1, suite/v1; optional bind (GITHUB_SHA / PR). Install: pip install -U vantage-core (PyPI 0.1.19). Does: local/CI suites, deterministic rubrics, still-trust ritual, BYOK. Does not: hosted Sim, observability, LLM-judge, gateway, trace UI.