OpenCreator는 창작 및 개발 작업을 로컬에서 계속 실행하고자 하는 개인과 팀을 위해 만들어졌습니다. Agent 루프를 다시 구현하는 대신 Codex CLI를 실행 엔진으로 사용하고, 그 위에 안정적인 로컬 Runtime, 시각적 워크스페이스, Desktop 호스트를 제공합니다.
이 제품은 서로 연결된 두 가지 워크플로를 통합합니다.
AI 콘텐츠 제작: 동영상 번역, 동영상 다운로드, 썸네일 생성, 이미지 생성을 위한 전용 제작 도구를 사용할 수 있습니다.
범용 Agent 워크스페이스: 대화를 프로젝트별로 정리하고, Run을 백그라운드에서 계속 실행하면서 승인, 첨부 파일, 파일, Skills, MCP, 일정, 알림, 메모리, 진단을 한곳에서 관리할 수 있습니다.
Web은 유일한 프런트엔드 구현입니다. Desktop은 동일한 Web 빌드를 불러오며 디렉터리 선택, 창 수명 주기, 트레이 동작, 네이티브 알림처럼 운영체제가 필요한 기능만 추가합니다. 동일한 데이터와 콘텐츠 뷰포트에서는 두 플랫폼이 같은 범용 UI와 Runtime 동작을 공유합니다.
주요 특징
🤖 Codex 네이티브: 별도의 실행 엔진을 유지하지 않고 Codex의 Agent 루프, 모델, 추론, 도구 호출, 대화, Skills, MCP를 그대로 활용합니다.
🚀 바로 사용할 수 있는 Desktop 앱: Codex CLI가 포함된 Desktop 앱에서 OpenCreator를 직접 실행할 수 있습니다. 로컬 Runtime은 필요할 때 시작되고 기본 프로젝트를 자동으로 준비합니다.
🔄 관리형 Runtime 구성 요소: 번들, 사용 중, 최신 yt-dlp 버전을 확인하고 주기적으로 업데이트를 검사한 뒤 수동으로 업데이트할 수 있습니다. 업데이트가 실패해도 현재 작동 중인 버전은 유지됩니다.
🎨 멀티모달 제작: 동영상, 이미지, 오디오, 자막, 문서를 하나의 연결된 워크플로에서 제작하고 관리합니다.
🔗 듀얼 모드 워크플로: 시각적 워크스페이스와 Agent 대화 중 어느 쪽에서도 작업할 수 있으며, 하나의 공유 상태 머신이 단계, 진행 상황, 결과를 동기화합니다.
🕘 버전 관리: 수정할 때마다 새 버전을 생성하고 이전 설정과 결과를 검토하고 비교할 수 있도록 보존합니다.
🧩 Skills와 MCP: Skills를 탐색, 설치, 실행하고 Codex 네이티브 설정을 통해 MCP를 관리합니다.
🧠 메모리: 전역, 프로젝트, 스레드 단위의 메모리를 유지하며 요약과 재현 가능한 Run 입력 스냅샷을 저장합니다.
🔐 로컬 보안: 데이터, 첨부 파일, 로그를 기본적으로 로컬에 보관하고 승인 절차와 민감 정보가 제거된 진단 정보를 제공합니다.
제작 도구
현재 릴리스에는 네 가지 제작 도구가 포함되어 있습니다. 사용할 수 있는 모델과 서비스는 로컬 Codex 환경 및 AI 서비스 설정에 따라 달라집니다.
Dashboard에서 동영상을 번역하고, 공개 동영상을 다운로드하고, 썸네일을 생성하거나 이미지를 만들 수 있습니다.
제작 도구는 계속 추가될 예정입니다.
제작 도구
상태
기능
동영상 번역
✅ 사용 가능
로컬 또는 공개 동영상을 불러오고 클라우드나 로컬 Whisper 서비스로 음성을 텍스트로 변환합니다. LLM 컨텍스트를 활용해 자막 분할, 정렬, 용어 처리, 번역을 수행하고, 이중 언어 자막, 더빙 또는 사용자 지정 음성 샘플, 자막 스타일, 가로·세로 구성을 설정한 뒤 SRT, 오디오 또는 동영상으로 내보낼 수 있습니다
동영상 다운로드
✅ 사용 가능
YouTube, Bilibili 등 지원되는 공개 링크를 분석하고 이용 가능한 화질과 형식을 확인한 뒤 후속 작업에 사용할 동영상 또는 오디오를 다운로드할 수 있습니다
썸네일 생성
✅ 사용 가능
주제, 동영상 링크, 선택적 참조 이미지를 조합해 여러 콘텐츠 썸네일 시안을 생성하고 비교할 수 있습니다
이미지 생성
✅ 사용 가능
프롬프트와 선택적 참조 이미지로 GPT Image를 사용해 이미지를 생성하고, 화면 비율과 출력 수를 설정한 뒤 각 이미지를 미리 보고 다운로드할 수 있습니다
스틱 피겨 애니메이션
출시 예정
안내형 워크플로에서 캐릭터, 스토리보드, 음성 해설, 애니메이션을 제작합니다
자동 클립
개발 중
긴 동영상을 분석하고 주요 장면을 찾아 선택한 순간을 재사용 가능한 짧은 클립으로 만듭니다
스마트 더빙
개발 중
음성, 속도, 감정 표현을 선택해 스크립트를 음성 해설로 변환합니다
동영상 생성
개발 중
프롬프트와 참조 이미지로 동영상을 생성한 뒤 미리 보고 내보냅니다
디지털 아바타
개발 중
스크립트, 음성, 아바타 표현을 결합해 말하는 인물 동영상을 제작합니다
대화와 워크스페이스를 함께 진행
작업을 자연어로 설명하고 정밀한 제어가 필요할 때 시각적 도구로 전환하세요.
세밀한 워크스페이스 제어
자막, 장면, 오디오, 생성 설정을 정확하게 조정합니다.
유연한 대화형 편집
Agent에게 변경할 내용을 알려 주고 자연어로 결과를 계속 다듬습니다.
동기화된 상태
대화와 워크스페이스가 현재 작업 상태를 공유하므로 같은 내용을 반복할 필요가 없습니다.
독립적인 버전
각 수정은 이전 결과나 설정을 덮어쓰지 않고 별도의 버전을 만듭니다.
지원 모델
언어 모델은 Codex 모델 카탈로그 또는 설정한 OpenAI 호환 공급자를 따릅니다. 이미지, 음성, 텍스트 변환 모델은 설정 → AI 서비스에서 구성한 서비스를 사용합니다.
언어 모델
GPT
DeepSeek
Qwen
Kimi
GLM
Grok
Doubao
ERNIE
Hunyuan
이미지
GPT Image
음성 및 텍스트 변환
Whisper
OpenAI TTS
MiniMax
Edge TTS
Aliyun Speech
활용 사례
동영상 번역
아래 공개 사례는 OpenCreator가 KrillinAI라는 이름을 사용하던 시기에 제작되었습니다. 이 사례들은 OpenCreator의 동영상 번역 워크스페이스가 더 넓은 Agent 워크플로에 제공하는 검증된 자막 정렬, 번역, 더빙, 세로형 동영상 워크플로를 보여 줍니다.
이 프로젝트는 46분 분량의 로컬 동영상에서 수동 자막 조정 없이 한 번의 실행으로 아래 자막 파일을 생성했습니다. 공개된 결과는 모든 구간을 빠짐없이 다루고, 자막이 서로 겹치지 않으며, 자연스럽게 분할되고, 높은 번역 품질을 보여 줍니다.
http://127.0.0.1:19861/을 여세요. 개발 서버는 필요할 때 로컬 daemon을 시작하고 동일 출처 프록시를 통해 임시 Runtime 토큰을 주입하므로 연결 토큰을 수동으로 복사할 필요가 없습니다.
처음 실행하면 Runtime이 기본 프로젝트를 준비합니다. 연결이 완료되는 즉시 입력창을 사용할 수 있습니다. daemon만 실행하려면 다음 명령을 사용하세요.
pnpm daemon:dev
daemon은 루프백 주소만 수신하며 연결 주소와 임시 토큰을 stdout에 한 번 출력합니다.
Desktop
Desktop과 브라우저는 apps/web의 동일한 React 프런트엔드를 사용합니다. 일반적인 프로젝트, 대화, 작업, 설정 동작은 동일한 Daemon/API를 호출합니다. Electron은 실제 시스템 경로, 창 제어, 트레이 동작, 네이티브 알림만 추가합니다.
개발 모드
pnpm desktop:dev
로컬 패키징
명령
출력
pnpm desktop:package
로컬 검증을 위한 현재 플랫폼의 실행 가능한 디렉터리
pnpm desktop:dist
현재 플랫폼용 설치 프로그램
pnpm desktop:release
정식 릴리스 패키징 진입점
pnpm --filter @opencreator/desktop verify:package
기존 Desktop 패키지 검증
Desktop 패키징은 현재 작업 공간에서 Web을 다시 빌드하고 commit, dirty 상태, 플랫폼, 아키텍처, Web 해시를 기록한 다음 apps/web/dist와 애플리케이션에 포함된 리소스를 비교합니다. 서로 다르면 패키징이 실패합니다. 서명, 공증, Windows 빌드, 릴리스 요구 사항은 Desktop 릴리스 운영 가이드를 참고하세요.
핵심 워크플로
대화와 Run
프로젝트를 선택하거나 새 대화를 시작합니다.
작업을 입력하고 권한 수준, Profile, 모델, 추론 강도를 선택합니다.
Run이 활성화된 동안 후속 작업을 대기열에 추가하거나 실행을 중단하고 바로 계속합니다.
Timeline에서 추론 요약, 도구 호출, 파일 변경, 승인, 최종 결과를 확인합니다.
작업 센터에서 실행 중, 완료, 실패, 승인 대기 상태의 작업을 전체적으로 추적합니다.
Skills와 MCP
플러그인 센터에서 Skill 마켓플레이스, 설치 기록, 로컬에서 사용할 수 있는 Skills를 살펴볼 수 있습니다.
입력창에서 / 또는 추가 메뉴를 통해 Skill을 선택하면 다음 작업이 해당 워크플로를 따릅니다.
MCP 관리는 별도의 실행 엔진을 유지하는 대신 Codex 네이티브 명령과 설정을 사용합니다.
OpenCreator는 기본적으로 현재 $CODEX_HOME을 사용하므로 전역 Skills 또는 MCP 설정을 변경하기 전에 영향을 확인하세요.
일정과 전용 작업 스레드
각 일정에는 영구적인 전용 OpenCreator 대화가 있습니다.
자동 트리거, 수동 실행, 사용자 후속 작업은 동일한 대화를 재사용하며 queue 또는 skip 정책에 따라 순차 실행됩니다.
일정을 삭제하면 전용 대화는 보관 처리되지만 기존 Runs, 결과, 기반 Codex 기록은 유지됩니다.
기반 Codex 스레드를 교체하거나 복구해도 OpenCreator 작업 항목과 페이지 경로는 변경되지 않습니다.
OpenCreator 시스템 구조
OpenCreator는 시각적 워크스페이스와 Agent 대화를 서로 다른 두 워크플로가 아니라 동일한 창작 작업을 위한 두 개의 인터페이스로 취급합니다. 각 제작 워크플로는 상태 머신으로 모델링됩니다. 소스 입력, 설정, 생성, 검토, 수정, 내보내기가 명시적인 상태와 이벤트가 됩니다. 워크스페이스 동작과 대화 명령은 동일한 상태 머신에 입력되며 현재 단계, 설정, 진행 상황, 버전, 결과는 두 인터페이스에 다시 반영됩니다. 이를 통해 두 번째 정보 출처를 만들지 않고 워크스페이스와 대화를 동기화합니다.
창작 작업은 반복적이므로 수정 시 현재 결과를 덮어쓰지 않습니다. 각 수정이나 재생성은 기존 워크플로 상태에서 새 버전을 만들고 이전 버전의 설정과 결과를 유지하여 검토, 비교, 추가 개선에 활용할 수 있게 합니다.
워크스페이스와 Agent 대화는 하나의 워크플로 상태를 동기화해 보여 줍니다. 두 인터페이스 모두 동일한 상태 머신에 이벤트를 보내며 별도의 작업 상태를 유지하지 않습니다.
수정 시 기존 결과를 교체하지 않고 새 버전을 생성하여 각 창작 반복 과정의 컨텍스트와 결과를 보존합니다.
프런트엔드는 Codex를 직접 실행하지 않으며 Codex의 원시 JSONL 이벤트 형식에도 의존하지 않습니다.
daemon은 프로세스 수명 주기, 이벤트 정규화, 영속성, 승인, 일정, 알림 outbox를 관리합니다.
Agent 루프, Skills, MCP 실행에서는 Codex가 계속해서 유일한 정보 출처입니다.
Browser Bridge와 Desktop Bridge는 범용 제품 로직을 별도로 구현하지 않습니다.
리포지토리 구성
OpenCreator/
├── apps/
│ ├── web/ # 유일한 React 프런트엔드 구현
│ ├── daemon/ # 로컬 Fastify Runtime 및 Codex 어댑터
│ ├── desktop/ # Electron Main, Preload, 네이티브 기능 및 패키징
│ └── harness/ # Runtime 명령줄 검증 도구
├── packages/
│ ├── protocol/ # Web, Daemon, Desktop이 공유하는 Runtime 계약
│ └── skill-market/ # Skill 마켓플레이스 모델 및 공유 로직
├── docs/ # 설계 문서, API 참조, 운영 가이드 및 테스트 보고서
├── scripts/ # 리포지토리 수준 검사
└── .runtime/ # 처음 실행할 때 생성되는 로컬 Runtime 데이터
설정
AI 서비스 API 키
설정 → AI 서비스에서 현재 워크스페이스가 사용하는 모델, 음성 인식, 오디오, 이미지 제공자를 설정하세요. 향후 제작 도구를 준비하는 과정에서 서비스 범주가 추가로 표시될 수 있습니다. 각 범주에는 선택한 제공자에 필요한 Base URL, API Key, 모델, 프록시 또는 제공자별 자격 증명 필드만 표시됩니다.
자격 증명은 로컬 Runtime의 시스템 자격 증명 저장소를 통해 저장되며 리포지토리에 commit해서는 안 됩니다. Edge TTS와 같은 일부 로컬 또는 시스템 기반 제공자는 API Key가 필요하지 않습니다.
타사 Runtime 구성 요소
설정 → 타사 구성 요소에서 현재 사용 중인 yt-dlp nightly 버전, OpenCreator에 포함된 버전, 출처, 사용 가능한 최신 릴리스를 확인할 수 있습니다. OpenCreator는 7일마다 업데이트를 확인하지만 자동으로 설치하지 않습니다. 업데이트는 사용자가 명시적으로 실행해야 하며 다운로드, 검증 또는 설치가 실패해도 현재 작동 중인 버전을 계속 사용할 수 있습니다.
Runtime 환경 변수
대부분의 사용자는 환경 변수가 필요하지 않습니다. 격리된 데이터, 특정 Codex 실행 파일 또는 사용자 지정 관리 프로젝트 디렉터리가 필요한 경우 다음 변수를 사용하세요.
환경 변수
기본값
용도
OPENCREATOR_DATA_DIR
.runtime
OpenCreator 데이터베이스, Runs, 첨부 파일, 관리 대상 워크스페이스
OPENCREATOR_CODEX_BIN
codex
Codex CLI 실행 파일 경로
CODEX_HOME
~/.codex
Codex 세션, 설정, Skills, MCP, Profiles의 정보 출처
OPENCREATOR_DEFAULT_CWD
현재 작업 디렉터리
daemon의 기본 작업 디렉터리
OPENCREATOR_DEFAULT_PROJECT_ROOT
Runtime 기본 정책
관리 대상 프로젝트 루트. 설정하면 OpenCreator는 그 아래의 OpenCreator/ 디렉터리를 사용합니다
OPENCREATOR_CODEX_THREAD_ROTATION_RUN_THRESHOLD
50
장기 실행 일정의 기반 Codex 스레드를 교체하기 위한 종료 Run 수 임계값. 사전 교체를 비활성화하려면 0을 사용합니다
Desktop, Host Bridge, Runtime 프록시 또는 공유 프런트엔드 워크플로를 변경한 경우 Web/Desktop 일관성 테스트, 패키징된 애플리케이션 E2E, Web 빌드 해시 검증도 필요합니다. Web 단위 테스트 통과만으로 Desktop 릴리스 준비가 완료되었다고 볼 수 없습니다.
실제 Codex 스모크 테스트는 기본적으로 비활성화되어 있습니다. 다음과 같이 명시적으로 활성화하세요.
OPENCREATOR_RUN_REAL_CODEX_SMOKE=1 \
pnpm --filter @opencreator/daemon test -- test/smoke/real-codex-smoke.test.ts
