AIMS Compass · v1 · OSS reference toolkit

The best model for every call.

Multi-vendor LLM routing by cost, tools, inference, and adversarial-challenge.

AIMS Compass is the reference model router. Register your provider keys once; declare per-call requirements; Compass picks the cheapest model that meets each call's requirements.

Install → GitHub →
Why Compass

Model choice shouldn't be hardcoded.

Cost and capability profiles vary by call. A code-completion call has different requirements than a contract-review call. Agents should declare what each call needs, not which model handles it. Compass is the router that makes that possible.

How it works

Three steps. One router.

1 · Register

Provider keys.

Register your API keys with each vendor — Anthropic, OpenAI, Google, Mistral, locally-served, anything that speaks a known protocol.

2 · Profile

Cost and capability.

Compass researches each registered model's cost-per-token, context window, tool-call support, JSON-mode, and other capability dimensions.

3 · Route

Cheapest that fits.

At call time, Compass picks the cheapest registered model that meets the call's declared requirements.

What you can declare

Per-call requirements.

Compass routes by what your call needs, declared per call:

  • Max cost per call (in cents or per-token)
  • Required tool / function call support
  • Inference time budget (max latency)
  • JSON-mode capability
  • Minimum context window
  • Required modality (text / vision / audio)
  • Adversarial-challenge round (for safety-critical calls)
  • Vendor exclusions or pinned-model overrides
Adversarial-challenge feature

Two opinions for the important calls.

For high-stakes outputs, Compass routes the call through a primary model and a different-vendor challenge model in parallel. Disagreement surfaces to the agent before it commits. Maps directly to AIMS's blind-spot monitoring principle from the spec.

Use it when the cost of a wrong answer exceeds the cost of two inferences.

Install

One line per language.

Exact package name and registry pending the AIMS-tools repo organization decision. Install command will be one of:

npm install @aims/compass
pip install aims-compass
go get github.com/Extended-Systems-Intelligence/aims-compass
Five-minute walkthrough

Route a call by requirements.

const compass = new Compass({
  providers: {
    anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
    openai:    { apiKey: process.env.OPENAI_API_KEY },
    google:    { apiKey: process.env.GOOGLE_API_KEY },
  },
});

// Route a call by requirement, not by model name.
const result = await compass.call({
  prompt,
  requirements: {
    maxCostCents: 5,
    needsTools: true,
    adversarialChallenge: true,   // safety-critical
  },
});
AIMS registry integration

Every routing decision auditable.

Compass registers as a model-routing instrument with the AIMS agent registry. Each routing decision — which model served the call, which lost — is recorded to the registry audit log. The registry exposes the decisions for conformance review without exposing the prompts or completions themselves.

Repo · docs · license

Free, forever.

Compass is OSS. Repo: github.com/Extended-Systems-Intelligence/aims-compass (exact location pending the AIMS-tools repo organization decision). License: Apache-2.0. Authored by XSI; community-owned by intent.

GitHub Back to AIMS Atlas →