Skip to content

docs: add OrcaRouter as a named compatible provider - #18

Open
kuswardhanietidims-svg wants to merge 1 commit into
shareAI-lab:mainfrom
kuswardhanietidims-svg:docs/orcarouter-provider
Open

docs: add OrcaRouter as a named compatible provider#18
kuswardhanietidims-svg wants to merge 1 commit into
shareAI-lab:mainfrom
kuswardhanietidims-svg:docs/orcarouter-provider

Conversation

@kuswardhanietidims-svg

Copy link
Copy Markdown

What

claw0 teaches you to build a minimal AI agent gateway from scratch, section by section. The .env.example already tells users they can plug in "Anthropic API or compatible providers (e.g. OpenRouter)" via ANTHROPIC_BASE_URL — but OpenRouter is the only provider called out by name.

This PR adds OrcaRouter as a second named, copy-paste-friendly example so users who follow the Quick Start can point claw0 at OrcaRouter the same way they already can at OpenRouter — without treating it as an anonymous custom base URL.

Why OrcaRouter

OrcaRouter is an OpenAI-compatible AI gateway built for both models and agents. Like OpenRouter, it exposes a provider/model namespace across many models — but it also combines adaptive routing, automatic failover, zero-markup inference, observability, guardrails, and agent-tool governance behind the same endpoint. Adding orcarouter as a first-class provider means this project's users can use that stack directly, without 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.

What changed

  • .env.example — add an OrcaRouter block mirroring the existing OpenRouter comment: ANTHROPIC_BASE_URL=https://api.orcarouter.ai with MODEL_ID=orcarouter/auto, and mention it in the "compatible providers" header line.
  • README.md / README.zh.md / README.ja.md — in the Quick Start "Configure" step, add one line noting OrcaRouter works as a named provider through the same ANTHROPIC_BASE_URL mechanism.

How I verified

  • Every session's Python file still compiles (python3 -m py_compile).
  • Live-tested through the exact code path the sessions use — the Anthropic SDK pointed at ANTHROPIC_BASE_URL:
resp.id=2a85c59e-6dc9-4506-88cd-573629192290
model=deepseek-v4-flash
stop_reason=max_tokens
text='OK'
LIVE_OK

The SDK's base_url is used as the API root (it appends /v1/messages), and orcarouter/auto returns a real completion.

Discord: discord.gg/YEubt8enRA · X: https://x.com/OrcaRouter

I'm an engineer on the OrcaRouter team.

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.

1 participant