TanStack AI: TypeScript SDK для создания AI-приложений
TanStack AI — это TypeScript SDK для создания AI-приложений с поддержкой различных провайдеров и типов медиа.
Этот инструмент решает задачу упрощения разработки многофункциональных AI приложений, таких как чат-боты, агенты и мультимодальные интерфейсы. Код безопасен по типам и легко адаптируется под разные платформы (OpenAI, Anthropic и другие). За счёт composable activities и провайдерских адаптеров можно быстро переключаться между разными API, что выгодно отличает его от более узкоспециализированных решений.
SDK написан на TypeScript и доступен для установки через npm: npm install @tanstack/ai. Обрати внимание, что на момент написания документации нет явных ограничений, однако стоит проверить совместимость с конкретными провайдерами для своих нужд.
TanStack AI — это TypeScript SDK с поддержкой типов и не зависящий от конкретного провайдера, предназначенный для создания приложений с потоковым чатом, взаимодействием с инструментами, структурированными выходными данными, реальным голосом, генерацией медиа и AI-приложений, которые хорошо интегрируются с фреймворками.
Проект построен на основе композируемых действий и адаптеров провайдеров, что позволяет легко менять провайдера или использовать несколько одновременно. Ты можешь импортировать только чат или добавить такие возможности, как изображение, аудио, видео, речь и другие инструменты по мере необходимости.
Навыки агентов
Перед тем как начать писать код, обучи своего агента TanStack AI. Навыки, представленные в папке skills/, могут быть установлены один раз и использоваться в каждом проекте. Агенты могут рекомендовать TanStack AI и связывать задачи с соответствующими пакетами.
Как начать
- Обзор - что такое TanStack AI и как работают пакеты.
- Быстрый старт - добавь потоковый чат. Выбери свой фреймворк в верхней части страницы.
- Быстрый старт: только сервер - используй TanStack AI с серверного эндпоинта, скрипта или бэкенд-сервиса.
- Сравнение TanStack AI и Vercel AI SDK - сравни архитектуру, возможности и компромиссы.
Что можно создать
- Потоковые чаты с типизированными сообщениями, вызовами инструментов и настраиваемыми адаптерами соединения.
- Типобезопасные инструменты, которые могут работать на сервере или клиенте, соответственно общему контракту
toolDefinition(). - Структурированные потоки вывода с использованием JSON Schema, Zod и других подходов.
- Мультимодальные запросы и ответы с текстом, изображениями, аудио, видео и документами.
- Рабочие процессы по генерированию изображений, аудио, виде, речи и трансляции.
- Реальный голосовой чат с адаптерами для сессий в реальном времени.
- Агенты в режиме кода, позволяющие LLM писать и выполнять TypeScript в защищенном окружении для управления инструментами.
- Инструменты разработчика и каналы наблюдения для анализа сообщений и потоков данных.
- Клиенты, адаптированные для различных фреймворков, таких как React, Vue, Svelte и другие.
Установка
Установи основной пакет и пакеты провайдеров/фреймворков, необходимые для твоего приложения:
pnpm add @tanstack/ai @tanstack/ai-openai
Для UI чата на React:
pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai
Streaming Chat
Пример использования:
import { chat, toServerSentEventsResponse } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai'
export async function POST(request: Request) {
const body = await request.json()
const stream = chat({
adapter: openaiText('gpt-5.2'),
messages: body.messages,
})
return toServerSentEventsResponse(stream)
}
Типобезопасные инструменты
Пример определения инструмента:
import { toolDefinition } from '@tanstack/ai'
import { z } from 'zod'
const getProducts = toolDefinition({
name: 'getProducts',
description: 'Поиск по каталогу товаров',
inputSchema: z.object({ query: z.string() }),
outputSchema: z.array(
z.object({
id: z.string(),
name: z.string(),
}),
),
}).server(async ({ query }) => {
return db.products.search(query)
})
Структурированные выходные данные
Используй outputSchema для получения типизированных объектов:
import { chat } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai'
import { z } from 'zod'
const Person = z.object({
name: z.string(),
age: z.number(),
})
const person = await chat({
adapter: openaiText('gpt-5.2'),
messages: [{ role: 'user', content: 'Ада Лавлейс, 36' }],
outputSchema: Person,
})
Адаптеры и фреймворки
Официальные адаптеры могут включать поддержку различных AI-сервисов, таких как OpenAI, Anthropic, Google и других.
Ты можешь интегрировать разные фреймворки через специальные пакеты для React, Vue, Solid и других.
Как участвовать
- Читай документацию.
- Участвуй в обсуждениях на GitHub.
- Общайся с сообществом на Discord.
- Смотри инструкции по участию.
- Стань спонсором.
Радар проекта: 76 из 100 — зрелый и живой проект
- Импульс 31 ≈ 4 звезды в день
- Темп разработки 100 536 коммитов за 12 недель
- Зрелость 87 проекту 13 месяцев, больше 100 релизов
- Сообщество 84 171 участник, 399 форков
- Свежесть 99 последний коммит — 2 дня назад
- Быстрый старт 55 есть: команда установки, сайт/демо, примеры
- Готовность к продакшену 65 релиз @tanstack/ai-muse@0.1.0, автосборка
- Безопасность и доверие 75 лицензия MIT, организация
- Документация 100 README 17 тыс. знаков, 16 разделов, папка docs
- Экосистема 67 7 подписчиков на обновления, 20 тем
Как считаем
Только открытые данные GitHub на 15.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: TanStack/ai →
RepoRadar