用途
authsome 是一个开源凭证网关，位于 AI 智能体与其需要调用的外部服务之间。它解决的核心问题是：智能体不只在交互式会话中运行，还会出现在 CI、SSH、cron 任务、后台 worker 和并行流水线中，这些场景需要无需人工介入即可存活的 API 访问。硬编码在环境变量中的令牌容易泄漏或过期，而把认证流程、令牌存储、刷新处理和逐提供商配置写进每个项目，等于反复重建同一套基础设施。Authsome 充当智能体在运行时调用的凭证代理。
主要能力
- 无凭证散落：所有提供商、所有智能体共用一个加密存储，集中管理。
- 智能体永远看不到凭证：认证在智能体进程之外完成，避免外泄风险，环境变量中不再出现密钥。
- 运行时无需浏览器：首次设置可使用浏览器 PKCE、设备码或浏览器桥接来安全录入 API Key；此后智能体以无头方式运行。
- CLI 作为智能体接口：设置一次后，工具运行时按需注入最新凭证。
- 凭证静态加密，并在过期前自动刷新。
- 内置提供商：开箱即支持 OAuth2 与 API Key 两类提供商，官方文档提供完整列表。
- 智能体集成：附带常见智能体框架与 CLI 的适配器，包括 OpenAI Agents SDK，完整列表见 authsome.ai/docs/integrations。
使用方式
基本流程是先用 CLI 完成认证，之后智能体按需获取有效凭证。只需在要执行的命令前加上 authsome run --：
authsome run -- <command>
首次安装与运行设置（包括身份、claim 以及从 .env 导入 API Key）：
# 具体命令见官方文档
对于远程守护进程，一次性传入 --base-url，该地址会保存到客户端配置中供后续命令使用。
使用 Docker 运行常驻守护进程，宿主机无需 Python：
# 具体命令见官方文档
若使用托管的守护进程，在启动 stack 前将 AUTHSOME_BASE_URL 设置为公开 HTTPS URL。首次运行设置、卷备份、TLS 终止与环境变量参考见自托管指南。
将 authsome skill 添加到智能体（claude、codex、cursor、hermes 等）后，可尝试一个需要访问外部服务的示例任务，智能体会使用 authsome 登录外部服务并执行该任务。
适用场景
适用于在无头环境中运行、需要持续访问外部 API 的智能体工作流，例如 CI 流水线、SSH 会话、定时任务、后台 worker 和并行处理流水线。也适合希望集中管理多提供商凭证、统一轮换密钥并审计智能体行为的团队。
限制与要求
- 要求 Python 3.13+（使用 Docker 守护进程模式时宿主机无需 Python）。
- 官方资料未提供具体价格或收费信息。
- 官方资料未提供性能数据、支持的提供商完整清单细节或与其他网关的对比。
- 采用 MIT 许可，详见 LICENSE。
