kimi-bridge
English: README.en_US.md
在即时通讯对话中控制本地的 Kimi Code 智能体。
kimi-bridge 连接本地 Kimi Code 服务器与一个聊天平台，保持聊天和会话的绑定关系，并按平台能力提供流式回复、文件、会话控制和交互功能。
支持情况
| 平台/能力 | 状态 |
|---|---|
| 飞书、QQ、微信私聊 | 已支持 |
| Telegram 私聊 | 实验性 |
| Linux、macOS 和 Windows | 已支持 |
| 语音消息接收 | 飞书、QQ 和微信支持 |
| 审批和提问卡片 | 仅飞书支持 |
快速开始
第一步先安装官方 Kimi Code（注意不是同名的旧版 Python kimi-cli），然后确认 Kimi Code 配置正常，且能够完成问答：
kimi --version
kimi doctor config
kimi -p "Hello there"
确认 Kimi Code 可用后，安装 kimi-bridge：
uv tool install kimi-bridge
kimi-bridge --version
然后选择你最常用的平台登录：
kimi-bridge {feishu, qq, wechat} login
在配置过程中可能需要点击网页链接或扫描二维码完成授权。配置成功后启动 kimi-bridge：
kimi-bridge
就可以在聊天平台中和 Kimi 对话啦！
也可以让 AI 助手全程代办：打开任意 CLI 智能体，对它说：
阅读 https://github.com/Mtrya/kimi-bridge/blob/main/INSTALL_AI.md 并帮我配置 kimi-bridge。
它会向你提问并跑完整个安装流程。
需要更详细的安装步骤、平台侧设置或定制化配置时，参考 安装与运维。配置、聊天命令和架构参考为英文文档：Configuration、Commands、Architecture。
功能特性
- 持久的 Kimi 会话管理：创建、列表、切换、重命名、查看、压缩和撤销。
- 原地编辑的流式回复与路由侧分块；平台支持时另有独立思考流、交互式审批与提问。
- 忙碌回合中的提示引导、取消、权限模式、模型、推理强度、计划、目标、任务、技能和 MCP 查看。
- 接收图片、视频、文件和语音转写，以及
/send文件外发。 - 私聊白名单、仅监听回环地址的 Kimi 服务器监管，以及本地
doctor诊断。
命令
聊天命令包括：
- 会话：
/new、/sessions、/switch、/status、/title、/usage、/compact、/undo； - 控制：
/mode、/model、/effort、/plan、/goal、/stop、/restart-server； - 任务与工具：
/tasks、/skills、/mcp； - 输出：
/send、/render-thinking。
在聊天中输入 /help 或 /<command> ? 查看用法；确切语法和平台限制见命令参考。
架构与安全
飞书、QQ、微信或实验性的 Telegram
│
▼
聊天路由器
│
▼
本地 `kimi web`
受监管的 Kimi 服务器只绑定回环地址并使用随机 bearer token，聊天访问由适配器白名单限制。kimi-bridge 面向一个受信任的操作者；获授权的 Kimi 智能体可以以宿主机账户的权限读写文件和执行命令，请保护宿主机、配置文件和聊天凭据。组件边界与 Kimi Code 兼容性命令见架构与兼容性。
开发
uv sync --dev
uv run pytest -q
uv run ruff check .
许可证
MIT © 2026 Mtrya
1 maintainer
Metadata
1 maintainer
Release files for kimi-bridge 0.8.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kimi_bridge-0.8.7.tar.gz | 400.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kimi_bridge-0.8.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 599.7 kB
Release files / kimi_bridge-0.8.7.tar.gz
| Download URL | kimi_bridge-0.8.7.tar.gz |
|---|---|
| Size | 400.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d47f8f6c19babf5039aac0924f6aee926fb5d7c5bda9e0c301c5d91c8546e31e
|
|
BLAKE2b-256 checksum How to use checksums |
a32dbe5ce8a65fcf2fb116eef999dcb1b61f83b9d6a96ece127f19796e545439
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency logRelease files / kimi_bridge-0.8.7-py3-none-any.whl
| Download URL | kimi_bridge-0.8.7-py3-none-any.whl |
|---|---|
| Size | 199.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb633638667760c4e9f6d132916b9a454ca01752dcd1072bba98e94636c0ab87
|
|
BLAKE2b-256 checksum How to use checksums |
fce045e46715020e291c3adefab41c89c4aa16717ce7f84aab7d655305a28b1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency log
