Skip to content

feat: add OrcaRouter as an LLM Advisor provider - #8826

Merged
nvuillam merged 3 commits into
oxsecurity:mainfrom
zsanig22-dotcom:feat/orcarouter-provider
Aug 31, 2026
Merged

feat: add OrcaRouter as an LLM Advisor provider#8826
nvuillam merged 3 commits into
oxsecurity:mainfrom
zsanig22-dotcom:feat/orcarouter-provider

Conversation

@zsanig22-dotcom

Copy link
Copy Markdown
Contributor

Add OrcaRouter as a first-class LLM Advisor provider, mirroring the existing Grok integration. OrcaRouter is an OpenAI-compatible AI gateway built for both models and agents: like OpenRouter it exposes a provider/model namespace across many models, while adding adaptive routing, automatic failover, zero-markup inference, observability, guardrails, and agent-tool governance behind the same endpoint. Adding it as a named provider means MegaLinter users can use that stack directly instead of treating OrcaRouter as an anonymous custom base URL. It also runs gateway-level, zero-trust security for AI agents on the same endpoint — screening every prompt/response and governing every tool call on a default-deny basis, with no application code changes.

Changes: new llm_provider_orcarouter.py (ChatOpenAI against https://api.orcarouter.ai/v1, default model orcarouter/fusion-mini), factory + lazy module registration, ORCAROUTER_API_KEY, provider doc page, and provider tables in docs/llm-advisor.md, docs/llm-providers.md and mkdocs.yml.

Verification: ruff (repo config) and black pass; existing test_llm_advisor_integration.py passes (15 tests + 3 subtests); live-tested the provider through LLMProviderFactory against api.orcarouter.ai with a real key (model response, HTTP 200).

I'm an engineer on the OrcaRouter team. Discord: discord.gg/YEubt8enRA · X: https://x.com/OrcaRouter

Add OrcaRouter as a first-class LLM provider for the LLM Advisor, mirroring
the Grok provider integration: it is an OpenAI-compatible AI gateway, so it
reuses langchain_openai ChatOpenAI against https://api.orcarouter.ai/v1.

Users enable it with LLM_PROVIDER: orcarouter and ORCAROUTER_API_KEY.
SPELL_CSPELL reported 25 unknown words, all occurrences of the new
provider name in code, docs and the CHANGELOG. Added "ORCAROUTER" and
"orcarouter" to the .cspell.json words list, next to the existing
DEEPSEEK/deepseek and OLLAMA/Ollama/ollama entries of the other
providers. The CamelCase OrcaRouterProvider was already accepted, as
cspell splits it into known words.

The merge of main in the previous commit fixes test-doc-gen, which
failed on a langchain_core==1.5.6 pin incompatible with
langchain_google_genai 4.3.5 (needs >=1.6.0). That conflict is unrelated
to this PR and was fixed on main by oxsecurity#8838.

@nvuillam nvuillam left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for the PR :)

@nvuillam
nvuillam merged commit 2ce4224 into oxsecurity:main Aug 31, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants