AI助手框架

快速开始

从获取Zypher代理 https://zypher.corespeed.io/，CoreSpeed平台内的开源AI代理框架/SDK，用于构建生产就绪的自主代理。

该项目使用 Zypher代理框架 建造a 基于CLI的AI助手，设计为代理就绪虽然当前的实现侧重于快速、轻量级的基于文本的交互，但该架构是有意可扩展的，这使得它很容易在未来发展成为一个具有高级功能的完全自主的代理。

本指南将帮助您在5分钟内运行CLI AI助手。

先决条件

• 第2.0天+ –从安装 https://docs.deno.com/runtime/getting_started/installation/

• API密钥

  • Gemini API密钥– https://aistudio.google.com/
    • 注： 要检索Gemini的模型名称，请单击Key列表并复制cURL快速入门。
  • Firecrawl API密钥– https://www.firecrawl.dev/

  注：

  • Gemini充当示例LLM服务器。
  • Firecrawl是一个用于网络爬行的MCP服务器示例。

第一步：克隆项目

git clone <this-project-https-clone-url>
cd ZypherMindCLI

步骤2：配置环境变量

创建一个 .env 项目根目录中的文件：

GEMINI_API_KEY=your_gemini_api_key_here
FIRECRAWL_API_KEY=your_firecrawl_api_key_here

步骤3：安装VSCode扩展

从安装Deno VSCode扩展 https://deno.land这为Deno提供了一个语言服务器客户端。

第四步：运行你的助手

使用以下命令启动CLI AI助手：

deno run -A main.ts

• 这 -A 标志授予所有权限(--allow-net --allow-read --allow-env等等）并自动获取和缓存依赖关系。

运行后，终端界面允许您：

• 与您的客服互动聊天
• 接收实时流式响应
• 在同一次会议中提出后续问题

尝试不同的任务

在您的助手运行后，您可以尝试：

• 用要点为创业团队写一条简短的激励信息。
• 用幽默的语气重写激励信息，并将其限制在3个项目内。
• 使用Firecrawl进行爬网 https://openai.com/research 并提取最新研究更新的标题。
• 等等

关于功能覆盖范围

ZypherMindCLI目前是 CLI AI助手， 还不是一个完全自主的代理。

然而，它是使用 Zypher Agent框架， 使其：

• 代理就绪
• 模块化和可扩展
• 专为未来升级为完整的AI代理系统而设计

目前的实施重点是 自由层Gemini API的核心优势：

• 快速文本生成
• 内置推理能力
• 轻量级CLI交互

注： 有关Gemini API功能及其潜在用途的完整列表，请参阅官方文档： Gemini API下一步行动.

ZygerMindCLI中的Gemini API功能覆盖

已支持：

• 文本生成 –完全支持使用 generateContent +流媒体。
• 思考/推理 –Gemini型号自动利用。

Gemini中可用，本项目中未实现：

• 图像生成
• 图像理解（视觉）
• 函数调用
• 长上下文
• 嵌入

有意不包括这些功能，以保持CLI体验简单高效。

未来范围（计划但未实施）

该项目旨在发展成为一个完全自主的代理系统。计划的功能包括：

1.功能调用和任务自动化（核心代理能力）

• 执行系统命令
• 创建和编辑文件
• 调用外部API

2.工具集成

• CLI工具
• 网络搜索
• 外部服务

3.记忆与嵌入

• 存储过去的交互
• 实现长期记忆和回忆

4.多模式输入

• 接受PDF、图像和其他文件类型

5.图像功能

• 图像生成
• 视觉理解（视觉模型）

设计理念

ZypherMindCLI采用渐进式增强方法：

• 简单开始→ 基于CLI的助手
• 保持快速→ 针对免费层API进行了优化
• 稍后缩放→ 发展成为一个完整的代理系统

这使其非常适合：

• 开发人员探索AI代理
• 快速原型制作
• 学习代理架构
• 逐步构建生产就绪系统

对于大多数基于CLI的用例，当前的实现简单、快速，并且与自由层Gemini模型的优势非常一致。