x25-sdk 0.1.0

Autonomous LLM routing agent. Self-learning, cost-aware, auditable.

X25 — Autonomous LLM Routing Agent

X25 routes every LLM call to the cheapest model that meets your quality bar. It learns per-organization using Thompson Sampling, audits every decision in a tamper-evident hash chain, and fine-tunes a custom model on your call history at Stage 4.

from x25 import X25

agent = X25(api_key="sk-x25-...", gateway_url="http://localhost:8000")

result = agent.complete(
    "Summarize this paper abstract...",
    hint="summary"
)

print(result.text)          # the answer
print(result.model_used)    # which model X25 picked
print(result.cost_saved_usd)  # how much cheaper vs frontier

Install

pip install x25-sdk

What it does

• Routes each call to the cheapest tier (SLM / Mid / Frontier) likely to pass quality
• Learns per org using Thompson Sampling — converges in 50-200 calls
• Judges quality automatically using LLM-as-judge scoring
• Escalates automatically if quality fails — no manual fallback logic
• Audits every decision in a cryptographic hash chain
• Fine-tunes a custom SLM on your call history at Stage 4 (500+ calls)

Stages

Stage	Calls	What happens
1: Explore	0-49	Tries all tiers, learns your task mix
2: Exploit	50-199	Converges to cheapest reliable tier
3: Feedback	200-499	Asks for labelled examples
4: Fine-tune	500+	Trains custom LoRA, enters routing pool