Skip to content

docs: add OrcaRouter to supported providers - #89

Open
Marc-oss-hub wants to merge 1 commit into
wanxingai:mainfrom
Marc-oss-hub:docs/add-orcarouter-provider
Open

docs: add OrcaRouter to supported providers#89
Marc-oss-hub wants to merge 1 commit into
wanxingai:mainfrom
Marc-oss-hub:docs/add-orcarouter-provider

Conversation

@Marc-oss-hub

Copy link
Copy Markdown

Summary

  • Adds OrcaRouter to the README provider lists and documents it with a dedicated section in docs/model_providers.md, mirroring the existing OpenRouter and Atlas Cloud sections.

OrcaRouter is an OpenAI-compatible model routing gateway that exposes 150+ models from OpenAI, Anthropic, Google, DeepSeek, Qwen and others behind a single endpoint and API key. 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.

Compatibility

  • Existing agent.run("hello") behavior is unchanged, or the change is documented. (docs-only change)
  • Existing stream=True behavior is unchanged, or the change is documented. (docs-only change)

Tests

  • python -m compileall -q LightAgent (passed)
  • PYTHONPATH=. python -m pytest -q tests/test_v065_core.py tests/test_v070_tracing.py tests/test_memory_policy.py (57 passed)
  • Live: LightAgent(model="openai/gpt-5.5", api_key=..., base_url="https://api.orcarouter.ai/v1") returned ORCA-OK

Notes

Documentation only. No code, API, or behavior changes.

I'm an engineer on the OrcaRouter team.

Add OrcaRouter to the README provider lists and document it in
docs/model_providers.md with a dedicated section mirroring OpenRouter and
Atlas Cloud. LightAgent already works with any OpenAI-compatible endpoint
via model / api_key / base_url, so this is documentation only.

@wxai-space wxai-space left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thank you for the documentation contribution. The integration direction is compatible with LightAgent because OrcaRouter exposes an OpenAI-compatible endpoint, but a few changes are required before merge:

  1. Please use orcarouter/auto as the primary example model, or clearly state that provider model IDs such as openai/gpt-5.5 and anthropic/claude-opus-4.8 are dynamic and must be confirmed in OrcaRouter's current model catalog. This keeps the LightAgent documentation from becoming stale when upstream model availability changes.
  2. Please add a link to the official OrcaRouter model catalog or documentation next to that availability note.
  3. Please rebase or update this branch against the latest main, which now contains v0.9.7.
  4. No GitHub Actions checks are currently reported for this commit. Please push the documentation update so the full repository CI can run. If GitHub requires maintainer approval for the external workflow, we can approve it after the updated commit appears.

Please keep the repository documentation limited to verifiable compatibility/configuration details and avoid long-term guarantees about model availability, routing behavior, or security policy that are controlled by the external service.

@wxai-space

Copy link
Copy Markdown
Collaborator

Follow-up on the existing Changes Requested review: the compatibility direction remains reasonable, and the official OrcaRouter documentation now confirms the OpenAI-compatible /v1 endpoint and orcarouter/auto routing model. The current PR still points to the original commit, is behind main, and has not addressed the requested documentation changes.

Please update the PR within 7 days with the following:

  • use orcarouter/auto as the primary example;
  • link the official model catalog and state that concrete provider model IDs are dynamic;
  • remove or clearly attribute marketing/security guarantees that LightAgent does not independently verify;
  • load the API key from an environment variable;
  • update the branch against current main;
  • push the revised commit so we can approve and run the external-contributor CI workflow.

If no update is made, we will close this PR as stale. A focused replacement PR will remain welcome later.

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