ConardLi/easy-llm-cli

Easy LLM CLI 截图

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

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

通过 Easy LLM CLI，你可以：

利用具有大上下文窗口的高级 LLM 功能查询和编辑大型代码库。
利用多模态功能，从 PDF 或草图生成新的应用程序。
自动化操作任务，例如查询 Pull Request 或处理复杂的 Rebase。
使用工具和 MCP Server 来连接新功能。
通过简单的环境变量配置并使用你偏好的 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"     # 你的 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 中与模型进行交互。

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

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

后续步骤

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