Kiseki
Studio Setup

스튜디오 설정 가이드

스트리머용 Quick Start와 Developer Setup을 분리했습니다. 방송 전 점검부터 보안 가이드까지.

방송인 Quick Start

  1. 1

    계정 만들기

    이메일 또는 GitHub로 크리에이터 계정을 만듭니다.

  2. 2

    OBS 연결

    Live Runtime URL을 OBS Browser Source에 추가합니다.

  3. 3

    VTube Studio 연결

    VTS Public API를 켜고 방송 콘솔에서 연결합니다.

  4. 4

    VRM 아바타

    .vrm 파일을 업로드하거나 로컬 models 폴더에 넣습니다.

  5. 5

    채팅·AI·TTS

    방송 콘솔에서 채팅 반응·LLM·TTS를 설정합니다.

  6. 6

    방송 전 점검

    Studio Checklist에서 Bridge·OBS·VTS 상태를 확인합니다.

개발자 설정

  1. 1

    의존성 설치

    pnpm install 후 pnpm build로 패키지를 빌드합니다.

  2. 2

    환경 변수

    .env.example을 복사해 OBS·VTS·LLM(선택) 값을 채웁니다.

  3. 3

    스튜디오 실행

    scripts/start-kiseki.ps1 또는 dev:bridge/panel/runtime.

  4. 4

    Bridge API

    로컬 Bridge(127.0.0.1)를 기본으로 사용합니다.

OBS Browser Source URL

기본 URL (로컬은 http://127.0.0.1:5173)

https://kiseki-runtime.vercel.app/?overlay=1&tracking=0

Security Notes

  • service_role·API 키는 프론트에 노출하지 않음
  • 로컬 Bridge(127.0.0.1)를 기본으로 — 방송 PC에서 지연 최소화
  • 완전 AI 방송은 TTS·플랫폼 정책 확인 후 단계적 활성화

운영 가이드라인

  • 클라우드: Panel·Runtime(Vercel), Auth(Supabase) — 점검·온보딩용
  • 실제 방송은 PC에서 Kiseki를 실행하는 것을 권장합니다
스튜디오 가이드 | Kiseki