Skip to content

Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.

49.4 KB
Raw Blame

OpenCreator
Open-source na AI workspace at Skills para sa mga creator

Pagsamahin ang mga biswal na setting, muling magagamit na Skills, at Agent para sa script, video, larawan, boses, pagsasalin, at pag-edit sa iisang workspace.

Dating kilala ang OpenCreator bilang KrillinAI.

OpenCreator, dating KrillinAI: nangungunang repository ng araw sa Trendshift

English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية | ภาษาไทย | Türkçe | हिन्दी | বাংলা | اردو | Tiếng Việt | Filipino

GitHub Stars License Bilibili AtomGit G-Star Discord Grupo sa QQ

Mga tampok · Mga tool · Skills · Mga halimbawa · Pagsisimula · Desktop · Dokumentasyon · Komunidad

Agent workspace ng OpenCreator

Pangkalahatang ideya ng proyekto

Ang OpenCreator ay para sa mga indibidwal at pangkat na gustong gawin nang lokal ang paglikha at pag-develop. Ginagamit nito ang Codex CLI bilang execution engine at dinaragdagan ito ng matatag na lokal na Runtime, biswal na workspace, at Desktop host, sa halip na buuing muli ang Agent loop.

May dalawang magkaugnay na paraan ng pagtatrabaho sa OpenCreator:

  • Content workspace: gumamit ng biswal na tool at template para sa pagsasalin at pag-download ng video, pagbuo ng larawan at video, voiceover, pagsulat ng artikulo at social post, script ng maikling video, at stick figure animation.
  • Pag-uusap sa Agent: magsimula at gumabay ng malikhaing gawain o pag-develop gamit ang natural na wika; ayusin ang usapan ayon sa proyekto, hayaang tumakbo sa background ang mga Run, at pamahalaan ang pag-apruba, attachment, file, Skills, MCP, iskedyul, notification, memorya, at diagnostic sa iisang lugar.

Web ang nag-iisang implementasyon ng frontend. Parehong Web build ang nilo-load ng Desktop, na nagdaragdag ng mga kakayahang nangangailangan ng operating system: pagpili ng directory, lifecycle ng window, system tray, at native notification. Kapag pareho ang datos at laki ng content viewport, pareho rin ang pangkalahatang UI at kilos ng Runtime sa dalawang platform.

Mga tampok ng proyekto

  • 🤖 Nakabatay sa Codex: muling gamitin ang Agent loop, modelo, reasoning, tool call, usapan, Skills, at MCP ng Codex nang walang ikalawang execution engine na kailangang panatilihin.

  • 🚀 Desktop app na handang gamitin: kasama na ang Codex CLI; kusang nagsisimula ang lokal na Runtime kapag kailangan at naghahanda ng default na proyekto.

  • ⚙️ Muling paggamit ng Codex setup: sa unang pagbukas, sinusuri ang lokal na Codex configuration at iniaalok ang gumaganang ChatGPT sign-in o API key. May gabay na form para sa ibang provider.

  • 🔄 Pinamamahalaang Runtime component: tingnan ang kasamang, aktibo, at pinakabagong yt-dlp; suriin ang update nang pana-panahon at manu-manong mag-update. Nananatiling magagamit ang gumaganang bersyon kung pumalya ang update.

  • 🎨 Multimodal na paglikha: gumawa at mamahala ng video, larawan, audio, subtitle, at dokumento sa magkaugnay na daloy.

  • 🧩 Mga template: magsimulang gumawa ng larawan at video mula sa muling magagamit na template nang hindi inuulit ang prompt at setting mula sa simula.

  • 🔗 Dalawang paraan ng paggawa: gamitin ang biswal na workspace o usapan sa Agent; isang shared state machine ang nagsasabay ng hakbang, progreso, at resulta.

  • 🕘 Mga bersyon: bawat rebisyon ay bagong bersyon; pinananatili ang lumang setting at output para sa pagsusuri at paghahambing.

  • 🧩 Muling magagamit na Skills: gamitin ang Skills para sa video, palawakin ang Agent gamit ang sariling Skills, at pamahalaan ang MCP sa katutubong configuration ng Codex.

  • 🧠 Memorya: global, proyekto, at thread na memorya na may buod at snapshot ng input ng Run na maaaring muling likhain.

  • 🔐 Lokal na seguridad: lokal ang datos, attachment, at log bilang default, na may pag-apruba at diagnostic na tinanggalan ng sensitibong detalye.

  • 🌐 Multilingual na interface: May 43 wika ang Web at Desktop, na may pagtukoy sa wika ng system, manu-manong pagpili, at kanan-pakaliwang layout para sa Arabic, Persian, Urdu, at Hebrew.

Mga tool para sa creator

May sampung tool para sa creator ang kasalukuyang release. Nakadepende ang mga magagamit na modelo at serbisyo sa lokal na Codex environment at AI service setting.

Buksan ang Dashboard para magsulat ng artikulo, Xiaohongshu post, o script ng maikling video; gumawa ng stick figure animation; magsalin o mag-download ng video; bumuo ng thumbnail, larawan, o video; at lumikha ng voiceover sa Text to Speech.

Creator Dashboard ng OpenCreator

Patuloy na nadaragdagan ang mga tool para sa creator.

May 123 pinagmulang wika at 124 target na opsyon ang pagsasalin ng video, kasama ang Pinyin na output. Maghanap gamit ang katutubong pangalan, Ingles, Tsino, o code ng wika. Nakadepende sa napiling serbisyo at modelo ang saklaw ng pagkilala at pagbuo ng boses.

  • Subtitle lang ang isasalin: Mag-import at mag-preview ng SRT, saka isalin ito nang walang source video, dubbing, o pag-render ng video.

  • Advanced na pag-edit ng subtitle: Gumamit ng immersive editor na may waveform at timeline na kasabay ng playback upang ayusin ang oras, hatiin o pagsamahin ang subtitle, at maghanap at magpalit ng teksto. I-preview ang estilo sa video, baguhin ang wika, boses, at output, saka gumawa ng bagong bersyon habang pinapanatili ang mga naunang resulta.

  • Paglikha sa isang pahina: Itakda ang image generation, video generation, at Text to Speech sa isang pahina, na may pagpili ng modelo, reference preview, mga opsyon ng larawan ayon sa modelo, at voice library na may paghahanap.

  • Multilingual na output at progreso: Pinapahusay ng kasamang fallback font ang komplikadong script at kanan-pakaliwang subtitle. Subaybayan ang transcription, pagsasalin, dubbing, at pag-render, kasama ang bilang ng natapos at kabuuan kapag available.

Workspace Katayuan Mga kakayahan
Pagsasalin ng video✅ MagagamitMag-import ng lokal o pampublikong video; mag-transcribe sa cloud o lokal na Whisper; gamitin ang konteksto ng LLM para sa paghahati, pag-align, termino, at pagsasalin ng subtitle; itakda ang bilingguwal na subtitle, dubbing o sariling voice sample, estilo, pahalang/patayong komposisyon; mag-export ng SRT, audio, o video
Pag-download ng video✅ MagagamitSuriin ang indibidwal na pampublikong video mula sa YouTube, Bilibili, X, TikTok, Instagram, Douyin, Facebook, Xiaohongshu, Pinterest, at Reddit; ihambing ang format at mag-download ng video o audio. Maaaring kailanganin ang platform cookie. Kung may subtitle ang platform, tingnan ang listahan at mag-download ng SRT; inuuna ang Ingles, saka ang wika ng interface kung available.
Pagbuo ng thumbnail✅ MagagamitPagsamahin ang paksa, video link, at opsyonal na reference image para bumuo at maghambing ng mga bersyon ng thumbnail
Pagbuo ng larawan✅ MagagamitGamitin ang GPT Image / Seedream / Kling Image / Gemini mula sa prompt at opsyonal na reference image; itakda ang aspect ratio at dami, saka i-preview at i-download ang bawat larawan
Pagsulat ng artikulo✅ MagagamitGawing mae-edit na mga paksa, outline, at buong artikulo ang paksa, link, video, o source document; magdagdag ng nabuong larawan at mag-export ng Markdown, HTML, o PDF
Mga post sa Xiaohongshu✅ MagagamitGumawa ng buong post mula sa paksa o sanggunian, itakda ang audience, uri, at haba, saka kopyahin o i-download
Script ng maikling video✅ MagagamitGumawa ng nahating script na handang kunan mula sa paksa o sanggunian, ayon sa audience, platform, tagal, at tono; i-edit, kopyahin, o i-download
Stick figure animation✅ MagagamitGawing salaysay, boses, storyboard na pare-pareho ang karakter, subtitle, at nada-download na animation ang teksto o YouTube content
Awtomatikong clipGinagawa paSuriin ang mahabang video, hanapin ang highlight, at gawing muling magagamit na maikling clip ang mga napiling sandali
Text to Speech✅ MagagamitGawing voiceover ang script na may pagpili ng boses, bilis, at emosyon
Pagbuo ng video✅ MagagamitGumawa ng video gamit ang Seedance / Kling / Veo mula sa prompt at reference image; i-preview, buuing muli, at i-download ang bawat bersyon
Digital na avatarGinagawa paPagsamahin ang script, boses, at avatar upang gumawa ng video ng nagsasalitang tauhan

Mga template para sa paglikha

Magsimula sa template sa halip na buuin ang bawat prompt at setting mula sa simula. Hanapin ang angkop na panimula sa mga tampok na template ayon sa kategorya, kabilang ang video at disenyo ng larawan.

Kasama sa koleksiyon ang mga template ng OpenCreator at ng mga independiyenteng creator. Kinikilala ng pahina ng detalye ang gumawa ng third-party template at may link sa orihinal na sanggunian.

Buksan ang template upang makita ang halimbawang resulta, prompt, setting, tag, may-akda, at orihinal na sanggunian. Piliin ang Use this template, saka baguhin ang input para sa iyong gawain.

Detalye ng template ng larawan na may resulta, setting, at prompt

Skills

May biswal na kontrol ang mga tool; nagbibigay naman ang Skills ng muling magagamit na tagubilin at daloy ng paggamit ng tool sa Agent. Kasama sa repository ang Skills para sa video production at pamamahala ng lokal na Codex Skills.

Nasa skills/ ang muling magagamit na tagubilin para sa Agent na gumagamit ng naka-embed na KrillinAI CLI.

Skill Mga kakayahan
KrillinAI CLI Pumili ng command, suriin ang configuration, at unawain ang progreso, manifest, output, at error
Subtitle Mag-download ng caption o mag-transcribe, magsalin ng subtitle, at gumawa ng bilingguwal o maikling subtitle para sa patayong video
TTS Gumawa ng dubbing sa target na wika mula sa subtitle at opsyonal na dubbed video
Pahalang na render Mag-render ng pahalang na video na may bilingguwal na subtitle o dubbed audio at target-language subtitle
Patayong render Gumawa ng patayong video na may pamagat, bilingguwal na subtitle, o dubbing
Pabalat Bumuo ng pabalat mula sa buong text prompt at i-save ang larawan at huling prompt
Plano ng pipeline Suriin ang planong may maraming yugto sa dry-run; gawin ang aktuwal na trabaho sa Skills ng bawat yugto

Palawakin gamit ang sariling Skills

Sinusuportahan ng OpenCreator ang lokal na Codex Skills na may SKILL.md, kaya maaari kang magdagdag ng sariling paraan at daloy. Nakadepende ang magagamit na Skills sa aktibong Codex home at mga naka-install na Skill; kailangan ng video Skills ang naka-configure na CLI at kaugnay na serbisyo. Ang pagkakasama sa repository ay hindi nangangahulugang awtomatikong naka-install ang lahat ng Skill o kasama ang lahat ng panlabas na serbisyo.

Magkasabay ang usapan at workspace

Ilarawan ang gawain nang natural, saka lumipat sa biswal na tool kapag kailangan ng eksaktong kontrol.

Magkaugnay na usapan at biswal na workspace ng OpenCreator

Detalyadong kontrol

Eksaktong ayusin ang subtitle, shot, audio, at generation setting.

Pag-edit sa usapan

Sabihin sa Agent ang babaguhin at pinuhin ang resulta sa natural na wika.

Magkasabay na estado

Pareho ang kasalukuyang estado ng gawain sa usapan at workspace, kaya walang kailangang ulitin.

Hiwalay na mga bersyon

Bawat rebisyon ay hiwalay na bersyon na hindi pinapatungan ang lumang resulta o setting.

Mga sinusuportahang modelo

Ang mga language model ay mula sa katalogo ng Codex o sa iyong OpenAI-compatible provider. Ginagamit ng larawan, video, boses, at transcription ang serbisyong itinakda sa Settings → AI Services.

Mga halimbawa ang ipinakitang provider at modelo; nakadepende ang aktuwal na availability sa credential, access ng account, at platform.

Mga language model

OpenAI
GPT
DeepSeek
DeepSeek
Qwen
Qwen
Kimi
Kimi
Z.ai
GLM
xAI
Grok
Doubao
Doubao
ERNIE
ERNIE
Tencent Hunyuan
Hunyuan
MiniMax
MiniMax

Larawan

OpenAI
GPT Image
Jimeng
Seedream 4.0
Jimeng
Kling
Kling v2.1
Kling Image
Gemini
Nano Banana
Gemini 2.5 Flash Image

Video

Seedance
Seedance 2.5
Kling
Kling v2.1 Master
Gemini
Veo 3.1

Boses at transcription

OpenAI
Whisper
OpenAI
OpenAI TTS
MiniMax
MiniMax
Microsoft
Edge TTS
Alibaba Cloud
Aliyun Speech
Volcengine
Volcengine Speech

Sinusuportahan din ang lokal na transcription gamit ang faster-whisper, WhisperKit, at whisper.cpp kung magagamit.

Mga halimbawa

Pagsasalin ng video

Ginawa ang mga pampublikong halimbawa noong KrillinAI pa ang pangalan ng OpenCreator. Ipinapakita nila ang matatag na daloy ng subtitle alignment, pagsasalin, dubbing, at patayong video na bahagi na ngayon ng mas malawak na Agent workflow sa Video Translation.

Nabuo ang subtitle sa ibaba mula sa 46-minutong lokal na video sa isang Run, nang walang manu-manong pag-aayos. Makikita ang buong saklaw, walang nagsasapawang linya, natural na paghahati, at mahusay na pagsasalin.

Halimbawa ng subtitle alignment ng OpenCreator

Pagsasalin ng subtitle

https://github.com/user-attachments/assets/bba1ac0a-fe6b-4947-b58d-ba99306d0339

Dubbing

https://github.com/user-attachments/assets/0b32fad3-c3ad-4b6a-abf0-0865f0dd2385

Patayong mode

https://github.com/user-attachments/assets/c2c7b528-0ef8-4ba9-b8ac-f9f92f6d4e71

Ginawa ang mga video at larawan ng subtitle alignment noong KrillinAI pa ang pangalan ng OpenCreator.

Pag-download ng video

Suriin ang pampublikong video link mula sa 10 sinusuportahang platform, ihambing ang format, at i-download ang video o audio diretso sa proyekto.

Mga sinusuportahang pinagmumulan:

YouTube
YouTube
Bilibili
Bilibili
X
X
TikTok
TikTok
Instagram
Instagram
Douyin
Douyin
Facebook
Facebook
Xiaohongshu
Xiaohongshu
Pinterest
Pinterest
Reddit
Reddit

Nag-iiba ang availability ayon sa video at rehiyon; maaaring kailanganin ang platform cookie.

Pagpili ng format sa Video Downloader

Pagbuo ng video

Gumawa ng AI video mula sa text prompt o reference image gamit ang Seedance. Itakda ang modelo, aspect ratio, resolution, at tagal; i-preview, buuing muli, o i-download ang bawat bersyon sa workspace ng proyekto.

Pagbuo ng video sa OpenCreator gamit ang Seedance

Stick figure animation

Binuo ng OpenCreator ang orihinal na koleksiyon ng karakter kasama ang artist na si Harbor Hsia, gumawa ng Stickman sa Behance. Pinananatili ng mga kasamang karakter ang pare-parehong pagkakakilanlan sa buong paggawa ng animation.

Mga karakter na binuo ng OpenCreator kasama ang artist

Gawing buong animation ang teksto o YouTube content sa gabay na daloy ng pagsusuri ng script, salaysay, timing, storyboard, subtitle, rendering, at nada-download na video.

Halimbawang frame ng stick figure animation

Mabilis na pagsisimula

I-install ang Desktop app

I-download ang installer mula sa pinakabagong OpenCreator release para sa macOS Apple Silicon, macOS Intel, o Windows x64. I-install at buksan; hindi kailangan ang Node.js o pnpm. Kasama ang Codex CLI; kailangan ng gumaganang ChatGPT sign-in o API key para sa tunay na model task.

Sa unang pagbukas, pinapatakbo ng Desktop ang lokal na Runtime, naghahanda ng default na proyekto, at sinusuri ang Codex configuration. Kung may gumaganang sign-in o API key at model setting, piliin ang Use local Codex and continue. Maaari ring mag-configure ng ibang provider sa parehong proseso:

Pag-set up ng provider sa unang pagbukas ng Desktop

Pagkatapos ng setup, ilagay ang kahilingan sa composer upang magsimula. Tingnan ang gabay at pag-aayos ng problema kung may aberya.

Patakbuhin ang Web mula sa source

Para sa pag-develop o paggamit sa browser, i-install ang:

  • Node.js 22 o mas bago
  • pnpm 9.15.0, nakapirmi sa packageManager ng repository
  • Codex CLI executable na matatawag mula sa terminal
  • Wastong Codex CLI login para sa tunay na model task

Suriin muna ang lokal na environment:

node --version
pnpm --version
codex --version
git clone https://github.com/krillinai/OpenCreator.git
cd OpenCreator
corepack enable
pnpm install
pnpm web:dev

Buksan ang http://127.0.0.1:19861/. Sinisimulan ng development server ang lokal na daemon kung kailangan at naglalagay ng pansamantalang Runtime token sa same-origin proxy; walang token na kailangang kopyahin.

Sa unang pagbukas, naghahanda ang Runtime ng default na proyekto at sinusuri ang Codex setting. Kumpirmahin ang ChatGPT sign-in o API key para sa lokal na Codex, o pumili ng provider at ilagay ang modelo, endpoint, at API key. Handa ang composer pagkatapos. Para sa daemon lamang:

pnpm daemon:dev

Sa loopback address lamang nakikinig ang daemon; isang beses nitong inilalabas sa stdout ang address at pansamantalang token.

Desktop

Parehong React frontend mula sa apps/web ang ginagamit ng Desktop at browser. Parehong Daemon/API ang tinatawag para sa proyekto, usapan, gawain, at setting. Nagdaragdag lamang ang Electron ng tunay na system path, window control, tray, at native notification.

Development mode

pnpm desktop:dev

Lokal na pag-package

Command Output
pnpm desktop:package Directory na mapapatakbo sa kasalukuyang platform para sa lokal na pagsusuri
pnpm desktop:dist Installer para sa kasalukuyang platform
pnpm desktop:release Opisyal na command para sa release packaging
pnpm --filter @opencreator/desktop verify:package Pagsusuri ng umiiral na Desktop package
pnpm krillinai:package Magkahiwalay na KrillinAI Server at CLI archive para sa napiling platform

Muling bina-build ng Desktop packaging ang Web mula sa kasalukuyang workspace, itinatala ang commit, dirty state, platform, architecture, at Web hash, at inihahambing ang apps/web/dist sa naka-embed na resource. Nabibigo ang packaging kung magkaiba. Tingnan ang Desktop release runbook para sa signing, notarization, Windows build, at release requirement.

Pangunahing mga daloy

Mga usapan at Run

  1. Pumili ng proyekto o magsimula ng bagong usapan.
  2. Ilagay ang gawain at piliin ang pahintulot, Profile, modelo, at antas ng reasoning.
  3. Habang aktibo ang Run, ipila ang susunod na gawain o ihinto ito at magpatuloy agad.
  4. Sa Timeline, tingnan ang buod ng reasoning, tool call, pagbabago sa file, pag-apruba, at resulta.
  5. Sa task center, subaybayan ang lahat ng tumatakbo, tapos, bigo, at naghihintay ng pag-apruba na gawain.

Skills at MCP

  • Tingnan ang Skill marketplace, kasaysayan ng pag-install, at lokal na Skills sa plugin center.
  • Pumili ng Skill sa composer gamit ang / o add menu para sundin ito ng susunod na gawain.
  • Katutubong command at configuration ng Codex ang namamahala sa MCP, walang ikalawang execution engine.
  • Aktibong $CODEX_HOME ang default; suriin ang epekto bago baguhin ang global Skills o MCP configuration.

Mga iskedyul at nakalaang task thread

  • Bawat iskedyul ay may sarili at patuloy na naka-save na usapan sa OpenCreator.
  • Ginagamit muli ng awtomatikong trigger, manu-manong Run, at follow-up ang usapan; sunod-sunod ang takbo ayon sa queue o skip.
  • Ina-archive ng pagtanggal ng iskedyul ang usapan habang pinananatili ang Run, resulta, at kasaysayan ng Codex.
  • Hindi binabago ng pag-rotate o pagbawi ng Codex thread ang task entry o page route ng OpenCreator.

Arkitektura ng OpenCreator

Ang biswal na workspace at usapan sa Agent ay dalawang interface ng iisang malikhaing gawain. Bawat daloy ay state machine: may malinaw na estado at event para sa input, configuration, generation, review, revision, at export. Sa iisang state machine pumapasok ang biswal na kilos at utos sa usapan; ibinabalik sa parehong interface ang kasalukuyang hakbang, setting, progreso, bersyon, at resulta. Nagsasabay sila gamit ang iisang pinagmumulan ng estado.

Paulit-ulit ang paglikha, kaya hindi pinapatungan ng rebisyon ang resulta. Bawat pagwawasto o regeneration ay bagong bersyon mula sa kasalukuyang workflow state, na pinananatili ang lumang setting at output para sa pagsusuri, paghahambing, at pagpino.

+-----------------------------+     +------------------------------------+
| Browser Access              |     | Desktop Host                       |
|                             |     | Shared Web build + Electron        |
+--------------+--------------+     +------------------+-----------------+
               |                                       |
               +-------------------+-------------------+
                                   v
+----------------------------------------------------------------------------+
| Creator Experience / apps/web                                              |
| Dashboard / Creator Tools / Agent Conversation / Settings / Files          |
+-------------------------------------+--------------------------------------+
                                      |
+-------------------------------------v--------------------------------------+
| Collaboration Core                                                         |
| Shared workflow state / Steps / Progress / Results / Versions              |
+-------------------------------------+--------------------------------------+
                                      | Runtime API + SSE
+-------------------------------------v--------------------------------------+
| Local Runtime / apps/daemon                                                 |
| Projects / Runs / Approvals / Schedules / Memory / Notifications           |
| Component status / Update checks / Verified updates / Safe fallback        |
+-------------+------------------------+------------------------+-------------+
              |                        |                        |
              v                        v                        v
+---------------------+  +---------------------+  +-------------------------+
| Local Data          |  | Codex Engine        |  | Media Toolchain         |
| SQLite / Files      |  | CLI / app-server    |  | FFmpeg / yt-dlp         |
| System credentials  |  | Skills / MCP        |  | Whisper / AI services   |
+---------------------+  +---------------------+  +-------------------------+
Bahagi ng OpenCreator Tungkulin Implementasyon
Karanasan ng creator Dashboard, tool, usapan sa Agent, setting, at file apps/web · React 18 · Vite · TypeScript
Ubod ng kolaborasyon Isinasabay ang hakbang, konteksto, progreso, resulta, at rebisyon Shared workflow state · CreatorCollaborationPanel · kasaysayan ng bersyon
Lokal na Runtime Proyekto, Run, pag-apruba, iskedyul, memorya, at notification apps/daemon · Fastify · Runtime API · SSE
Runtime component Sinusubaybayan ang kasama, aktibo, at bagong bersyon; regular na sumusuri; nag-i-install kapag hiniling yt-dlp nightly · beripikasyon ng update · pagbabalik sa gumaganang bersyon
Codex engine Agent loop, session, reasoning, tool, Skills, at MCP Codex CLI · app-server
Mga media tool Pag-download, transcription, conversion, generation, at export yt-dlp · Whisper · FFmpeg · naka-configure na AI service
Lokal na datos Lokal na proyekto, Run, attachment, output, at credential SQLite · filesystem · system credential storage
Desktop host Nilo-load ang shared Web build at dinaragdagan ng kakayahan ng OS apps/desktop · Electron · Preload Bridge

Pangunahing prinsipyo:

  • Iisang workflow state ang ipinapakita ng workspace at Agent; parehong nagpapadala ng event sa iisang state machine.
  • Bagong bersyon ang rebisyon, na pinananatili ang konteksto at output ng bawat paglikha.
  • Hindi direktang pinapatakbo ng frontend ang Codex at hindi ito umaasa sa hilaw na Codex JSONL event.
  • Daemon ang may hawak ng process lifecycle, event normalization, persistence, pag-apruba, iskedyul, at notification outbox.
  • Codex ang awtoridad sa execution ng Agent loop, Skills, at MCP.
  • Walang hiwalay na kopya ng pangkalahatang product logic sa Browser Bridge at Desktop Bridge.

Ayos ng repository

OpenCreator/
├── apps/
│   ├── web/          # Nag-iisang React frontend
│   ├── daemon/       # Lokal na Fastify Runtime at Codex adapter
│   ├── desktop/      # Electron Main, Preload, native capability, at packaging
│   └── harness/      # Command-line tool sa pagsusuri ng Runtime
├── packages/
│   ├── protocol/     # Shared Runtime contract ng Web, Daemon, at Desktop
│   └── skill-market/ # Skill marketplace model at shared logic
├── docs/             # Disenyo, API, runbook, at ulat ng pagsusuri
├── scripts/          # Mga pagsusuri sa repository
└── .runtime/         # Lokal na Runtime data, ginagawa sa unang pagbukas

Configuration

Mga API key ng AI service

Buksan ang Settings → AI Services upang itakda ang provider ng modelo, transcription, boses, at larawan para sa workspace. Maaaring may karagdagang kategorya para sa paparating na tool. Mga kailangang field lamang ng napiling provider ang ipinapakita: Base URL, API Key, modelo, proxy, o natatanging credential.

Mga API key setting ng AI service

Sa system credential storage ng lokal na Runtime naka-save ang credential; huwag itong i-commit sa repository. Hindi kailangan ng ilang lokal o system-backed provider gaya ng Edge TTS ang API Key.

Account at subscription

Ipinapakita ng personal center ang account, kumpirmadong subscription, at magagamit na credit. Binubuksan ng sign-in ang https://www.open-creator.ai/device. Mag-sign in sa website at aprubahan ang device; nakakakuha ang lokal na Daemon ng sariling session. Pareho ang account sa browser at app, ngunit hiwalay ang session.

Piliin ang plano sa OpenCreator. Binubuksan ng pagbili ang Stripe Checkout; sa Stripe Billing Portal pinamamahalaan ang subscription. Ang pagbabalik sa app mula sa billing ay sa /billing/return, na hindi nangangailangan ng website session. Nirerefresh ng OpenCreator ang benepisyo mula sa Gateway pagkatapos ng beripikadong Stripe notification. May isa pang daan sa pagbili sa /pricing at /account, gamit ang parehong subscription backend.

Third-party Runtime component

Buksan ang Settings → Third-party Components para makita ang ginagamit na yt-dlp nightly, kasamang bersyon, pinagmulan, at pinakabagong release. Bawat pitong araw nagsusuri ang OpenCreator ngunit hindi kusang nag-i-install. Kailangan ng tahasang utos ng user; nananatili ang gumaganang bersyon kung pumalya ang download, beripikasyon, o pag-install.

Setting ng third-party component

Mga environment variable ng Runtime

Hindi kailangan ng karamihan ang environment variable. Gamitin kapag kailangan ng hiwalay na datos, partikular na Codex executable, o sariling managed-project directory:

Environment variable Default Layunin
OPENCREATOR_DATA_DIR .runtime Database, Run, attachment, at managed workspace ng OpenCreator
OPENCREATOR_GATEWAY_ORIGIN https://www.open-creator.ai Gateway para sa login, subscription, credit, at opisyal na modelo; palitan para sa lokal na Gateway
OPENCREATOR_CODEX_BIN codex Path ng Codex CLI executable
CODEX_HOME ~/.codex Awtoridad para sa Codex session, configuration, Skills, MCP, at Profile
OPENCREATOR_DEFAULT_CWD Kasalukuyang working directory Default na working directory ng daemon
OPENCREATOR_DEFAULT_PROJECT_ROOT Default na patakaran ng Runtime Ugat ng managed project; ginagamit ang subdirectory na OpenCreator/ kung itinakda
OPENCREATOR_CODEX_THREAD_ROTATION_RUN_THRESHOLD 50 Bilang ng tapos na Run bago i-rotate ang Codex thread ng pangmatagalang iskedyul; 0 para patayin ang maagap na rotation

Halimbawa, paghiwalayin ang Runtime data at Codex environment:

OPENCREATOR_DATA_DIR=/path/to/opencreator-data \
CODEX_HOME=/path/to/codex-home \
pnpm web:dev

Datos at seguridad

Bilang default, nasa .runtime/ sa ugat ng repository ang Runtime data:

Path Nilalaman
.runtime/app.sqlite Proyekto, thread, Run, event, iskedyul, notification, attachment metadata, pag-apruba, memorya, at buod
.runtime/runs/ Log na inalisan ng sensitibong detalye, diagnostic, at metadata ng bawat Run
.runtime/attachments/ Kontroladong attachment file
.runtime/workspaces/ Project workspace na pinamamahalaan ng Runtime

Nasa $CODEX_HOME pa rin ang Codex session at configuration; hiwalay ang backup nito sa .runtime/.

Kasama sa hangganan ng seguridad:

  • Sa 127.0.0.1 lamang nakikinig ang daemon; kailangan ng Bearer token ang lahat ng API maliban sa health check.
  • Naka-off ang script, navigation, at popup sa HTML preview bilang default; kontroladong relative resource lamang sa parehong workspace ang pinapayagan.
  • Kailangan ng ikalawang kumpirmasyon ang sensitibong memorya. Hindi kusang permanenteng iniimbak ang hindi kumpirmadong mungkahi.
  • Inaalis ang sensitibong detalye sa diagnostic at Run log bago ibalik o i-export.
  • Naka-on ang ASAR integrity at cookie encryption sa Desktop package; naka-off ang RunAsNode, NODE_OPTIONS, at Node CLI Inspector.

Nasa gabay at pag-aayos ng problema ang buong proseso ng backup, restore, cleanup, at reset.

Pag-develop

Karaniwang command

Command Layunin
pnpm web:dev Simulan ang Web at lokal na daemon kapag kailangan
pnpm daemon:dev Simulan lamang ang daemon
pnpm desktop:dev I-build ang dependency at simulan ang Electron sa development mode
pnpm test Patakbuhin ang unit at integration test ng workspace
pnpm typecheck Suriin ang TypeScript sa buong repository
pnpm build I-build ang lahat ng workspace
pnpm e2e Patakbuhin ang Web Playwright E2E test
pnpm smoke:ci Patakbuhin ang Runtime smoke test gamit ang pekeng Codex
pnpm perf:check Suriin ang naitalang performance baseline

Bago mag-submit, pumili ng pagsusuring akma sa epekto ayon sa gabay sa kontribusyon. Kaugnay na pagsusuri lamang ang kailangan para sa dokumento, teksto, at estilo; kailangan ng targeted module test at typecheck para sa shared behavior at Runtime. Patakbuhin ang buong test o build kung kailangan ng saklaw, at ilahad ang pinatakbo sa PR.

Kailangan din ng pagbabago sa Desktop, Host Bridge, Runtime proxy, o shared frontend workflow ang Web/Desktop consistency test, packaged-app E2E, at Web build hash verification. Hindi sapat ang Web unit test upang patunayang handa ang Desktop release.

Naka-off bilang default ang tunay na Codex smoke test. Tahasang buksan gamit ang:

OPENCREATOR_RUN_REAL_CODEX_SMOKE=1 \
pnpm --filter @opencreator/daemon test -- test/smoke/real-codex-smoke.test.ts

Dokumentasyon

Patakaran sa pagsasalin

Ang root na README.md ang pamantayang dokumento sa English. Nasa docs/<locale>/README.md ang pinananatiling salin. Idagdag lamang ang wika sa switcher kapag kumpleto na ang salin at kapareho ng istruktura ng English.

Komunidad

May GitHub user mula sa hindi bababa sa 107 bansa at rehiyon na nag-star sa OpenCreator.

Mapa ng mga bansa at rehiyon na may nag-star sa OpenCreator sa GitHub

Pangkat na namamahala

Bawat kasapi ang responsable sa pamantayan, pagsusuri at pag-merge ng kontribusyon, at tulong sa komunidad sa sariling larangan.

wulien avatar
wulien
Code & pag-aayos ng bug
DLe-kb avatar
DLe-kb
Mga template
xiaheyuan avatar
xiaheyuan
Disenyo & asset
krillinai avatar
krillinai
Skills & dokumentasyon
hbxugang avatar
hbxugang
Enterprise deployment

Mga nag-ambag

Salamat sa lahat ng nag-ambag ng code, dokumentasyon, puna, ulat ng problema, Skills, ilustrasyon, at ideya. Hiwalay na pinananatili ang listahang ito sa awtomatikong Contributors graph ng GitHub.

maranello-o wulien puji4810 krillinai PairZhu Mijaelx OutisLi yeager catwithtudou newdee scwf xiaheyuan hbxugang kapil971390 octo-patch yuanjinghh DLe-kb liupig alextavares 卡皮巴拉 mifan100g (米饭二两) askalf Yi-111-a

Pag-ambag

Malugod na tinatanggap ang ambag sa:

Uri Maiaambag Lokasyon Laki
Code Pag-aayos ng bug, daloy ng creator, shared feature apps/web/, apps/daemon/ Isang nakatuong PR na may test
Skills Muling magagamit na Agent workflow skills/ Isang folder na may SKILL.md at opsyonal na sanggunian → gabay
Mga template Muling magagamit na preset ng larawan, video, o pabalat template/ Isang folder na may template.json at asset → gabay
Ilustrasyon at disenyo Orihinal na ilustrasyon, icon, o UI design Napagkasunduang lokasyon Isang PR na may preview, source file, at lisensya
Third-party integration Suporta sa AI o media provider Kaugnay na Web o Daemon module Isang PR na may error handling, ligtas na credential, at test
Dokumentasyon at pagsasalin Pagpapahusay ng dokumento o bagong wika README.md, docs/, docs/<locale>/ Isang PR

Nasa CONTRIBUTING.md ang buong gabay sa lokal na setup, review criteria, at karaniwang dahilan ng pagtanggi; may 10 wika.

Kasaysayan ng star

Dating KrillinAI ang OpenCreator. Saklaw ng chart ang buong kasaysayan ng repository bago at pagkatapos ng pagpapalit ng pangalan.

Kasaysayan ng star ng OpenCreator

Mga kaugnay na proyekto

Proyekto Tungkulin
OpenAI Codex Agent execution engine para sa access sa modelo, reasoning, tool call, session, Skills, at MCP.
yt-dlp Sinusuri ang pampublikong media link, inililista ang format, at nagda-download ng video o audio.
FFmpeg FFmpeg at ffprobe para sa media conversion, komposisyon, pagkuha ng frame, at pagpapatunay ng output.
Whisper, whisper.cpp, faster-whisper at WhisperKit Cloud at lokal na speech transcription ayon sa platform at magagamit na kakayahan ng Runtime.
React Pundasyon ng iisang interface ng Web at Desktop.
Fastify Pundasyon ng HTTP at API ng lokal na Runtime.
Electron Desktop host para sa native system capability, lifecycle ng app, at packaging.
SQLite Lokal na imbakan ng proyekto, usapan, Run, iskedyul, memorya, at ibang datos.
Model Context Protocol Bukas na protocol para ikonekta ang panlabas na tool at serbisyo sa Agent workspace.

OpenCreator · Lumikha nang lokal, magtrabaho nang tuloy-tuloy.