ai

一套代码，多模型接入，类型安全，前端框架通吃。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 386 🐛 待处理 70 👀 关注 7

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3338

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源 SDK，MIT 许可证，完全免费，无付费版本。

项目预览

项目数据

分类智能体

开发团队TanStack

官网地址https://tanstack.com/ai/latest

GitHubhttps://github.com/TanStack/ai

定价模式🏷️完全免费

价格说明开源 SDK，MIT 许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-agents,ai-sdk,anthropic,chatbot,function-calling,gemini,generative-ai,llm,multimodal,openai,react,solidjs,streaming,svelte,tanstack,tool-calling,typescript,typescript-sdk,vue

GitHub 星标★ 3338

上线时间2025-10-08 00:00:00

代码更新2026-11-07

仓库体积97.3 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

这是一个基于 TypeScript 的 AI 开发工具包，主打类型安全与供应商无关。它解决了开发者在对接不同大模型（如 OpenAI、Anthropic、Gemini）时面临的接口不一致、类型不安全、流式处理复杂等问题。核心能力包括：统一的流式聊天接口、函数/工具调用、智能体（Agent）支持、多模态应用开发，以及针对 React、Vue、Svelte、Solid 等主流前端框架的深度集成。通过抽象层，开发者可以用一套代码无缝切换底层模型，同时获得完整的 TypeScript 类型推导，减少运行时错误。项目处于成长阶段，社区活跃度不错。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3338

技术标签

ai ai-agents ai-sdk anthropic chatbot

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

Node.js 环境与包管理器（README 安装示例使用 pnpm）
一个已存在的 TypeScript / 前端工程，用于接入 SDK
选定的大模型提供商账号与 API Key（如 OpenAI、OpenRouter）
如需 React 聊天界面，需要一个 React 项目

安装与启动步骤

1安装核心包与适配器

安装核心包 @tanstack/ai 及你要用的提供商适配器，README 以 OpenAI 适配器为例。注意两者需要一起装。
```
pnpm add @tanstack/ai @tanstack/ai-openai
```
2装 React 聊天 UI（可选）

如果要做 React 聊天界面，README 给出的组合是核心包、客户端、React 绑定加提供商包，一次性安装。
```
pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
```
3改用 OpenRouter 接入

README 说明 OpenRouter 适合用一个 API Key 访问多家提供商，作为起步方案很合适，替换掉原来的提供商包即可。
```
pnpm add @tanstack/ai @tanstack/ai-openrouter
```
4按需增加功能包

README 提到可只导入 chat，也可按需加图像、音频、视频、语音、转录、摘要、实时、Code Mode、devtools 和框架绑定，缺什么装什么。
5查阅官方文档接代码

README 未给出调用示例，仅提供文档入口，请到官网按所用提供商和框架的章节编写实际调用代码。

关键配置

配置项	必填	说明	示例
`OPENROUTER_API_KEY`	否	OpenRouter 单一密钥，可访问多家模型（变量名以官方文档为准）	`sk-or-v1-xxxxxxxxxxxxxxxx`

如何确认成功

package.json 中出现 @tanstack/ai 依赖，代码里能正常 import；具体功能效果需按官方文档编写代码后验证。

常见问题

Q：到底该装哪个提供商包？

A：核心包 @tanstack/ai 必装，提供商包按需选择：用 OpenAI 装 @tanstack/ai-openai，想一个 Key 访问多家模型装 @tanstack/ai-openrouter。

Q：必须用 pnpm 吗？

A：README 只给出了 pnpm add 的示例命令，没有写其他包管理器，用别的包管理器请自行对照替换安装命令。

Q：React 项目要装哪些包？

A：README 给出的组合是 @tanstack/ai、@tanstack/ai-client、@tanstack/ai-react，再加一个提供商包如 @tanstack/ai-openai。

Q：安装完怎么真正用起来？

A：README 只提供安装命令和文档入口，没有代码示例，请打开 https://tanstack.com/ai 的文档按框架章节接入。

注意事项

README 未提供 API Key 的具体环境变量名、端口和完整调用示例，请以官网文档为准。
包是按功能拆分的，可以只装 chat 相关，再按需要追加图像、语音、实时等能力。
项目处于成长阶段，接口可能随版本变化，建议锁版本并关注 releases。

核心亮点

类型安全：全程 TypeScript 类型推导，减少模型返回数据的类型错误。
供应商无关：统一接口，轻松切换 OpenAI、Anthropic、Gemini 等模型。
前端集成好：原生支持 React、Vue、Svelte、Solid，降低 UI 接入成本。

不足之处

项目较新，生态和文档仍在完善中。
高级功能（如复杂 Agent 编排）可能不如成熟框架丰富。

适用场景

需要快速构建支持多模型切换的聊天机器人。
在 React/Vue 等前端项目中集成流式 AI 对话功能。
开发需要工具调用或 Agent 能力的复杂 AI 应用。

替代项目

Vercel AI SDK、LangChain.js、ModelFusion

上一篇：open-mercato

下一篇：runprompt

ai