ConardLi/easy-llm-cli

Easy LLM CLI 截图

这是一个开源的 AI Agent，兼容多种 LLM 模型（Gemini CLI 的一个 Fork 版本）。

本仓库包含 Easy LLM CLI（Gemini Cli 的 Fork 版本），这是一个命令行 AI 工作流工具，它可以连接你的工具、理解你的代码并加速你的工作流。它支持多种 LLM 提供商，包括 Gemini、OpenAI 以及任何遵循 OpenAI API 格式的自定义 LLM API。

使用 Easy LLM CLI，你可以：

利用具有长上下文窗口的先进 LLM 能力来查询和编辑大型代码库。
利用多模态能力，通过 PDF 或草图生成新的应用程序。
自动化运维任务，例如查询 Pull Request 或处理复杂的 Rebase。
使用工具和 MCP 服务器来接入新的能力。
通过简单的环境变量配置并使用你偏好的 LLM 提供商。
在不改变工作流的情况下，无缝切换不同的 LLM 提供商。

我们针对来自不同提供商的各类模型以及本地部署的模型进行了多维度测试，包括：是否有思维链（COT）、是否能完成简单任务、是否有工具调用能力、是否有多模态能力、是否有处理复杂任务的能力，以及是否支持 Token 计数。以下是测试结果：

模型	COT	简单任务	工具调用	MCP	复杂任务	多模态	Token
【Google】Gemini-2.5-pro	✅	✅	✅	✅	✅	✅	✅
【OpenRouter】Claude Sonnet 4	✅	✅	✅	✅	✅	✅	✅
【OpenRouter】Gpt-4.1	✅	✅	✅	✅	✅	✅	✅
【OpenRouter】Grok-4	✅	✅	✅	✅	✅	✅	✅
【Volcengine】Doubao-Seed-1.6	✅	✅	✅	✅	✅	✅	✅
【Bailian】Qwen3-Plus	✅	✅	✅	✅	✅	✅	✅
【Moonshot】kimi-k2	✅	✅	✅	✅	✅	❌	✅
【Volcengine】DeepSeek-R1	✅	✅	✅	✅	✅	❌	✅
【Siliconflow】DeepSeek-R1	✅	✅	✅	✅	✅	❌	✅
【Volcengine】Doubao-1.5-Pro	❌	✅	✅	✅	⚠️	❌	✅
【Volcengine】DeepSeek-V3	❌	✅	✅	✅	⚠️	❌	✅
【Bailian】Qwen3-235b-a22b	✅	✅	✅	✅	⚠️	❌	✅
【vLLM】Qwen2.5-7B-Instruct	❌	✅	✅	✅	⚠️	❌	✅
【vLLM】DeepSeek-R1-32B	✅	✅	✅	✅	⚠️	❌	✅
【Ollama】Qwen2.5-7B-Instruct	❌	✅	✅	✅	⚠️	❌	✅

快速开始

前提条件： 确保已安装 Node.js 20 版本或更高版本。
运行 CLI： 在终端执行以下命令：
```
npx easy-llm-cli
```
或者通过以下命令全局安装：
```
npm install -g easy-llm-cli
elc
```

自定义 LLM 配置

Easy LLM CLI 支持连接到任何兼容 OpenAI 的 LLM API。你可以使用以下环境变量配置你偏好的 LLM：

# 启用自定义 LLM 支持
export USE_CUSTOM_LLM=true 

export CUSTOM_LLM_PROVIDER="openai"  # LLM 提供商
export CUSTOM_LLM_API_KEY="your-api-key"     # 你的 LLM 提供商 API Key
export CUSTOM_LLM_ENDPOINT="https://api.your-llm-provider.com/v1"  # API 端点
export CUSTOM_LLM_MODEL_NAME="your-model-name"  # 模型名称

# 可选参数
export CUSTOM_LLM_TEMPERATURE=0.7  # 温度系数 (默认: 0)
export CUSTOM_LLM_MAX_TOKENS=8192  # 最大 Token 数 (默认: 8192)
export CUSTOM_LLM_TOP_P=1          # Top P (默认: 1)

设置这些变量后，Easy LLM CLI 将使用你的自定义 LLM 而不是默认的 Gemini 模型。

使用示例

CLI 运行后，你可以直接在 Shell 中与 Gemini 进行交互。

你可以从一个新目录开始一个项目：

cd new-project/
elc
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

或者在一个现有的项目中使用：

git clone https://github.com/ConardLi/easy-llm-cli
cd easy-llm-cli
elc
> Give me a summary of all of the changes that went in yesterday

在代码中运行

Easy LLM 支持通过 NPM 直接集成到你的代码中：

import { ElcAgent } from 'easy-llm-cli';

const agent = new ElcAgent({
  model: 'custom-llm-model-name',
  apiKey: 'custom-llm-api-key',
  endpoint: 'custom-llm-endpoint',
  extension: {
    mcpServers: {
      chart: {
        command: 'npx',
        args: ['-y', '@antv/mcp-server-chart'],
        trust: false
      }
    },
    excludeTools: ['run_shell_command']
  }
});

const result = await agent.run('Please generate a bar chart for sales data');
console.log(result);

查看详细的 API 文档：程序化 API (Programmatic API)

后续步骤

了解如何贡献代码或从源码构建。
探索可用的 CLI 命令。
如果遇到任何问题，请查阅 故障排除指南。