JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 9
  • Score
    100M100P100Q111358F
  • License Apache License 2.0

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@kdump/gemini-any-llm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Gemini Any LLM Gateway

    让 Gemini CLI 访问任何大语言模型提供商

    🎯 项目简介

    Gemini Any LLM Gateway 是一个 API 网关服务，让您可以通过 Gemini CLI 无缝访问各种大语言模型提供商（如 OpenAI、智谱AI、千问等）。无需修改 Gemini CLI，即可享受多样化的 AI 模型服务。

    核心特性：

    • 🔌 即插即用 - 无需修改 Gemini CLI，完全兼容
    • 🌐 多提供商支持 - 支持 OpenAI、智谱AI、千问等多种提供商
    • ⚡ 高性能流式响应 - 实时流式输出，体验流畅
    • 🛠️ 智能工具调用 - 完整支持 Function Calling
    • 📁 灵活配置管理 - 全局配置 + 项目配置，使用便捷

    🚀 快速开始

    请按照下列顺序全局安装所需工具（已配置 npmmirror 镜像源）：

    npm install -g @google/gemini-cli --registry https://registry.npmmirror.com
npm install -g @google/gemini-cli-core --registry https://registry.npmmirror.com
npm install -g @kdump/gemini-any-llm --registry https://registry.npmmirror.com

    随后直接运行：

    gal code
    • 首次运行 会触发向导，要求填写 baseURL、model 与 apiKey，并写入 ~/.gemini-any-llm/config.yaml。
    • 程序会自动生成或更新 ~/.gemini/settings.json，确保 selectedAuthType 固定为 gemini-api-key。
    • 完成配置后，每次执行 gal code 即可自动连接网关并调用 Gemini CLI。

    📖 使用指南

    配置优先级

    系统支持灵活的配置管理：

    1. 全局配置 (~/.gemini-any-llm/config.yaml) - 默认配置，适用于所有项目
    2. 项目配置 (./config/config.yaml) - 项目特定配置，优先级更高
    3. 环境变量 - 最高优先级，可覆盖任何配置

    重要：如果项目目录下存在 config/config.yaml，将完全不读取全局配置。

    支持的提供商

    提供商 baseURL 推荐模型
    智谱AI https://open.bigmodel.cn/api/paas/v4 glm-4.5
    OpenAI https://api.openai.com/v1 gpt-4
    千问 https://dashscope.aliyuncs.com/compatible-mode/v1 qwen3-next-80b-a3b-thinking

    项目特定配置

    如果您需要为特定项目使用不同的模型或配置：

    # 在项目目录下创建配置
mkdir config
cat > config/config.yaml << EOF
openai:
  apiKey: "project-specific-key"
  model: "gpt-4"
  baseURL: "https://api.openai.com/v1"
gateway:
  port: 3003
EOF

    常见使用场景

    # 日常对话
gemini "解释一下量子计算的基本原理"

# 代码生成
gemini "用 Python 写一个快速排序算法"

# 流式输出（实时响应）
gemini --stream "写一篇关于人工智能发展的文章"

    🔧 配置说明

    基础配置

    • openai.apiKey - 必需 AI 提供商的 API 密钥
    • openai.baseURL - API 端点地址
    • openai.model - 默认使用的模型名称
    • openai.timeout - 请求超时时间（毫秒）

    网关配置

    • gateway.port - 服务端口（默认 23062）
    • gateway.host - 绑定地址（默认 0.0.0.0）
    • gateway.logLevel - 日志级别（debug/info/warn/error）

    🛠️ 常见问题

    启动失败

    问题：服务启动失败，提示 API Key 未配置 解决：检查 ~/.gemini-any-llm/config.yaml 文件，确保 openai.apiKey 已正确设置

    端口冲突

    问题：端口 23062 已被占用 解决：修改配置文件中的 gateway.port 为其他端口

    Gemini CLI 连接失败

    问题：Gemini CLI 无法连接到网关 解决：

    1. 确认服务正在运行：curl http://localhost:23062/api/v1/health
    2. 检查 GOOGLE_GEMINI_BASE_URL 环境变量设置是否正确
    3. 确认防火墙未阻止端口访问

    响应速度慢

    问题：AI 响应速度较慢 解决：

    1. 检查网络连接到 AI 提供商的速度
    2. 尝试使用不同的 baseURL（如国内的镜像服务）
    3. 调整 timeout 设置

    📚 更多资源

    🙏 致谢

    本项目复刻、借鉴了 claude-code-router、llxprt-code 与 aio-cli 的实现方式与代码，在此向这些优秀的开源项目与贡献者表示诚挚感谢。

    🤝 贡献

    欢迎提交 Issue 和 Pull Request！

    📄 许可证

    Apache License 2.0