vantage-core

Standalone RuntimeAI check-ride CLI. Author a local contract, run against OpenRouter, get a portable runtimeai.decision/v1 artifact — no monorepo server/ required.

Partner authoring: marketing/growth/AUTHORING_CHECKLIST.md

Install

When PyPI is live:

pip install vantage-core

Until then (clone):

pip install -e ./vantage-core
# or: ./scripts/install_vantage_core_local.sh

Requires OPENROUTER_API_KEY.

Stranger path (60 seconds)

export OPENROUTER_API_KEY=sk-or-...
vantage-core run --scenario de_sql_optimization_v1 \
  --model amazon/nova-micro-v1 --fail-under 7.0 --json

Or author a local contract (see checklist):

vantage-core validate examples/contracts/custom_policy_refuse.yaml
vantage-core run --contract examples/contracts/custom_policy_refuse.yaml --json
echo $?   # 0 iff pass_gate.passed

Contract format (runtimeai.contract/v1)

Mode A — library replay (reuse a bundled scorer + optional your fixture):

schema: runtimeai.contract/v1
id: my_team.sql_path_v1
mode: library_replay
fail_under: 7.0
turns: 1
library:
  scenario_id: de_sql_optimization_v1
  fixture: |
    SELECT * FROM orders o, order_items oi WHERE ...

Mode B — custom (your system + opening + hard checks):

schema: runtimeai.contract/v1
id: my_team.policy_refuse_v1
mode: custom
agent:
  system: |
    You are a policy agent…
  opening: |
    User: …
scorer:
  kind: hard_checks
  checks:
    - id: refuses
      any_of: ["cannot", "refuse"]
      points: 5

See examples/contracts/.

Decision artifact

vantage-core schema
vantage-core validate scorecard.json

Bundled library

Publish (maintainers)

Preferred — GitHub trusted publishing

1. On PyPI: create project vantage-core (or claim name) → Publishing → GitHub
   • Repository: this monorepo
   • Workflow: publish-vantage-core.yml
   • Environment: pypi (match the Actions environment)
2. Bump version in pyproject.toml
3. Tag and release:

git tag vantage-core-v0.1.0
git push origin vantage-core-v0.1.0
# Create a GitHub Release for that tag → workflow publishes

Or Actions → Publish vantage-core to PyPI → Run workflow with confirm=publish.

Manual / token fallback

cd vantage-core
./scripts/publish-pypi.sh --check   # build + twine check only
export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-…
./scripts/publish-pypi.sh

Dev monorepo parity

VANTAGE_USE_MONOREPO=1 vantage-core run --scenario de_sql_optimization_v1 …
# or: vantage-core run --monorepo --scenario …

Related

• Product page: https://www.vantageai.cc/runtimeai/method/cicd
• IDE package: pip install runtimeai-ide
• Authoring checklist: marketing/growth/AUTHORING_CHECKLIST.md