Hoshimi
Hoshimi 是一个兼容 OpenAI 与 Anthropic 的网关：把免费模型站点、云服务和本地模型接到同一套 API 和 Web UI 后面。本页介绍它能做什么，以及文档的组织方式。
Hoshimi 是一个用 Python 编写的模型网关。它把免费模型站点（Cline、TRAE、ZCode、Qoder、MiniMax、Gemini、CodeBuddy、Kilo、OpenCode Zen 等）、云服务（Azure、Cloudflare、Vertex、Bedrock、NVIDIA NIM 等）和本地或自建的 OpenAI 兼容服务接到同一个本地服务器后面：客户端只需要一个 Base URL 和一份模型目录，就能通过 Chat Completions、Responses 或 Anthropic Messages 调用其中任何一个模型；一个多语言的 Web UI 用来管理渠道和账户、浏览模型、聊天和查看用量。
安装后执行 hoshimi serve，打开 http://127.0.0.1:10600 即可使用。OpenCode Zen 和 Kilo 的匿名入口默认启用，不需要账户，也不需要配置文件。
快速开始
安装、启动、在 Playground 里聊第一句，再发出第一个 API 请求。
安装
系统要求、pip / uv / pipx、可选依赖、升级、源码安装与后台运行。
首次运行
第一次打开 Web UI 时看到什么：登录、默认的匿名渠道、各个页面在哪里。
能做什么
| 功能 | 说明 | 详见 |
|---|---|---|
| 统一接口 | 在 /v1 下提供 Chat Completions、Responses、Anthropic Messages 与 Token 计数，以及模型列表 | 接入客户端 |
| 渠道与账户 | API Key、浏览器或设备码登录、凭据自动续期、多账户轮换、余额与每日签到 | 渠道、渠道概念 |
| 模型目录 | 每个模型的能力（推理、视觉、工具调用）、思考强度选项和可用性探测 | 模型、模型行为 |
| 实时用量 | 进行中的调用、Token 与缓存明细、首字延迟和生成速度，可按小时查看任意一天，保存在本地 SQLite 数据库中 | 用量 |
| Playground | 在浏览器里和任意模型聊天，可选内置工具（读写文件、运行命令、搜索网页），执行前征求同意 | Playground、Playground 工具 |
| 安全 | 管理界面与模型接口各自独立的密钥，允许的网段、主机名与来源 | 安全 |
文档板块
开始
安装、启动和第一次使用。
使用教程
Web UI 逐页讲解：概览、模型、渠道、Playground、用量与设置。
接入客户端
OpenAI 与 Anthropic SDK、curl、Claude Code、Codex 和 OpenCode 的配置。
渠道
免费站点、匿名入口、agg 聚合、云平台、NVIDIA 与本地模型。
命令行
hoshimi 命令、全部选项与环境变量。
配置
config.json 的每个键、网络与代理、安全、数据目录。
进阶
能力与探测、重试与账户轮换、用量记录、EAC、迁移与常见问题。
API 参考
/v1 模型接口、/api/v1 管理接口和 Playground 接口。
开发文档
仓库结构、架构、编写渠道适配器、Web UI、测试与发布。