HKUSTDial/DataMagic

AI-powered data-to-video generation. Upload a table, get a narrated animated data story.

📚 DataMagic이란 무엇인가요?

DataMagic은 표 데이터(CSV, Excel 등)를 짧은 애니메이션 비디오 스토리로 변환할 수 있는 오픈 소스 툴킷입니다. 139개의 '레시피 카드' 라이브러리가 함께 제공되며, 각 카드는 특정 시각 효과(예: 순위 공개, 지도 기반 비교, 캐릭터 중심의 설명 등)를 설명하고 다음을 제공합니다.

애니메이션 미리보기
효과를 생성하는 선언적 소스 코드
샘플 데이터

datamagic Skill(프롬프트 및 도우미 스크립트 세트)을 사용하면 프로그래밍 에이전트(예: LLM 기반 코드 어시스턴트)가 자동으로 다음을 수행할 수 있습니다.

데이터에 적합한 레시피 선택
템플릿에 고유한 숫자, 레이블, 색상 및 에셋 주입
비디오 렌더링
출력 결과 검증

이 프로젝트는 두 편의 동료 심사 논문(IEEE VIS 2026 및 VLDB 2026 Demo)과 스프레드시트를 업로드하여 몇 초 만에 완성된 비디오를 얻을 수 있는 온라인 데모 사이트를 통해 지원됩니다.

🛠️ 핵심 구성 요소

구성 요소	기능	위치
레시피 카드 (Recipe cards)	시각적 내러티브의 선언적 사양(애니메이션 타임라인, 차트 유형, 내레이션 큐).	`cards/recipes/` 및 웹 갤러리 https://datamagic.chat/cards/
템플릿 소스 코드	CSV를 읽고 필드를 시각적 요소에 매핑하며 렌더링 엔진을 구동하는 재사용 가능한 스크립트(Python/JS).	각 카드에서 링크; `cards/`에도 존재
datamagic Skill	코드 생성 에이전트가 올바른 템플릿을 찾고, 데이터를 대체하며, 렌더러를 실행할 수 있게 하는 프롬프트 라이브러리 + 소형 유틸리티.	`skills/datamagic/`
온라인 시스템	전체 파이프라인(데이터 업로드 → 레시피 추천 → 비디오 생성)을 조정하는 호스팅 서비스.	https://datamagic.chat/
연구 문서	기본 파이프라인(DVSpec)에 대한 설명, 평가 및 인용 정보.	`docs/`

🚀 사용 방법 (빠른 시작)

리포지토리 복제

git clone https://github.com/HKUSTDial/DataMagic.git
cd DataMagic

레시피 선택 – 웹 갤러리 또는 로컬 cards/recipes/ 폴더를 탐색합니다. Copy implementation command를 클릭하여 한 줄짜리 명령어를 가져옵니다.
에이전트 실행 – 명령어를 즐겨 사용하는 LLM 기반 코딩 어시스턴트(예: 함수 호출 기능이 있는 OpenAI ChatGPT, Claude 또는 로컬 호스팅 모델)에 붙여넣습니다. CSV와 사용자 지정 스타일 메모를 제공합니다.
렌더링 – 스킬이 템플릿을 찾고, 데이터를 주입하며, 렌더링 백엔드를 호출하여 MP4와 편집된 소스 파일을 출력합니다.
반복 수정 – 에이전트에게 타이밍, 색상, 자막 조정이나 에셋 교체를 요청하세요. 워크플로우는 완전히 반복 가능합니다.

72초 분량의 데모(커피숍 매출)는 검색 → 레시피 → 명령어 → 비디오 생성으로 이어지는 전체 루프를 보여줍니다.

🎯 누가 사용해야 하나요?

대상	중요성
콘텐츠 크리에이터 / 소셜 미디어 관리자	애니메이션 소프트웨어를 배우지 않고도 눈길을 끄는 데이터 비디오를 제작할 수 있습니다.
데이터 분석가 / 연구원	정적 표를 프레젠테이션이나 논문에서 공유할 수 있는 내러티브 시각화로 변환할 수 있습니다.
AI/ML 개발자	선언적 다중 에이전트 오케스트레이션의 예시로, LLM이 코드를 생성하고 실행하는 구체적인 사용 사례입니다.
교육자	통계, 경제, 지리를 애니메이션 스토리텔링으로 가르치기 위한 기성 템플릿입니다.

📖 문서 및 커뮤니티

웹 갤러리 및 라이브 에디터 – https://datamagic.chat/cards/ (미리보기, 편집, 소스 다운로드).
스킬 가이드 – skills/datamagic/README.md (설치, 프롬프트 형식, 문제 해결).
전체 스토리 워크플로우 – skills/datamagic/rules/full-story-workflow.md (여러 카드를 결합하여 일관된 내러티브 구성).
연구 논문 – README의 IEEE VIS 2026 및 VLDB 2026 링크.
커뮤니티 – WeChat 그룹(리포지토리 내 QR 코드)에서 창작물을 공유하고 지원을 받을 수 있습니다.

⭐️ 빠른 요약

DataMagic은 선언적 레시피 카드와 LLM 기반 코드 오케스트레이션을 통해 데이터 분석과 비디오 제작을 연결하는 연구 기반의 실제 플랫폼입니다. 데이터 기반 비디오 스토리 생성을 자동화하려는 모든 사람에게 유용하며, 리포지토리에는 시작하는 데 필요한 모든 템플릿, 에이전트 스킬 프롬프트 및 문서가 제공됩니다.