workbuddy-manager
腾讯 CodeBuddy 账号池管理控制台,内置 OpenAI 兼容反代网关:扫码批量纳管账号、定时签到与保活、密钥分组分发、IP 与模型白名单、调用日志与用量统计;支持带签名校验的
What is workbuddy-manager?
腾讯 CodeBuddy 账号池管理控制台,内置 OpenAI 兼容反代网关:扫码批量纳管账号、定时签到与保活、密钥分组分发、IP 与模型白名单、调用日志与用量统计;支持带签名校验的一键更新。
Overview of workbuddy-manager
What it is
WorkBuddy Manager is a web-based management console for Tencent CodeBuddy account pools, built on top of workbuddy2api. It provides a visual interface to replace command-line operations such as adding accounts via scripts, checking status with curl, and manually editing configuration files. The project includes an OpenAI-compatible reverse proxy gateway, enabling standard SDK connections with streaming and non-streaming support. It does not modify any code of the upstream workbuddy2api; instead, it complements it by adding account management, key distribution, IP and model whitelisting, usage logging, and statistics.
Key features
- QR code account enrollment – Add accounts by scanning a QR code via WeChat or QQ; automatic daily check-in, credential file writing, and upstream reloading follow.
- Scheduled check-in and keep-alive – Four types of scheduled tasks (check-in, travel, activity, keep-alive) with configurable switches and execution times.
- Key group distribution – Generate multiple API keys, each with independent version, validity period, IP count, IP/model whitelist, and quota.
- IP and model whitelisting – Inbound IP allow/deny lists (CIDR) and per-key IP and model restrictions.
- Call logging and usage statistics – Full audit of every call: model, token count, latency, source IP; daily/hourly usage charts.
- One-click update with signature verification – Update the application from the latest release, verifying the SHA-256 digest and
.sigsignature.
Use cases
- Managing multiple CodeBuddy accounts for personal or team use, with automatic check-in and health monitoring.
- Distributing API keys to downstream users or applications, each with separate quotas, IP restrictions, and model access.
- Providing an OpenAI-compatible endpoint for existing tools and SDKs, with full audit trails and usage tracking.
- Operating a public-facing gateway with IP whitelisting and model aliasing for seamless migration.
Getting started
bash docker run -d --name workbuddy-manager -p 127.0.0.1:7864:7864 -v /opt/workbuddy-manager/data:/app/data ghcr.io/ithtelab/workbuddy-manager:latest For a one-click server installation script, see the repository README. Windows users can use the graphical installer (WorkBuddyManagerSetup.exe) from the Releases page.
License and pricing
The project is open source under the MIT license. It is free to use, modify, and distribute within the license terms.
Based on the project's public README and repository metadata.