vera-s1

Python package and Jev-compatible HTTP server for the vera System One decision models: vera-spark (~630M, compact) and vera-core (~2B, most accurate).

Give a vera model a state (text or JSON) and typed questions; it returns typed answers with calibrated probabilities in one forward pass. It never generates text.

pip install vera-s1            # add [fast] for flash-linear-attention (faster vera-core on GPU)

import vera

agent = vera.load("scar-ai/vera-spark")       # or "scar-ai/vera-core"
result = agent.predict(
    "Hi, we were billed twice for March. Please refund the duplicate today or we will cancel our plan.",
    {"department": {"type": "choice", "instructions": "Which department should handle this?",
                    "criteria": {"billing": "invoices, payments, refunds", "technical": "bugs, outages",
                                 "other": "everything else"}},
     "churn_risk": {"type": "noul", "instructions": "Does the user threaten to cancel or leave?"}})
print(result["answers"])

Question types: choice (2 to 255 options), score (2 to 10 ordered levels) and noul (yes/no probability).

HTTP server

vera-serve --model scar-ai/vera-core --port 8200
curl -s localhost:8200/v1/systemone -H 'Content-Type: application/json' -d '{
  "state": "I was charged twice. Please fix this ASAP.",
  "questions": {"billing": {"type": "noul", "instructions": "Is this ticket about billing?"}}}'

Same request and response shape as Jev's POST /v1/systemone. Binds 127.0.0.1 by default and has no authentication: put it behind your own gateway before exposing it.

By default a request is fitted to the model's trained budget: long option descriptions and questions are shortened and an oversized state keeps its head and tail. --no-caps (or VERA_NO_CAPS=1, or vera.load(..., no_caps=True)) reads every request whole instead; inputs longer than the model was trained on are out of distribution and slower.

Requires Python 3.10+ and transformers 5+. A GPU (CUDA or ROCm) is recommended; Apple MPS is not supported (CPU is used on Macs).