Skip to main content

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

pip install vantage-core

PyPI · contributors: pip install -e ./vantage-core from a clone.

Requires OPENROUTER_API_KEY.

Stranger path

A — Try a demo (60s)

export OPENROUTER_API_KEY=sk-or-...
vantage-core run --scenario support_escalation_v1 \
  --model openai/gpt-4o-mini --turns 4 --fail-under 7.0 --json

B — Author your first path

vantage-core init
# edit contracts/01_refuse_pii.yaml  (id / system / opening / checks)
vantage-core validate ./contracts/01_refuse_pii.yaml
vantage-core run --contract ./contracts/01_refuse_pii.yaml --json
echo $?   # 0 iff pass_gate.passed

Starters + blank template: examples/contracts/
(vantage-core init copies the same files into ./contracts/)
Partner checklist: marketing/growth/AUTHORING_CHECKLIST.md

Contract format (runtimeai.contract/v1)

Mode B — custom (your scenarios — preferred):

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

Mode A — library replay (our demos):

schema: runtimeai.contract/v1
id: my_team.support_path_v1
mode: library_replay
fail_under: 7.0
turns: 4
library:
  scenario_id: support_escalation_v1

See examples/contracts/starters/ and examples/contracts/demos/.

Decision artifact

vantage-core schema
vantage-core validate scorecard.json
Block Contents
contract scenario id + content SHA, model, turns, fail_under
scorecard score /10, rubric, pass_gate (score + trust + closure)
usd est_eval
exit 0 iff pass_gate.passed
integrity SHA-256 of the payload

Bundled library

Id What
support_escalation_v1 Escalating customer ticket (empty export) → multi-turn + heuristic rubric
de_sql_optimization_v1 Slow Snowflake query → rewrite + heuristic rubric

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.1
git push origin vantage-core-v0.1.1
# 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 support_escalation_v1 # or: vantage-core run --monorepo --scenario …

Related

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vantage_core-0.1.1.tar.gz (34.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vantage_core-0.1.1-py3-none-any.whl (39.1 kB view details)

Uploaded Python 3

File details

Details for the file vantage_core-0.1.1.tar.gz.

File metadata

  • Download URL: vantage_core-0.1.1.tar.gz
  • Upload date:
  • Size: 34.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vantage_core-0.1.1.tar.gz
Algorithm Hash digest
SHA256 7dabcabd144a12865586df374ab0ad63bd32a399ecdd5dd1f1c97794e3b82740
MD5 6d63827d52d9a30478d606e3197b076f
BLAKE2b-256 ed3a8218241cb16979226ac93a87ab19b6425e56d7b5083a0560f3687ae61f8a

See more details on using hashes here.

Provenance

The following attestation bundles were made for vantage_core-0.1.1.tar.gz:

Publisher: publish-vantage-core.yml on simonbright/vantage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vantage_core-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: vantage_core-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 39.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vantage_core-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9bd8d47f03de4209da1c951035bbcc36fbaf7ce3deb65fbddfa49a5852b6b9aa
MD5 566eca40d5cd97430351f9bdba45971f
BLAKE2b-256 c1052e8195b7a3b84cfd355f4682bcdca2a29017515b28bbd4f056a4265aabaa

See more details on using hashes here.

Provenance

The following attestation bundles were made for vantage_core-0.1.1-py3-none-any.whl:

Publisher: publish-vantage-core.yml on simonbright/vantage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page