본문으로 건너뛰기
인사이트
Field Notes

TanStack AI가 RC에 들어갔다: TypeScript 팀에 어떤 의미인가

TanStack AI가 2026년 8월 21일 릴리스 후보 단계에 들어갔다. 세 명의 유지관리자가 여가 시간에 만든 것, Vercel AI SDK와의 차이, 지금 써도 될 준비가 됐는지 살펴본다.

작성자 Adam Maguire Wilson읽기 9분
이 페이지에서

세 사람이 여가 시간에 지난 10개월을 써서 TypeScript용 완전한 AI 프레임워크를 만들었다. 2026년 8월 21일 그들은 릴리스 후보 단계라고 선언했다. 발표문을 읽기 전에 알아둘 게 하나 있다. 현재 npm의 @tanstack/ai 버전은 0.49.1이다. 그러니 여기서 “RC”는 semver 태그가 아니라 프로젝트 단계 이름이다. 아키텍처는 잠겼지만 버전 번호는 아직 따라오지 않았다. 어느 쪽도 문제는 아니다. 다만 둘을 동시에 알고 있어야 발표를 제대로 보정해서 읽을 수 있다.

핵심 요점 - TanStack 생태계의 오픈 소스 AI 프레임워크 TanStack AI는 2026년 8월 21일 릴리스 후보 단계에 들어갔다. 세 명의 유지관리자가 여가 시간에 만들었다. - 하나의 chat() 메서드가 공급자 채팅, 미디어 생성, MCP, 샌드박스, 에이전트 하네스를 다룬다. 전송 프로토콜은 AG-UI이고 핵심 판매점은 타입 안전성이다. - 패키지는 여전히 0.x이고, Vercel AI SDK는 주간 npm 다운로드에서 TanStack AI보다 약 70배 크다. RC는 “월요일에 갈아타라”가 아니라 “시험을 도와달라”는 뜻이다. - TypeScript로 AI 기능을 만든다면 이번 주에 작은 것 하나로 시험해볼 만하다.

이번 주 실제로 무슨 일이 있었나?

8월 21일 Alem Tuzlak, Jack Herrington, Tom Beckenham은 TanStack 블로그에서 RC 단계 진입을 발표했다. 프로젝트는 2025년 10월 네 개 공급자를 지원하는 단일 chat() 메서드로 시작했다. 지금은 AI 제품에 필요한 것 대부분을 다룬다. 채팅, 영속성, 미디어 생성, 임베딩, 메모리, MCP, 그리고 Codex, Claude Code 또는 다른 ACP 호환 코딩 에이전트를 원하는 UI에 연결해 돌릴 수 있는 샌드박스형 에이전트 하네스까지 포함한다.

몇몇 주장은 각주를 붙여 읽을 필요가 있다. “공급자 24개”라는 헤드라인은 여러 모달리티를 합산한 숫자다. 공식 비교 페이지는 LLM 어댑터 16개와 하네스 어댑터 5개를 적고 있다. 미디어 생성에서 말하는 “100개 이상 모델”도 대부분 fal을 통한 하나의 어댑터가 접근할 수 있는 카탈로그 범위다. 그리고 새 소식처럼 소개된 AG-UI 채택은 사실상 5월에 끝났다. 당시 팀은 사양에 대한 완전한 양방향 준수를 내놨다. 어느 것도 부정직한 주장은 아니다. 출시 글에서 흔히 생기는 자연스러운 부풀림이고, 다시 말하기 전에 공기를 조금 빼두면 된다.

가장 진짜처럼 들리는 문장은 글 끝부분에 있다. “우리에게는 상업 로드맵도, 추가 판매할 제품도, 숨겨진 의도도 없습니다.” 2026년 AI 도구 시장에서는 실제로 드문 말이다.

TanStack AI는 2026년 8월 21일 릴리스 후보 단계에 들어갔다. 하나의 채팅 메서드와 네 공급자로 시작한 프레임워크는 AG-UI를 공식 프로토콜로 쓰는 완전한 AI 스택으로 성장했고, 세 명이 공개적으로 개발하고 있다(TanStack 블로그).

왜 중요한가?

이 프레임워크가 들어가는 경쟁은 전혀 팽팽하지 않다. 바로 그 점이 흥미롭다. 기존 강자는 Vercel AI SDK다. Vercel은 월간 다운로드 4,000만 회 이상과 Fortune 500 도입을 이야기한다. 이번 주 npm 레지스트리에서 Vercel 패키지 ai는 주간 약 2,310만 다운로드였다. @tanstack/ai는 약 329,000이었다. 대략 70 대 1이다.

2026년 8월 주간 npm 다운로드 막대그래프. Vercel AI SDK는 주 2,310만 회, TanStack AI는 주 32만 9천 회로 약 70 대 1의 차이다.

2026년 8월 마지막 주의 주간 npm 다운로드를 실제 비율대로 그렸다. TanStack 막대가 3픽셀 높이인 게 오히려 핵심이다. 이쪽은 기존 강자가 아니라 도전자다.

그 격차에 대한 TanStack의 답은 10년 전 데이터 가져오기에서 했던 답과 같다. React Query는 헤드리스, 프레임워크 독립성, 타입 안전성, 특정 플랫폼에 묶이지 않는 설계로 이겼고, TanStack AI도 같은 패턴을 AI 배관에 적용한다. AI SDK가 독자적인 UI 메시지 형식을 스트리밍하는 반면, TanStack AI는 처음부터 끝까지 네이티브 AG-UI 이벤트를 내보낸다. 이미 20개가 넘는 에이전트 프레임워크가 쓰는 프로토콜이다. 그리고 비교 페이지는 칭찬할 만하게도 양쪽의 장단점을 모두 인정한다. 선택을 라이브러리 조합 문제와 풀스택 플랫폼 문제로 설명한 뒤 AI SDK가 더 잘하는 부분도 직접 나열한다. 이 경쟁에서 양쪽이 만든 “우리 대 그들” 페이지 중 가장 솔직한 축에 속한다.

Vercel AI SDK는 2026년 8월 말 주간 npm 다운로드에서 TanStack AI를 약 70 대 1로 앞선다(2,310만 대 329,000). TanStack의 반격은 아키텍처에 있다. 개방형 AG-UI 프로토콜, 프레임워크 독립 클라이언트, 종단 간 타입 안전성을 제공하고 특정 플랫폼을 강요하지 않는다.

TypeScript 팀에는 어떤 의미인가?

AI 채팅 통합에서 TypeScript 타입이 해석되는 개발자 에디터 화면.

내가 믿는 정도가 큰 순서대로 구체적인 세 가지가 있다.

첫째, 영속성이 하나의 프로젝트가 아니게 된다. 작은 저장소 인터페이스를 구현하고 팀의 적합성 테스트 모음에 돌린 다음 영속성 미들웨어에 넘기면 된다. 문서 예제는 약 20줄이고, 사용자는 스트리밍 도중 새로고침해도 이어서 받을 수 있다. 각주는 있다. 20줄 버전은 개발용 인메모리 스트림을 쓴다. 프로덕션에서 내구성 있는 재개 기능을 원하면 외부 Durable Streams 백엔드가 필요하다. 팀에 “20줄이면 된다”고 말하기 전에 그 비용은 예산에 넣자.

둘째, MCP에 타입이 붙는다. @tanstack/ai-mcp 패키지는 원격 MCP 서버를 검사해 도구용 TypeScript 타입을 생성하는 CLI를 제공한다. 잘못된 도구 호출이 새벽 2시에 터지는 대신 컴파일할 때 실패한다. MCP 서버를 손으로 연결해왔다면, 그리고 내 비즈니스용 MCP 메모를 보면 아직 그렇게 하는 팀이 많다면, 이것만으로도 오후 한 번 써볼 가치가 있다.

셋째, 에이전트 하네스가 벤더가 아니라 하나의 구성요소가 된다. 원하는 샌드박스에서 Codex나 Claude Code를 돌리고, 대화를 분기하고, 같은 프롬프트를 여러 번 병렬 시도하고, 모든 실행을 영속적으로 남길 수 있다. Daytona나 E2B를 누가 대신 골라주지 않는다. 하네스 개념이 낯설다면 내가 쓴 에이전트 아키텍처 실무자용 청사진에서 그 아래의 루프를 다뤘다. 중국 연구소를 보는 독자라면 OpenRouter 어댑터를 통해 Qwen, DeepSeek, Kimi를 같은 API에서 설정 한 줄 차이로 쓸 수 있다. 내가 중국 오픈 웨이트 생태계 현장 가이드에서 주장한 모델 비종속적인 접근과도 잘 맞는다.

TypeScript 팀에게 RC의 실용적인 장점은 대략 20줄 미들웨어로 만드는 영속성, 타입 생성 CLI를 통한 MCP 도구의 컴파일 시점 타입 안전성, Codex·Claude Code 같은 코딩 에이전트를 위한 공급자 비종속 샌드박스 하네스다.

지금 무엇을 해야 하나?

  1. 이번 주: 버려도 되는 작은 것에 설치해보자. pnpm add @tanstack/ai @tanstack/ai-openai를 실행하고 chat()을 서버 전송 이벤트 엔드포인트에 연결해, 지금 쓰는 구성과 비교했을 때 스트리밍과 타입이 어떻게 느껴지는지 보자.

  2. 이번 달: 다른 사람의 비교 글, 내 글까지 포함해서 읽기 전에 팀이 직접 작성한 Vercel AI SDK 비교를 먼저 읽자. AI SDK가 앞선 부분을 솔직하게 적어놓았기 때문에 TanStack AI를 내세우는 주장도 더 믿을 만해진다.

  3. 버그를 만나면: 이슈를 올리자. 저장소에는 열린 이슈 45개와 유지관리자 세 명이 있다. 실제로 거친 부분도 있다. 도구 호출 뒤 텍스트가 올 때 첫 텍스트 delta가 사라지는 문제, OpenAI Responses 도구 루프에서 간헐적으로 나는 400 오류 같은 것들이다. RC 피드백이 v1을 만든다.

다음은 하지 말자.

  • 이번 주에 프로덕션 AI SDK 애플리케이션을 마이그레이션하지 말자. 패키지가 0.x인 데는 이유가 있다.

  • “공급자 24개”를 문자 그대로 받아들이지 말자. 문서에는 LLM 어댑터 16개와 하네스 어댑터 5개가 있다. 더 큰 숫자는 모달리티를 합산한 것이다.

  • 아직 alpha라고 쓰고 공급자 네 개만 보여주는 tanstack.com/ai 랜딩 페이지를 믿지 말자. RC에 맞게 업데이트되지 않았을 뿐이다.

더 큰 그림

이번 릴리스 아래에 있는 이야기는 팀의 형태다. 세 명, 여가 시간, 가격 페이지 없음, RC 글이 나온 뒤 6일 동안 병합된 커밋 52개. 팔 게이트웨이가 있는 플랫폼 회사와 나란히 놓으면 오픈 소스의 낭만적인 버전이거나 실제 운영 위험이거나 둘 다다. TanStack의 npm 패키지도 2026년 5월 공급망 웜 공격에 영향을 받았다. 세 명짜리 운영 표면에 나쁜 한 주가 오면 어떤 모습인지 보여주는 사례다.

팀은 v1이 매우 가깝다고 말하고, 커밋 로그를 보면 빈말은 아닌 것 같다. 하지만 v1이 위 차트의 격차를 바꾸지는 않는다. 그 격차를 줄이는 일은 코드를 내는 것보다 훨씬 느리다. 당신에게 언제 준비됐는지는 발표 주기가 아니라 이슈 트래커를 보며 판단하자.

자주 묻는 질문

TanStack AI는 프로덕션에 쓸 준비가 됐나?

자체 설명으로도 아직 아니다. 릴리스 후보라는 말은 아키텍처가 잠겼고 v1 전에 거친 시험을 받고 싶다는 뜻이다. 패키지는 여전히 0.x이고 이슈 트래커에도 실제 거친 부분이 남아 있다. 사이드 프로젝트와 진지한 평가에는 준비됐지만 프로덕션 마이그레이션에는 아직 아니다.

TanStack AI는 React에서만 작동하나?

아니다. 코어 패키지는 프레임워크 독립적이고 React, Vue, Svelte, Angular, Preact용 퍼스트파티 클라이언트가 있으며 서버 전용 퀵스타트도 있다. 프레임워크 독립성은 Vercel AI SDK와 구별되는 핵심 중 하나다.

더 읽을거리

계속 읽기

Agent Field Notes

다음 호를 받아보세요

에이전트 하네스, 런타임, 보안, 거버넌스를 실제 운영 담당자를 위해 설명합니다.

이와 같은 결정을 앞두고 계신가요?

에이전트 시스템에 대한 중요한 결정을 내리는 팀을 위해 아키텍처 검토, 거버넌스 평가, 버전 고정 프레임워크 평가를 수행합니다.

저자 소개

Adam Maguire Wilson

창립자 겸 AI 에이전트 시스템 독립 자문가

adam.mw