niyouqianma/workbuddy2api-hub
AI EngineeringA local OpenAI-compatible gateway that exposes WorkBuddy and CodeArts accounts as standard chat, image and video APIs.
What it does
WorkBuddy2API-Hub is a locally deployed gateway that wraps WorkBuddy (international and China editions) and Huawei CodeArts accounts behind OpenAI-style endpoints: /v1/chat/completions, /v1/responses, /v1/models, plus image and video generation routes. It is aimed at people who already have these accounts and want to call them from Codex, Claude Code, NextChat or other OpenAI-compatible clients.
The main addition over a plain proxy is a control plane: a web dashboard for account import via browser OAuth, per-account outbound proxy slots, multiple API keys with model/account whitelists, usage and token accounting, automatic failover and quota rotation. It also includes automated check-in and activity tasks, and an optional Go/uTLS outbound bridge selected by WB_TLS_FINGERPRINT (default auto, falling back to Python/OpenSSL).
Quick start
Requirements: Python 3.9+ for the script route, or Docker. Run from the directory containing wb_proxy.py:
cd /path/to/workbuddy2api-hub
python3 -m wb_proxy --port 8788
Starting with -m matters for memory use according to the README, and the directory must be the project root. On Windows, the start-wb-proxy.bat scripts launch it in the background; macOS/Linux use ./start-wb-proxy.sh [port].
Then open the dashboard at http://127.0.0.1:8788/ (default password admin, change it in settings), add an account through the OAuth button, create an API key under Settings, and point a client at http://127.0.0.1:8788/v1 with that key. Verify with GET /v1/models to see the model IDs actually available for the bound outlet.
Docker users can pull the GHCR image or use the compose file from the README; the compose example persists ./accounts and ./usage.
Constraints
- The project depends on unofficial client behavior against a third-party service. The README states upstream detection tightened from 2026-10-23 and that accounts may be rate-limited or banned; the maintainer does not guarantee timely fixes.
- Credentials are read and stored locally under
accounts/; the README warns against exposing the gateway publicly and recommends revoking OAuth/device tokens if it has been. The default dashboard password isadminand must be changed. - The Anthropic Messages adapter is experimental and off by default (
WB_ENABLE_ANTHROPIC_MESSAGES=0); long-session cache behavior differs. - Model IDs are matched exactly against the upstream catalog for CodeArts; aliases for chat models are gated by
model_aliases_enabled, off by default. - License is MIT. Use of the upstream service remains subject to that service's own terms, and the README says to use it for protocol research and personal use only.
HotRepo's take
The repository appeared in HotRepo's new-project board for Python on 2026-11-16, gaining 5 stars and 3 forks in a one-hour window (105 stars, 44 forks at observation). That window is too short to say anything about sustained traction, and no all-language daily rank was recorded. The technical substance is a substantial control plane — dashboard, key scoping, proxy slots, request logs — but its viability is tied to a third-party service that the README itself says is actively blocking unofficial clients. Read this as a tooling project with an explicit upstream risk, not as a stable API provider.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- linguo2625469/workbuddy2api-panelSelf-hosted OpenAI-compatible gateway that pools CodeBuddy accounts and automates growth tasks, with an admin panel.
- QuantumNous/new-apiA self-hosted gateway that puts many model providers behind one OpenAI-, Claude- or Gemini-compatible API for teams and agents.
- yang0/chatgpt2api-dshRuns a local ChatGPT account pool and exposes an OpenAI-compatible API for desktop AI clients and image generation.
- do-whilefor/zcode2apiSelf-hosted gateway that reshapes ZCode free-account access into OpenAI- and Anthropic-compatible APIs.
- nwverse/personaSelf-hosted hub that routes chat requests to coding agents across your devices with an extension system.