README.md

metadata

title: Router Classify API
emoji: 🛰️
colorFrom: green
colorTo: indigo
sdk: docker
pinned: false
license: other
license_name: polyform-noncommercial-1.0.0
license_link: https://polyformproject.org/licenses/noncommercial/1.0.0

Router Classify API

REST endpoint that runs the GreenRouting classifier and returns a routing decision against a configurable downstream model registry.

Endpoints

• POST /classify — Run the classifier and pick a model.
  • Request: { "message": "...", "recentMessages": [{"role": "...", "content": "..."}] }
  • Response: { "category", "complexity", "model_id", "capability_weights", "difficulty", "energy_savings_pct", "method", "reason" }
• GET /health — Liveness probe.

Configuration

The registry of candidate models is supplied at runtime via a Space secret. Set one of:

• PARTNER_REGISTRY_JSON — the registry as raw JSON (preferred)
• PARTNER_REGISTRY_PATH — a file path inside the container

Other env vars:

• CLASSIFIER_ARTIFACT_DIR — defaults to models/classifier_v1
• INCLUDE_REASON — 1 (default) to include the reason string in responses, 0 to omit