Agions/dramaxis

🎬 Dramaxis (剧枢) — 电影级多智能体影视叙事与智能解说平台 (Tauri 2 + Rust + React 19)。6 大智能体协同导演、5 轨毫秒级对齐时间轴、四道质量闸门硬核质检、本地优先沙箱架构与剪映草稿深度互通。

🎬 Dramaxis란?

Dramaxis（剧枢）는 크리에이터가 원본 비디오 푸티지를 정교한 AI 생성 단편 영화 또는 해설 비디오로 변환하는 데 도움이 되는 오픈 소스 데스크톱 애플리케이션입니다. Rust 네이티브 멀티 에이전트 엔진과 Tauri 기반 데스크톱 셸, 그리고 React 19 프런트엔드를 결합합니다. 이 시스템은 여러 전문 AI 에이전트(디렉터, 시각 분석가, 시나리오 작가, 음성 아티스트, 사운드 엔지니어, 품질 검토자)를 오케스트레이션하여 다음을 수행합니다:

비디오 프레임을 분석하고 주요 순간을 추출합니다.
짧고 훅에 초점을 맞춘 대본을 작성합니다.
음성 해설을 생성하거나 복제합니다.
오디오-비디오 트랙을 밀리초 단위로 정렬합니다.
최종 편집 및 다중 플랫폼 게시를 위한 기본 CapCut "초안" 프로젝트를 내보냅니다.

이 도구는 마이크로 드라마, 영화 스타일 해설, 하이라이트 릴 및 기타 숏폼 비디오 콘텐츠 제작자를 대상으로 합니다.

🛠️ 핵심 구성 요소

구성 요소	역할	주요 기술
Rust 네이티브 멀티 에이전트 엔진	워크플로를 구동하고, 작업을 예약하며, AI 에이전트를 실행합니다.	Rust 1.85+, Cargo 워크스페이스
에이전트	전문 AI 작업자:

DirectorAgent – 전체 계획 및 사용자 상호 작용
VisualCriticAgent – FFmpeg 기반 프레임 분석
ScreenwriterAgent – 0~3초 훅 및 1인칭 독백 생성, 완료율을 위한 자기 반성 루프 포함
VoiceArtistAgent – 음성 스타일 선택, 제로샷 복제(Edge-TTS / GPT-SoVITS) 수행
SoundEngineerAgent – 5트랙 밀리초 수준 정렬, BGM 스마트 회피
QualityReviewerAgent – 타이밍, 욕설, 초안 무결성 확인 | src-tauri/crates/agent 아래의 Rust 크레이트 | | Tauri 2 데스크톱 셸 | macOS/Windows/Linux용 애플리케이션을 패키징하고 프런트엔드와 Rust 백엔드 간의 네이티브 IPC를 제공합니다. | Tauri 2, Rust | | React 19 프런트엔드 | 3개 창 "통합 시네마 스튜디오" UI와 4개의 "워크숍": 자산 허브, 대본 스튜디오, 작업 공간, 내보내기 허브. | React 19, TypeScript 5.8 | | LLM 및 TTS 통합 | 11개 LLM 공급자(OpenAI, Claude, Gemini, Qwen, DeepSeek 등) 및 여러 TTS/음성 복제 서비스(Edge-TTS, GPT-SoVITS, 로컬 Ollama 모델)에 연결합니다. | HTTP 클라이언트, SDK 래퍼 | | 내보내기 계층 | CapCut/剪映과 호환되는 .draft 파일을 생성하여 최종 편집기로 원활하게 전달합니다. | Rust export 크레이트 |

🚀 작동 방식 (일반적인 워크플로)

가져오기 및 자산 허브 – 사용자가 긴 비디오를 드롭하면 VisualCriticAgent가 장면, 키 프레임 및 감정 히트맵을 추출합니다.
대본 스튜디오 – ScreenwriterAgent가 3초 훅과 1인칭 내레이션을 초안 작성한 다음 VoiceArtistAgent가 선택한 음성을 복제하여 오디오를 생성합니다.
작업 공간 – SoundEngineerAgent가 생성된 음성, 배경 음악 및 원본 오디오를 18ms 미만의 드리프트로 5트랙 타임라인에 정렬합니다. QualityReviewerAgent가 초안을 검증합니다.
내보내기 허브 – 최종 프로젝트가 CapCut .draft로 내보내지고 내장된 중복 콘텐츠 감지 기능을 사용하여 8개의 사전 구성된 숏폼 비디오 플랫폼(抖音, 快手, TikTok, YouTube 등)으로 푸시할 수 있습니다.

📦 시작하기

# 리포지토리 복제
https://github.com/Agions/dramaxis.git
cd dramaxis

# 프런트엔드 종속성 설치 (pnpm 필요)
pnpm install

# 개발 모드에서 데스크톱 앱 실행
pnpm tauri dev

# 테스트 스위트 실행
cargo test --manifest-path src-tauri/Cargo.toml --all
pnpm test

macOS 팁 – 앱이 "손상됨"으로 차단되면 격리 플래그를 지우세요:
sudo xattr -rd com.apple.quarantine /Applications/Dramaxis.app

📚 문서 및 라이선스

전체 문서는 docs/ 폴더에 있으며 VitePress를 통해 제공됩니다.
프로젝트는 MIT 라이선스로 공개됩니다.

🎯 누가 사용해야 하나요?

숏폼 비디오 제작자 – AI 지원 대본 작성, 음성 해설 생성 및 정밀 편집을 원하는 분.
소셜 미디어 관리자 – 내장된 중복 콘텐츠 검사로 다중 플랫폼 게시를 자동화하려는 분.
개발자 – 멀티모달 미디어 파이프라인을 위한 Rust 중심 멀티 에이전트 아키텍처에 관심이 있는 분.

🌐 링크

릴리스: https://github.com/Agions/dramaxis/releases
프로젝트 웹사이트 / 문서: (docs/에서 VitePress를 통해 제공)
라이선스: MIT (LICENSE 참조)