- 社区热度
- 3.0k Stars
- GitHub 收藏
- 最近活跃
- 2026/8/22
- 近 30 天还在更新
- 授权协议
- MIT
- 宽松协议
为什么值得关注
不是看 Star 排名,而是看它解决了什么问题、实际有没有用,以及方法为什么值得关注。
解决的问题
解决了在 TypeScript 项目中统一调用多家中大型 AI 供应商、处理复杂流式对话、工具调用及多模态数据时缺乏类型安全和框架原生集成的问题。
实际价值
提供了模块化的架构设计,支持 React、Vue、Svelte 等主流前端框架,以及结构化输出、多模态媒体生成和开发调试工具,实际开发效率高。
创新 / 差异化
引入了基于同一契约的客户端/服务端共享工具定义,以及允许大模型在安全隔离区编写和执行 TypeScript 的 Code Mode 机制。
扩展潜力
通过适配器模式解耦了具体的 AI 供应商,开发者可以较低成本在 OpenAI、Anthropic、Gemini 或 OpenRouter 之间切换底层模型。
为什么是现在
在 AI 应用开发从简单 API 封装向复杂智能体及多模态交互演进的阶段推出,顺应了前端社区对强类型和框架原生支持的需求。
社区活跃度
近 90 天新增 114 个 Issue、434 个 PR;窗口内抽取的 Issue/PR 样本中有 34 位 Issue 发起者、20 位 PR 贡献者,并发布 至少 50 个版本。
维护者响应
窗口内 100 个 Issue 样本关闭率 75%,100 个 PR 样本合并率 89%。维护者响应统计覆盖该 Issue 样本的 66%,响应率 0%,首次响应中位数 暂无样本。
核心亮点
- 支持流式对话与实时语音交互
- 基于 Zod/JSON Schema 的结构化输出
- 统一的工具调用定义与类型安全契约
快速开始
安装方式、上手难度、开始步骤。
装在哪
本地运行
难不难
中等,需要一点配置
- 01使用包管理器安装核心库及所需的模型适配器。
- 02在后端定义聊天接口,配置模型适配器并处理流式响应。
- 03在前端使用框架对应的 Hook(如 useChat)集成 AI 功能。
更适合谁
- 希望数据放在自己服务器上的团队
- 想在本机直接跑起来试用的开发者
- 习惯用 Docker 部署的人
更多介绍
TanStack AI 是一个面向 TypeScript 的类型安全 AI 工具库,能够通过解耦的模块与服务商适配器,帮助开发者处理流式对话、工具调用、结构化输出及多模态交互。它支持 React、Vue、Svelte、Solid 等主流前端框架,同时也适用于纯后端运行环境。
该项目提供了统一的 API 契约,支持定义类型安全的客户端与服务端工具、处理多媒体生成、管理实时语音及构建沙箱代码执行代理。开发者可以按需引入聊天、语音、摘要或调试面板等对应模块,灵活接入各大主流模型服务。
信息来源
每条信息都标注了状态与出处,可展开查看。
15 条 · 展开
信息来源
每条信息都标注了状态与出处,可展开查看。
capability tags
已核验ai_coding、automation、productivity
来源: admin_cms · cms editor · 2026/8/22
editor note
已核验{"en":"The project offers high flexibility through a modular adapter system, allowing developers to import only necessary features to minimize bundle size. Its core strength lies in strong type support for tool calling and structured outputs, ideal for AI apps with complex interaction logic.","zh":"该项目通过模块化的适配器系统实现了极高的灵活性,开发者可以按需引入特定功能以减小包体积。其核心优势在于对工具调用(Tool Calling)和结构化输出的强类型支持,非常适合需要复杂交互逻辑的 AI 应用。"}
来源: admin_cms · cms editor · 2026/8/22
how to use
已核验{"steps":[{"en":"Install the core package and your preferred model adapter using a package manager.","zh":"使用包管理器安装核心库及所需的模型适配器。"},{"en":"Define the chat endpoint in your backend, configure the model adapter, and handle the streaming response.","zh":"在后端定义聊天接口,配置模型适配器并处理流式响应。"},{"en":"Integrate AI features in your frontend using framework-specific hooks like useChat.","zh":"在前端使用框架对应的 Hook(如 useChat)集成 AI 功能。"}],"installAt":"local","difficulty":"medium"}
来源: admin_cms · cms editor · 2026/8/22
intro
已核验{"en":"TanStack AI is a type-safe TypeScript library designed for building streaming chat, tool-calling agents, structured outputs, and multimodal applications across various frontend frameworks and backend environments. It provides a modular architecture with provider adapters, allowing developers to integrate different AI services while maintaining strict type safety.\n\nThe SDK supports framework-native bindings for React, Vue, Svelte, and Solid, alongside server-side usage. Features include shared tool definitions for client and server execution, structured data parsing, media generation workflows, realtime voice sessions, and dedicated developer tooling for telemetry inspection.","zh":"TanStack AI 是一个面向 TypeScript 的类型安全 AI 工具库,能够通过解耦的模块与服务商适配器,帮助开发者处理流式对话、工具调用、结构化输出及多模态交互。它支持 React、Vue、Svelte、Solid 等主流前端框架,同时也适用于纯后端运行环境。\n\n该项目提供了统一的 API 契约,支持定义类型安全的客户端与服务端工具、处理多媒体生成、管理实时语音及构建沙箱代码执行代理。开发者可以按需引入聊天、语音、摘要或调试面板等对应模块,灵活接入各大主流模型服务。"}
来源: admin_cms · cms editor · 2026/8/22
最新版本
已核验@tanstack/ai-fal@0.12.1
来源: GitHub 官方接口 · latest_release=@tanstack/ai-fal@0.12.1 · 2026/8/22
许可证
已核验MIT
来源: GitHub 官方接口 · license.spdx_id=MIT · 2026/8/22
needs api key
已核验是
来源: admin_cms · cms editor · 2026/8/22
一句话用途
已核验{"en":"A type-safe, provider-agnostic TypeScript AI SDK for building streaming chat, tool-calling agents, and multimodal applications with native framework support.","zh":"一个类型安全且与提供商无关的 TypeScript AI 开发框架,支持流式对话、工具调用、多模态应用及主流前端框架集成。"}
来源: admin_cms · cms editor · 2026/8/22
平台
已核验browser、macos、windows、linux
来源: admin_cms · cms editor · 2026/8/22
分类线索
根据材料推断ai-apps
来源: 项目说明文档 · hint=ai-apps · 2026/8/15
product forms
已核验library_framework
来源: admin_cms · cms editor · 2026/8/22
role tags
已核验frontend、backend、fullstack
来源: admin_cms · cms editor · 2026/8/22
supports docker
已核验是
来源: 仓库文件 · dockerfile=true; compose=false · 2026/8/22
supports local
已核验是
来源: admin_cms · cms editor · 2026/8/22
supports self host
已核验是
来源: admin_cms · cms editor · 2026/8/22
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
spec-kit
一套遵循「规范驱动开发」流程的开源 CLI 工具包,配合 AI 编程 Agent 按照规范生成与执行代码。
ai
由 Next.js 团队开发的 TypeScript AI 工具包,用于连接主流模型服务商并构建大模型应用与智能体。
CLI-Anything
为现有软件生成和管理 Agent 可调用 CLI 的工具集,包含 CLI-Hub、生成流程与 SKILL/插件接入方式。
claude-code
运行在终端中的 Agent 编程工具,可理解代码库、执行日常开发任务、解释代码并处理 Git 工作流。
codex
运行在本机的 OpenAI 编程 Agent,可通过终端使用,也提供 IDE 和桌面应用入口。
codebase-memory-mcp
高性能代码库知识图谱 MCP 服务器,通过本地持久化索引实现毫秒级代码结构查询与分析。
