YoloCut

새로운 종류의 비디오 편집기

YoloCut은 사람과 Agent가 동일한 실제 프로젝트에서 작업하는 로컬 우선 데스크톱 편집기입니다. 타임라인에서 클립을 트리밍하고 배열하거나, 내장 Agent, Codex, Claude Code, Gemini CLI, Cursor 또는 다른 MCP 클라이언트에게 동일한 편집 명령을 사용하도록 요청하세요.

이것은 불투명한 결과를 반환하는 일회성 비디오 생성기가 아닙니다. Agent 작업은 일반 미디어, 트랙, 클립, 캡션, 전환, 효과, 키프레임 및 내보내기 작업이 됩니다. 미리 보고, 제안된 변경 사항을 검토하고, 적용하거나 거부하고, 실행 취소하고, 손으로 계속 편집할 수 있습니다.

Media + script + editing goal
        ↓
Agent creates a reviewable edit session
        ↓
Real timeline changes → preview → refine → export

Related MCP server: Cutible MCP Server

YoloCut을 선택하는 이유

제품 둘러보기

위의 모든 스크린샷은 현재 YoloCut v0.0.2 데스크톱 애플리케이션에서 캡처되었습니다.

v0.0.2에서 사용 가능한 기능

설계상 Agent 네이티브

분리 가능한 Agent 작업 공간은 장식용 채팅 사이드바가 아닌 제어 표면입니다:

• 수동 UI와 프로젝트 상태 및 편집 명령을 공유합니다.

• 왼쪽이나 오른쪽에 도킹하거나, 별도의 넓은 데스크톱 창으로 열거나, 모서리 도킹을 통해 편집기로 돌아올 수 있습니다.

• 변경 작업은 적용된 것으로 간주되기 전에 검토를 위해 편집 세션에 스테이징됩니다.

• 내장 Agent와 외부 MCP 클라이언트는 동일한 표준 119-도구 카탈로그를 사용합니다.

• 프로젝트가 열려 있지 않으면 YoloCut은 더 작은 서버 직접 표면만 노출하고 제한 사항을 정직하게 보고합니다.

외부 Agent 연결

YoloCut Agent Skill 설치:

npx skills add Hhz0823/YoloCut --skill yolocut

YoloCut을 시작하고 대상 프로젝트를 연 다음 **Agent 연결 센터(MCP)**를 열고 라이브 URL과 Bearer 토큰을 복사하세요. 기본 엔드포인트는 다음과 같습니다:

http://localhost:5199/api/external-mcp/mcp

데스크톱 애플리케이션은 5199가 사용 중일 때 다른 루프백 포트를 선택할 수 있으므로, 클라이언트는 기본값을 영구적으로 하드코딩하지 말고 연결 센터에 표시된 주소를 사용해야 합니다.

필수 완료 흐름:

yolocut_status → get_connection_manifest → list_projects → target_project
→ load_skill / ToolSearch → begin_edit_session → editing tools
→ review_edit_session → get_edit_session (status=applied)

Agent는 전체 편집이 준비되고, 기능 범위가 완전하며, 최종 편집 세션이 applied된 경우에만 완료를 보고해야 합니다. Codex, Claude Code, Gemini CLI, Cursor 및 일반 Streamable HTTP 클라이언트에 대한 구성 예제는 YOLOCUT_AGENT_CONNECTION.md에 있습니다.

일괄 자동 편집

YoloCut에 미디어 디렉터리, 편집 스크립트, 내레이션 스크립트 및 선택적 참조 비디오를 제공하세요. 영구 큐는 최대 10,000개 작업을 수용하며, 수천 개의 비디오를 하나의 타임라인에 배치하는 대신 각 출력에 별도의 프로젝트와 수명 주기를 사용합니다.

1. 승인된 로컬 미디어 디렉터리를 스캔합니다.

2. 편집 스크립트, 내레이션 스크립트 및 선택적 참조 컷을 첨부합니다.

3. 리듬, 샷 구조, 캡션, 전환 및 색상 의도를 분석합니다.

4. Agent가 하드웨어 인지 동시성으로 검토 가능한 편집을 만들도록 합니다.

5. 작업별로 렌더링, 품질 검사 및 성공, 실패 또는 취소 상태를 읽습니다.

선택적 로컬 참조 분석은 llama.cpp와 함께 Apache-2.0 SmolVLM2-500M-Video-Instruct-GGUF 패키지를 사용합니다. 누락된 모델이나 런타임은 명시적으로 실패합니다. YoloCut은 분석 결과를 조작하지 않습니다.

보급형 머신에서의 긴 4K 프로젝트

YoloCut은 대화형 프록시 경로를 최종 품질 미디어와 분리합니다. 분석 및 미리보기는 더 작은 파생 파일을 사용할 수 있는 반면, 최종 내보내기는 원본 파일을 읽습니다.

• NVIDIA 시스템은 실시간 기능 프로브 후 NVDEC → scale_cuda → NVENC를 선호합니다.

• H.264 라우팅은 NVENC, Intel QSV, AMD AMF를 프로브한 다음 소프트웨어 libx264를 사용합니다.

• AV1, VP9 및 지원되지 않는 하드웨어 경로는 libaom-av1 및 libvpx와 같은 FFmpeg 소프트웨어 디코더로 폴백할 수 있습니다.

• CPU, 메모리, VRAM, 코덱 지원 및 활성 워크로드가 프록시 크기와 큐 동시성을 결정합니다.

• 런타임 결과는 실제로 사용된 백엔드와 폴백 이유를 보여줍니다. 모델 또는 GPU 이름만으로는 증거로 간주되지 않습니다.

Fish S2 모델 가중치는 Fish Audio Research License를 사용합니다. 상업적 사용에는 별도의 서면 허가가 필요합니다. 하드웨어 등급은 보수적 정책 계약이며, 모든 드라이버와 머신에 대한 성능 보장이 아닙니다.

더 빠른 데스크톱 시작

YoloCut v0.0.2는 이제 완전한 편집 스택에서 첫 번째 창을 차단하는 대신 데스크톱 시작을 단계화합니다:

• Electron은 임베디드 애플리케이션 서버를 로드하기 전에 가벼운 네이티브 시작 셸을 표시합니다.

• 서버는 병렬로 시작되고, GPU 검색은 편집기가 사용 가능해진 후 비동기적으로 계속됩니다.

• 모델, 썸네일, 업데이터 확인 및 패키징된 렌더 런타임은 관련 기능이나 시작 후 창이 필요할 때까지 지연됩니다.

• 렌더러 표면과 대시보드 대화상자는 지연 경계 뒤에 유지되어 전체 편집기 그래프가 초기 대시보드 로드에 포함되지 않습니다.

• 데스크톱 스모크 테스트는 고유한 임시 프로필과 데이터 디렉터리를 사용하여 테스트가 사용자의 프로젝트, 자격 증명, 미디어 또는 실행 중인 YoloCut 프로세스에 접근하지 못하도록 합니다.

Windows 릴리스 검증 머신에서 압축 해제된 빌드는 약 85 ms 만에 기본 셸을 표시했고, 약 0.72 s 만에 내장 서버를 띄웠으며, 콜드 실행 시 첫 렌더러를 약 2.79 s 만에 로드했습니다. 워밍된 렌더러는 약 0.51 s 만에 로드되었습니다. 이는 단일 머신에서 측정한 진단 수치일 뿐, 기기 간 보장 수치는 아닙니다. 다른 시스템에서 단계별 타이밍을 확인하려면 데스크톱 빌드 실행 시 YOLOCUT_STARTUP_TRACE=1을 설정하세요.

다운로드

GitHub Release 자산에는 의도적으로 직접 설치 가능한 Windows .exe 및 macOS .dmg 파일만 포함되어 있습니다. 설치 프로그램 SHA-256 값은 별도 자산으로 첨부하는 대신 릴리스 노트에 기재되어 있습니다. Windows 패키지는 현재 서명되지 않았으며, macOS 패키지는 임시 서명(ad-hoc signed)되었지만 공증(notarization)되지는 않았습니다.

Linux는 CI에서 계속 빌드 및 스모크 테스트되지만 GitHub Releases에는 첨부되지 않습니다. Linux 사용자는 아래 지침에 따라 소스에서 YoloCut을 실행할 수 있습니다. 패키지 빌드는 앱 내 버전 확인을 사용하며, 업데이트가 있으면 수동 설치를 위해 GitHub Release 페이지를 엽니다.

소스에서 실행

Node.js >=24 <25 및 npm이 필요합니다.

git clone https://github.com/Hhz0823/YoloCut.git
cd YoloCut
npm install
cp .env.example .env.local
npm run dev

데스크톱 개발 및 Windows 패키징:

npm run desktop:dev
npm run desktop:dist:win

개발 프로필은 Git 체크아웃/워크트리별로 프로젝트, 미디어, 자격 증명, 작업 및 설정을 격리합니다. 실제로 사용하려는 AI 또는 미디어 제공자만 구성하세요.

데이터 및 보안

• 프로젝트, 채팅, 버전, 인덱스 및 설정은 기본적으로 ~/.yolocut 아래에 로컬로 저장됩니다.

• 기존 레거시 데이터 루트는 마이그레이션 계층에서 마운트할 수 있으므로 사용자가 이전 프로젝트를 잃지 않습니다.

• 제공자 키는 서비스 측에 유지되며 VITE_ 브라우저 변수를 통해 노출되지 않습니다.

• MCP는 기본적으로 루프백에 바인딩되며 생성된 Bearer 토큰이 필요합니다.

• 디렉터리 액세스는 불투명 권한(opaque grants)을 사용하며, 절대 로컬 경로는 데스크톱 IPC 경계를 넘어 Agent 도구로 전달되지 않습니다.

• AI 트래픽은 사용자가 명시적으로 구성한 제공자에 대해서만 컴퓨터를 벗어납니다.

• YoloCut은 단일 사용자 데스크톱 워크플로우를 대상으로 하며, 격리되지 않은 다중 테넌트 서버 배포를 대상으로 하지 않습니다.

아키텍처 및 검증

npm test                         # full regression suite
npm run build                    # type checking and production build
npm run lint                     # static analysis
npm run verify:architecture      # enforced dependency boundaries
npm run verify:mcp               # Agent/MCP contract checks
npm run verify:media-performance # codecs, proxies, acceleration, fallbacks
npm run verify:auto-edit         # batch auto-edit contracts
npm run desktop:smoke             # embedded server and desktop bridge
npm run desktop:smoke:render      # real packaged rendering path
npm run desktop:smoke:post-startup # deferred startup work
npm run desktop:smoke:agent-window

현재 릴리스 경계

YoloCut 0.0.2는 초기 공개 릴리스입니다. 핵심 편집, Agent, MCP, 배치, 데스크톱 패키징 및 로컬 모델 관리는 적극적으로 검증되지만, 여러 영역은 여전히 실험적입니다:

• Fish S2, SmolVLM2 및 일부 GPU 경로는 로컬 런타임과 드라이버에 의존합니다.

• 프로젝트 형식과 Agent 카탈로그는 계속 발전할 예정이므로, 업그레이드 전에 중요한 프로젝트를 백업하세요.

• 서명 및 공증은 아직 프로덕션 수준이 아닙니다.

• 해당 AI 기능을 사용하려면 구성된 제공자 또는 설치된 모델이 필요합니다. 수동 편집은 없이도 계속 사용할 수 있습니다.

버전 기록은 CHANGELOG.md를, 게시된 아티팩트는 GitHub Releases를 참조하세요.

라이선스, 출처 및 기여

YoloCut은 hhz0823이 독립적으로 유지 관리하며 GNU Affero General Public License v3.0 이상에 따라 라이선스가 부여됩니다.

코드베이스는 AGPL 라이선스의 0xsline/OpenChatCut 프로젝트에서 이어집니다. 이 귀속 표기는 소스 및 라이선스 출처를 보존합니다. 업스트림 브랜딩, 기여자, 커뮤니티 채널 및 상업적 관계는 YoloCut 제품 또는 공개 릴리스 기록의 일부가 아닙니다.

타사 라이브러리, 모델, 글꼴, 스킬 및 번들 바이너리는 각각의 라이선스를 유지합니다. THIRD_PARTY_NOTICES.md, src/agent/skills/NOTICE.md 및 assets/fonts/LICENSES.md를 참조하세요.

• 이슈: github.com/Hhz0823/YoloCut/issues

• 릴리스: github.com/Hhz0823/YoloCut/releases

• Agent 가이드: YOLOCUT_AGENT_CONNECTION.md