Skip to content

Feature: OrcaRouter provider support for LettuceDetect #112

Description

@putraperdana1207-pixel

LettuceDetect tackles a hard problem: instead of a clean-or-flagged verdict on an AI answer, it returns the exact character spans that are unsupported by or contradict the source evidence, across RAG prose, coding-agent answers, and tool output. Span-level precision backed by fast local encoders and generative detectors that type each span is why teams building grounded systems rely on it - and your v2 results on code-agent answers, where the fine-tuned Qwen-2B detector beats large LLM judges that over-flag generated code, make a concrete case for domain-tuned grounding checks.

Your LLM-based detector already routes through an OpenAI-compatible client with a provider switch (openai / bedrock) and a base_url override, so an OrcaRouter provider would let teams using method="llm" judges point the same detector at whichever model best fits their cost, language, or throughput needs - more choice, no change to the LettuceDetect API.

Problem or use case

LLM judges are limited today to the providers hard-coded in make_llm_client(). Teams that want to run grounding checks against a different frontier model, or need one API surface across budgets, must wire their own gateway. I'd like to propose OrcaRouter as an optional provider for this detector.

Proposed solution

Treat OrcaRouter like any other provider value in the LLMDetector abstraction. OrcaRouter exposes an OpenAI-compatible API and uses standard API-key authentication, so it fits the existing OpenAIClient shape (api_key plus base_url) - no new protocol or SDK. A user would construct an LLM-based detector with OrcaRouter as the backend and keep the rest of the LettuceDetect API unchanged.

The most relevant OrcaRouter capabilities for your users are: access to many chat and reasoning models through one endpoint, automatic model routing with provider failover, prompt caching for repeated context/answer pairs, and usage tracking with budgets for evaluation pipelines.

I'm an engineer on the OrcaRouter team and would be glad to draft the implementation PR if maintainers are open to it - nothing here is implemented or tested yet; this issue is only to gauge fit.

Alternatives considered

Teams can already point the OpenAI client at any OpenAI-compatible gateway via base_url. OrcaRouter adds a managed routing layer with failover, caching, and per-team usage controls, plus an optional partner program for open-source projects.

Disclosure

OrcaRouter runs an optional open-source partner program: approved OSS projects can receive a 5% revenue share from OrcaRouter usage attributed to their integration. Participation is not a prerequisite, and I am happy to follow whatever disclosure or governance policy the project prefers. Existing integrations are listed at https://www.orcarouter.ai/built-with; RAGFlow, Dify, and promptfoo list OrcaRouter as an optional provider.

Maintainers: would an OrcaRouter provider be a welcome addition? If so, I will follow up with a focused implementation PR.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions