Chat SDK

🧠 Chat SDK란?
Chat SDK는 Next.js 14와 AI SDK를 기반으로 만든 오픈소스 챗봇 템플릿이야. 빠르게 강력한 챗봇 앱을 만들 수 있도록 도와주는 도구들이 포함돼 있어.

🚀 주요 기능
Next.js App Router

고급 라우팅 기능으로 빠르고 부드러운 페이지 전환

React Server Components와 Server Actions로 성능 향상

AI SDK

텍스트 생성, 구조화된 객체, 툴 호출 등을 위한 통합 API

동적인 챗 UI를 만들 수 있는 훅 제공

xAI, OpenAI, Fireworks 등 다양한 모델 지원

shadcn/ui

Tailwind CSS 기반의 스타일링

Radix UI 컴포넌트로 접근성과 유연성 확보

데이터 저장

Neon Serverless Postgres로 채팅 기록과 사용자 데이터 저장

Vercel Blob으로 파일 저장

Auth.js

간단하고 안전한 인증 기능 제공

🤖 모델 제공자
기본적으로 Vercel AI Gateway를 통해 여러 AI 모델에 접근해. 기본 설정은 xAI의 grok-2-vision-1212, grok-3-mini 모델을 사용하고 있어.

Vercel에 배포하면 인증은 자동 처리됨

Vercel 외 배포 시 .env.local 파일에 AI_GATEWAY_API_KEY 설정 필요

OpenAI, Anthropic, Cohere 등 다른 모델로 쉽게 전환 가능

# AI Gateway API 키 (Vercel 외 배포 시 필수)
AI_GATEWAY_API_KEY=your_ai_gateway_api_key_here

# 인증 관련 설정 (Auth.js 사용 시)
NEXTAUTH_SECRET=your_nextauth_secret_here
NEXTAUTH_URL=http://localhost:3000

# 데이터베이스 설정 (Neon 사용 시)
DATABASE_URL=your_neon_postgres_connection_url

# 파일 저장소 (Vercel Blob 사용 시)
BLOB_READ_WRITE_TOKEN=your_vercel_blob_token

p```


🧩 설치 및 로컬 실행 방법
Vercel CLI 설치

bash
npm i -g vercel
Vercel 및 GitHub 계정과 연결

bash
vercel link
환경 변수 다운로드

bash
vercel env pull
패키지 설치 및 실행

bash
pnpm install
pnpm dev
브라우저에서 확인 http://localhost:3000

⚠️ .env 파일은 절대 커밋하지 마세요. API 키와 인증 정보가 노출될 수 있어요.