NeuroLink
用统一的 TypeScript 接口连接多家模型、决策模型、语音、RAG、记忆与 MCP 工具。
- Star 数
- ★ 167
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 维护 TypeScript 产品的团队,希望在 OpenAI、Anthropic、Vertex AI、Bedrock 或本地运行时之间切换,而不重写应用层调用。
- 不适合
- 需要现成图形界面的团队
- 需要模型解释决策理由的流程
- 希望直接执行不可逆自动决策的团队
- 官网
- neurolink.ink ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v13.13.5(2026-11-19)
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
NeuroLink 是一个 MIT 许可的 TypeScript SDK 与 CLI,用统一管道连接 OpenAI、Anthropic、Google、AWS、Azure、Mistral、聚合服务及本地模型运行时。核心接口提供 generate、stream 和 decide 三类推理:前两者生成文本,后者返回带概率或置信度的布尔、选项或评分判断。它还包含 MCP 客户端能力、工具执行、多提供商故障转移、RAG、会话记忆、文件处理、嵌入以及 TTS、STT 和实时语音接口。应用通过 NeuroLink 类发起请求,并消费文本、异步数据流、结构化决策、音频或其他模态结果;CLI 则提供终端入口。它既能调用托管 API,也能连接 Ollama、LM Studio 和 llama.cpp 等本地运行时,但具体模型、凭据和外围存储仍由采用者配置和运营。
应用创建 NeuroLink 实例后,将文本、音频、图像或文件输入交给选定的提供商。generate() 返回完成后的内容,stream() 暴露可异步迭代的数据流,decide() 和故障开放的 tryDecide() 则把一个 state 与命名问题映射成类型化的 boolean、choice 或 score 结果。RAG 配置可对文件执行分块、嵌入、混合检索与重排,并使用内存、Chroma、PgVector 或 Pinecone 向量存储;记忆层支持 S3、Redis 或 SQLite。MCP 层支持 stdio、HTTP、SSE 和 WebSocket 传输,并提供多服务器管理、工具路由、缓存和批处理。语音路径可在 generate() 或 stream() 中配置 TTS/STT,也可通过 RealtimeProcessor.connect() 建立 OpenAI Realtime 或 Gemini Live 会话。ResearchWorker 还能在指定仓库路径内提出代码修改、运行实验命令并从输出中提取指标。
- 维护 TypeScript 产品的团队,希望在 OpenAI、Anthropic、Vertex AI、Bedrock 或本地运行时之间切换,而不重写应用层调用。
- 客服平台需要用
choice分派工单、用score排序优先级,并把低置信度结果交给人工复核。 - 知识库应用需要把文件自动分块、嵌入、检索和重排,再将相关上下文送入
generate()或stream()。 - 语音产品需要组合多家 TTS/STT 提供商,或接入 OpenAI Realtime、Gemini Live 的双向实时音频。
- 使用 MCP 工具服务器的工程团队,需要在同一 SDK 中管理多服务器、传输协议、工具选择、缓存和批处理。
- 机器学习研发人员希望让
ResearchWorker修改指定文件、执行训练命令并按指标评估实验。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 环境变量
TYPESAFE_API_KEYAI_GATEWAY_API_KEYLAYA_API_KEYLAYA_BASE_URL
如何安装或部署这个 Agent?
已提供的材料标明 npm 包名为 @juspay/neurolink,但未展示可核验的安装命令,也没有明确写出最低 Node.js 或包管理器版本。因此无法仅依据这些材料给出完整、可复制的安装命令。安装后还需为所选后端配置相应凭据;例如 TypeSafe Jev 使用 TYPESAFE_API_KEY,也可通过带 AI_GATEWAY_API_KEY 的 Vercel AI Gateway 访问。Laya 自托管路径需要同时提供 LAYA_API_KEY 与 LAYA_BASE_URL;本地或其他提供商则按所选运行时配置。
如何使用这个 Agent?
下面是材料中给出的最小流式调用。代码创建统一管道、发送文本,并逐块输出内容:
import { NeuroLink } from "@juspay/neurolink";
const pipe = new NeuroLink();
const result = await pipe.stream({ input: { text: "Hello" } });
for await (const chunk of result.stream) {
if ("content" in chunk) {
process.stdout.write(chunk.content);
}
}需要类型化判断时,可使用故障开放的 tryDecide();未配置决策提供商时它返回 null:
import { NeuroLink } from "@juspay/neurolink";
const pipe = new NeuroLink();
const decision = await pipe.tryDecide({
state: { ticket: "Refund request, $42, first occurrence" },
questions: {
autoApprove: {
type: "boolean",
instructions: "Approve without human review.",
},
},
});
console.log(decision?.answers.autoApprove.probability);CLI 还公开了 decide 包装命令,但材料没有提供 CLI 的安装方式或完整启动配置:
neurolink decide [state]这个 Agent 有哪些优点和局限?
- 把文本生成、流式生成和校准决策建模为三种明确的推理类型,并由提供商声明支持的
inferenceKinds。 - 覆盖多家云模型、LiteLLM、OpenRouter,以及 Ollama、LM Studio、llama.cpp 三种本地运行时,降低单一提供商绑定。
- MCP 原生支持 stdio、HTTP、SSE、WebSocket 四种传输,并包含工具路由、缓存、批处理和多服务器管理。
- RAG、记忆、文件处理、嵌入、语音与多提供商回退都位于同一套 SDK 接口中。
- 模型路由、上下文压缩和工具选择等优化采用故障开放设计;未配置决策密钥时不会强制启用。
decide在材料中仍标记为next,采用者需要评估预发布接口和行为变化风险。- 文档称决策模型约有 68% 准确率,且不返回理由,因此不适合无人复核的不可逆操作。
- 高级能力依赖额外服务或基础设施,例如 Redis、S3、SQLite、向量数据库、MCP 服务器和各提供商凭据。
- 不同决策提供商的上下文限制差异显著:Laya 默认检查点约 768 tokens,而 TypeSafe 约 33,000 tokens。
- 所给材料未包含可验证的安装命令、最低运行时版本或完整首次配置流程。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| NeuroLink 当前 | 56 · 缺口较多 | 代码库 / SDK免费 | ★ 167 | 1 天前 | TypeScript | OpenAI API · Claude API |
| FlowCraft | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 410 | 1 天前 | Go | OpenAI API · Claude API |
| AgentScope 2.0 | 61 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 36k | 1 天前 | Python | OpenAI API · Claude API |
| Qwen Code | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 31k | 今天 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
附件安全文档说明本地路径、URL、重定向、网络地址和大小限制,并披露未配置 allowedRoots 时可读取进程可访问的任意文件;CLI 对项目 MCP 配置采用信任门控,支持交互确认或显式信任。环境变量、远程服务、MCP 和自动研究命令会产生外部影响,文档对影响和恢复路径仅有部分说明;依赖安全材料有限,发布者身份未验证,不能据此加分。
源文件和文档指出了结构化输出截断、提供商重试与故障转移等行为,也列出具体错误处理路径;但 README 的概述和多份指南中的配置、版本说法不能在本摘录内完整核对,且依赖可用性没有逐项证据,因此扣分。
README、安装指南和多 Agent 配置覆盖 CLI、SDK、框架集成、不同提供商、工具和部署场景;附件策略、工具选择和能力声明提供边界。样本对目标读者及不适用场景仍不够集中,部分能力描述主要是声明,因此未给满分。
文档有清晰目录链接、安装步骤、示例、FAQ/故障排查入口和已知限制;LICENSE 明确为 MIT。README 的版本表和安全政策给出更新信息,但样本对维护责任、支持渠道及更新承诺的说明有限,且个别文档示例需谨慎对照实际配置。
生成、流式处理、结构化决策、MCP、语音、RAG 和多提供商接口展示了实际集成价值,示例也能帮助调用者开始使用。成本收益主张(如延迟与单次成本)在样本中属于项目陈述,缺少可核验的测量细节;广泛能力也带来配置和运行负担。
安全策略和 CLI 源码对 MCP 信任流程相互印证,附件文档给出具体配置与行为,README 也链接到专题文档。若干性能、覆盖范围和产品能力数字仍是 README 的主张,当前样本不足以独立验证;审查严格限于所给材料,未作运行或独立测试。
- 若路径输入来自不可信调用方,应配置 attachments.allowedRoots;默认行为允许进程读取任何可访问文件。
- AutoResearch 示例会修改代码、提交变更、运行命令并可能回滚;应先限制可改路径、检查命令和指标设置,并确认仓库状态及恢复方式。
- 样本未提供依赖清单、漏洞审计结果或完整实现,不能据此判断依赖风险或验证所有安全主张。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
[13.13.5](https://github.com/juspay/neurolink/compare/v13.13.4...v13.13.5) (2026-11-19) Bug Fixes * (hitl): add opt-in confirmDirectToolCalls for direct executeTool built-in calls ([5080ef7](https://github.com/juspay/neurolink/commit/5080ef74f67994c85bb774599aed314220880bf6))在 GitHub 查看 ↗ -
发布说明摘录
[13.13.4](https://github.com/juspay/neurolink/compare/v13.13.3...v13.13.4) (2026-11-19) Bug Fixes * (tool-routing): enforce toolRouting.timeoutMs on the decide call ([832867b](https://github.com/juspay/neurolink/commit/832867ba92f11aee1bed721d6d8f0a366c20ded1))在 GitHub 查看 ↗ -
发布说明摘录
[13.13.3](https://github.com/juspay/neurolink/compare/v13.13.2...v13.13.3) (2026-11-19) Bug Fixes * (telemetry): redact decide error bodies before they reach spans ([ad71204](https://github.com/juspay/neurolink/commit/ad71204072a15eb6b2304836443477785b14fecb))在 GitHub 查看 ↗
常见问题
必须使用付费云模型吗?
提供商或决策服务不可用时会怎样?
tryDecide() 在未配置决策提供商时返回 null。材料还说明内部路由、压缩和工具选择等优化会故障开放,并支持 providerFallback 回调及 modelChain;后两者针对 ModelAccessDeniedError 执行替代重试。能否把 decide 用作最终审批器?
RAG 数据必须发送到某个固定平台吗?
是否可以按请求切换凭据和模型?
NeuroLink 官网是什么?
NeuroLink 开源吗?
NeuroLink 安全吗?
NeuroLink 还在维护吗?
NeuroLink 是谁开发的?
谢谢反馈,我们会据此改进页面。