Skip to content

feat(gateway): add Atlas Cloud as a runtime source provider#23

Open
lucaszhu-hue wants to merge 1 commit into
kellyvv:mainfrom
lucaszhu-hue:atlas-cloud-provider
Open

feat(gateway): add Atlas Cloud as a runtime source provider#23
lucaszhu-hue wants to merge 1 commit into
kellyvv:mainfrom
lucaszhu-hue:atlas-cloud-provider

Conversation

@lucaszhu-hue

@lucaszhu-hue lucaszhu-hue commented Jun 17, 2026

Copy link
Copy Markdown

What

Wires Atlas Cloud into the Mac-side PhoneClaw Gateway as a first-class runtime source. Atlas Cloud exposes an OpenAI-compatible API (https://api.atlascloud.ai/v1), giving one key access to many cloud models (Claude / GPT / Qwen / DeepSeek / GLM / …) — useful when on-device models aren't enough, while the iPhone keeps its native chat/Skill experience.

Why this is code, not just docs

The Gateway already has a ProviderKind enum, a generic OpenAICompatibleProvider (handles /v1/models + /v1/chat/completions), and makeProvider's default: branch that builds it for cloud kinds. The only thing gating cloud providers from being routed was isMainRuntimeSource / catalogCases. So Atlas Cloud plugs into the existing, already-implemented HTTP-upstream path — no new transport/SSE code needed.

Changes

  • PhoneClawGateway/.../GatewayApp.swift
    • New ProviderKind.atlasCloud (BYOK category): title = "Atlas Cloud", icon, defaultID = atlascloud, defaultBaseURL = https://api.atlascloud.ai/v1, needsAPIKey/commonlyUsesAPIKey = true, default models (deepseek-ai/deepseek-v4-pro, anthropic/claude-sonnet-4.6, qwen/qwen3-coder-next, openai/gpt-5.5).
    • Added to catalogCases → appears as a selectable tile in the provider picker.
    • Added to isMainRuntimeSource → it is built, validated (http/https URL check), persisted and routed through OpenAICompatibleProvider like the other runtime sources.
  • README.md / README_EN.md: Atlas Cloud section + a step documenting how to select it as a Mac runtime source (prefilled URL, paste API key, edit model list).

Verification

cd PhoneClawGateway && swift build passes — the exhaustive ProviderKind switches force compile-time completeness, so every case is covered. The API key is read from the existing per-provider Keychain field (no key committed).

🤖 Generated with Claude Code


🤝 Partnership & contact

This PR comes from the Atlas Cloud team. Beyond the integration above, we'd love to explore a closer collaboration with PhoneClaw — for example co-marketing or a featured integration.

If that sounds interesting, reach out anytime:

And of course, happy to revise this PR to match your project's conventions — just leave a comment. 🙌

Wire Atlas Cloud into the Mac PhoneClaw Gateway as a first-class
runtime source. Atlas Cloud exposes an OpenAI-compatible API
(https://api.atlascloud.ai/v1), so it routes through the existing
OpenAICompatibleProvider with no new transport code.

- Add `atlasCloud` case to ProviderKind (BYOK category): title,
  icon, defaultID, defaultBaseURL, default models, API-key flags.
- Add it to `catalogCases` so it appears as a selectable tile in
  the provider picker, and to `isMainRuntimeSource` so it is built,
  validated (http/https URL) and routed like the other runtime
  sources. Build passes (swift build).
- README / README_EN: Atlas Cloud section + document choosing it as
  a Mac runtime source.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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