agent-go：单二进制无依赖的终端 AI Agent

核心能力与快速开始

★ 0 · Go

能做什么

以单个 Go 二进制形式提供终端 AI Agent：通过 OpenAI 兼容的 HTTP/SSE 流式 Chat Completions 与工具调用接口运行。内置三个工具：exec 直接启动程序并分别回传 stdout、stderr 与退出码（支持工作目录、环境、超时、后台启动与输出文件），image_read 读取本地常规图片作为视觉输入，memory_edit 用完整记忆文本替换语义记忆并将已完成历史移出 RAM 与后续 API 上下文。支持交互模式、-once 单次任务模式、-pipe 读取 stdin 的管道模式，支持 -load/-save/-continue 进行会话加载与检查点保存（v4 增量 JSON 日志，兼容旧 v3 格式），并提供 /paste、/image、/memory、/save 等交互命令与 -verbose 详细日志选项。

适用场景

在终端中进行需要工具调用的自动化任务，例如检查项目、运行测试并报告结果；用 -pipe 把日志等 stdin 数据交给模型分析并输出报告；读取本地图片进行带有视觉输入的问答；通过会话文件保存与继续多轮长任务；将多个独立 Agent 进程交由 shell、CI 或服务管理器调度。

项目形态

可直接使用的工具

部署方式

单二进制，可从 Release 下载对应平台产物、通过 go install 安装，或在 Debian/Ubuntu 上以 agentlet 包名安装；也可本地 git clone 后 go build 构建。支持 Linux、macOS、Windows 的 amd64 / arm64。具体生产部署条件未说明。

主要依赖

构建需要 Go 1.21+，无第三方依赖、无 cgo。运行需要一个支持流式 Chat Completions 与工具调用的 OpenAI 兼容模型服务，图片功能还要求模型支持视觉输入；需通过 AGENT_MODEL、AGENT_API_BASE、AGENT_API_KEY 或同名命令行参数提供模型与 API 地址。模型调用成本、硬件与资源限制未说明。

使用限制

程序不会自动重试请求或重放工具，API 错误、断流、未完成的工具参数和长度截断均按错误处理。没有配置保存时 memory_edit 释放的原文不可恢复；未经整理的历史可能持续占用内存，退出会丢失本次新增记忆。没有固定的工具轮数、图片大小或默认输出大小上限，完整内联输出与未整理的活跃上下文会消耗内存与模型额度。exec 无 PTY，直接执行程序，需要 shell 语法时须显式启动 shell。Windows 的取消只保证终止直接子进程，进程树管理需由外部环境负责。检查点无法把外部程序副作用与保存操作组成事务。目前没有额外的后端适配层，接入本地推理进程需要先确定消息帧、流式输出、取消与工具回合协议。

许可证

MIT

最近推送

2026-10-13 17:43

资料检查：2026-10-14 07:00 · 卡片整理：2026-10-14 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

在终端中运行 AI Agent，通过 exec 工具执行程序、运行测试并报告结果，用于代码检查、测试和排错；支持单次任务、stdin 管道分析日志以及会话保存与恢复。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证