TanStack AI: TypeScript SDK для создания AI-приложений

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 и связывать задачи с соответствующими пакетами.

Как начать

Что можно создать

  • Потоковые чаты с типизированными сообщениями, вызовами инструментов и настраиваемыми адаптерами соединения.
  • Типобезопасные инструменты, которые могут работать на сервере или клиенте, соответственно общему контракту 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 и других.

Как участвовать

Радар проекта: 76 из 100 — зрелый и живой проект

ИмпульсТемпЗрелостьСообществоСвежестьСтартПродакшенДовериеДокументацияЭкосистема76
  • Импульс 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 →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться

Похожие статьи

Популярные темы на сайте