Getting started

Install

pip install pyjev
uv tool install pyjev

For a checkout, install contributor and documentation dependencies separately:

pip install -e '.[dev,docs]'

Authenticate

For an interactive local setup:

pyjev auth set
pyjev auth status

For CI, use an environment variable:

export TYPESAFE_API_KEY='...'

First CLI decision

Choice returns a selected label, confidence, and the complete distribution:

pyjev choice "Where should this ticket go?" \
  --state "Stripe checkout fails" \
  --option billing="Payments and refunds" \
  --option engineering="Technical failures" \
  --option sales="Purchasing questions" \
  --json

--json is intended for programs and preserves all result metadata.

First Python decision

from pyjev import Jev

with Jev() as jev:
    result = jev.choice(
        "Where should this ticket go?",
        state="Stripe checkout fails",
        choices={"billing": "Payments", "engineering": "Technical", "sales": "Purchasing"},
    )
print(result.value, result.confidence, result.probabilities)

First named decision

Create .pyjev.toml:

[pyjev]
schema = 1

[decision.ticket-route]
type = "choice"
question = "Which team should handle this support request?"

[decision.ticket-route.options]
billing = "Billing, invoice, payment, or refund issue"
engineering = "Technical problem or product bug"
sales = "Purchasing, pricing, or procurement question"

Then run it from the project directory:

echo "Stripe webhooks fail" | pyjev decide ticket-route --json

Continue with Named decisions, Confidence, Python API, and CLI.