GitHub Hot Board

GitHub Hot Board · Hồ sơ kho lưu trữ

krillinai/OpenCreator

Formerly KrillinAI, VideoTranslation and Dubbing Tool. Open-source AI workspace for creators, powered by Codex. Video downloading, video translation, create videos, images, voice, avatars, and edits with Agents in one place. Suitable for your Social Media like YouTube, TikTok, Instagram, etc. (Mô tả đến từ chính kho lưu trữ.)

Dữ liệu tại October 25krillinai

Thứ hạng tốt nhất

#15

Tuần · TypeScript theo ngôn ngữ

14K

Tổng sao

1.5K

Tổng fork

0

Số ngày có mặt (30 ngày)

Trạng thái dự ánGiấy phép: chưa rõPush gần nhất: chưa rõIssue mở (gồm PR): 0

Thu thập từ 2026-10-25; chưa rõ = chưa thu thập được

Gắn huy hiệu vào README của bạn · krillinai/OpenCreator[![Gắn huy hiệu vào README của bạn](https://git.vaiox.xyz/api/badge/krillinai/OpenCreator.svg)](https://git.vaiox.xyz/vi/repo/krillinai/OpenCreator)
<a href="https://git.vaiox.xyz/vi/repo/krillinai/OpenCreator"><img src="https://git.vaiox.xyz/api/badge/krillinai/OpenCreator.svg" alt="Gắn huy hiệu vào README của bạn" height="20"></a>

Tài liệu dự án

OpenCreator
Không gian làm việc AI mã nguồn mở & Skills dành cho nhà sáng tạo

Kết hợp thiết lập trực quan, Skills tái sử dụng và Agent để viết kịch bản, làm video, hình ảnh, giọng nói, dịch thuật và biên tập trong cùng một không gian làm việc.

OpenCreator trước đây có tên là KrillinAI.

OpenCreator, trước đây là KrillinAI: kho mã đứng đầu ngày trên 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 Nhóm QQ

Điểm nổi bật · Công cụ sáng tạo · Skills · Ví dụ · Bắt đầu · Desktop · Tài liệu · Cộng đồng

Không gian làm việc Agent của OpenCreator

Tổng quan dự án

OpenCreator dành cho cá nhân và nhóm muốn thực hiện công việc sáng tạo và phát triển ngay trên máy. Dự án sử dụng Codex CLI làm bộ máy thực thi, bổ sung Runtime cục bộ ổn định, không gian làm việc trực quan và ứng dụng Desktop, thay vì xây dựng lại vòng lặp Agent.

OpenCreator cung cấp hai cách làm việc kết nối với nhau:

  • Không gian nội dung: dùng công cụ trực quan và mẫu sáng tạo để dịch, tải video; tạo ảnh, video, lời thuyết minh; viết bài và bài đăng mạng xã hội; viết kịch bản video ngắn và làm hoạt hình người que.
  • Hội thoại Agent: giao và hướng dẫn tác vụ sáng tạo hoặc phát triển bằng ngôn ngữ tự nhiên; tổ chức hội thoại theo dự án, để các Run tiếp tục chạy nền và quản lý phê duyệt, tệp đính kèm, tệp, Skills, MCP, lịch chạy, thông báo, bộ nhớ và chẩn đoán tại một nơi.

Web là bản triển khai giao diện duy nhất. Desktop tải cùng bản dựng Web và bổ sung những khả năng cần hệ điều hành như chọn thư mục, vòng đời cửa sổ, khay hệ thống và thông báo gốc. Với cùng dữ liệu và kích thước vùng nội dung, hai nền tảng có cùng giao diện chung và hành vi Runtime.

Điểm nổi bật

  • 🤖 Tích hợp Codex: tái sử dụng vòng lặp Agent, mô hình, suy luận, lệnh gọi công cụ, hội thoại, Skills và MCP của Codex mà không phải duy trì bộ máy thực thi thứ hai.

  • 🚀 Desktop dùng ngay: ứng dụng đã kèm Codex CLI; Runtime cục bộ khởi động khi cần và tự chuẩn bị dự án mặc định.

  • ⚙️ Tái sử dụng cấu hình Codex: lần đầu mở, ứng dụng quét cấu hình Codex cục bộ và đề nghị dùng lại đăng nhập ChatGPT hoặc API key hoạt động. Có biểu mẫu hướng dẫn cho nhà cung cấp khác.

  • 🔄 Quản lý thành phần Runtime: xem phiên bản yt-dlp đi kèm, đang dùng và mới nhất; kiểm tra định kỳ và cập nhật thủ công; giữ phiên bản đang hoạt động nếu cập nhật thất bại.

  • 🎨 Sáng tạo đa phương thức: tạo và quản lý video, ảnh, âm thanh, phụ đề và tài liệu trong một quy trình kết nối.

  • 🧩 Mẫu sáng tạo: bắt đầu tạo ảnh và video từ mẫu tái sử dụng, không phải soạn lại prompt và thiết lập từ đầu.

  • 🔗 Hai cách thao tác: dùng không gian trực quan hoặc hội thoại Agent; máy trạng thái dùng chung đồng bộ các bước, tiến độ và kết quả.

  • 🕘 Quản lý phiên bản: mỗi lần chỉnh sửa tạo phiên bản mới, giữ thiết lập và đầu ra trước đó để xem lại và so sánh.

  • 🧩 Skills tái sử dụng: dùng Skills xử lý video, mở rộng Agent bằng Skills riêng và quản lý MCP qua cấu hình gốc của Codex.

  • 🧠 Bộ nhớ: lưu bộ nhớ toàn cục, theo dự án và luồng, cùng bản tóm tắt và ảnh chụp đầu vào Run có thể tái lập.

  • 🔐 Bảo mật cục bộ: dữ liệu, tệp đính kèm và nhật ký mặc định lưu trên máy, có phê duyệt và chẩn đoán đã che thông tin nhạy cảm.

  • 🌐 Giao diện đa ngôn ngữ: Web và Desktop hỗ trợ 43 ngôn ngữ, nhận diện ngôn ngữ hệ thống, chọn thủ công và bố cục từ phải sang trái cho tiếng Ả Rập, Ba Tư, Urdu và Do Thái.

Công cụ sáng tạo

Bản hiện tại có mười công cụ sáng tạo. Mô hình và dịch vụ khả dụng tùy thuộc môi trường Codex cục bộ và thiết lập dịch vụ AI.

Mở Dashboard để viết bài, bài đăng Xiaohongshu, kịch bản video ngắn; làm hoạt hình người que; dịch hoặc tải video; tạo ảnh thu nhỏ, ảnh, video; và tạo lời thuyết minh với Text to Speech.

Dashboard sáng tạo của OpenCreator

Các công cụ sáng tạo mới tiếp tục được bổ sung.

Dịch video cung cấp 123 ngôn ngữ nguồn và 124 tùy chọn đích, bao gồm đầu ra bính âm. Tìm theo tên bản địa, tên tiếng Anh, tiếng Trung hoặc mã ngôn ngữ. Phạm vi nhận dạng và tổng hợp giọng nói phụ thuộc vào dịch vụ và mô hình đã chọn.

  • Chỉ dịch phụ đề: Nhập và xem trước SRT rồi dịch mà không cần video nguồn, lồng tiếng hay kết xuất video.

  • Chỉnh sửa phụ đề nâng cao: Dùng trình chỉnh sửa toàn màn hình với dạng sóng và dòng thời gian đồng bộ phát lại để chỉnh thời gian, tách hoặc gộp phụ đề và tìm thay thế văn bản. Xem trước kiểu chữ trên video, đổi ngôn ngữ, giọng và đầu ra rồi tạo phiên bản mới, giữ lại kết quả cũ.

  • Tạo trên một trang: Thiết lập tạo ảnh, video và Text to Speech trên một trang với chọn mô hình, xem trước ảnh tham chiếu, tùy chọn ảnh theo mô hình và thư viện giọng nói có tìm kiếm.

  • Đầu ra đa ngôn ngữ và tiến độ: Phông dự phòng tích hợp cải thiện chữ viết phức tạp và phụ đề từ phải sang trái. Theo dõi chép lời, dịch, lồng tiếng và kết xuất, kèm số mục hoàn thành và tổng số khi có.

Không gian làm việc Trạng thái Khả năng
Dịch video✅ Có sẵnNhập video cục bộ hoặc công khai; chép lời bằng Whisper đám mây hoặc cục bộ; dùng ngữ cảnh LLM để phân đoạn, căn chỉnh, xử lý thuật ngữ và dịch phụ đề; cấu hình phụ đề song ngữ, lồng tiếng hoặc mẫu giọng riêng, kiểu phụ đề, bố cục ngang/dọc; xuất SRT, âm thanh hoặc video
Tải video✅ Có sẵnPhân tích từng video công khai từ YouTube, Bilibili, X, TikTok, Instagram, Douyin, Facebook, Xiaohongshu, Pinterest và Reddit; so sánh định dạng và tải video hoặc âm thanh. Một số nguồn cần cookie nền tảng. Khi nền tảng có phụ đề, xem danh sách và tải SRT; ưu tiên tiếng Anh, sau đó là ngôn ngữ giao diện nếu có.
Tạo ảnh thu nhỏ✅ Có sẵnKết hợp chủ đề, liên kết video và ảnh tham chiếu tùy chọn để tạo và so sánh nhiều biến thể ảnh thu nhỏ
Tạo ảnh✅ Có sẵnDùng GPT Image / Seedream / Kling Image / Gemini với prompt và ảnh tham chiếu tùy chọn; đặt tỷ lệ khung hình, số lượng; xem trước và tải từng ảnh
Viết bài✅ Có sẵnBiến chủ đề, liên kết, video hoặc tài liệu nguồn thành các đề tài có thể sửa, dàn ý và bài viết hoàn chỉnh; thêm ảnh được tạo và xuất Markdown, HTML hoặc PDF
Bài đăng Xiaohongshu✅ Có sẵnTạo bài đăng hoàn chỉnh từ chủ đề hoặc tư liệu, điều chỉnh đối tượng, loại bài và độ dài; sao chép hoặc tải kết quả
Kịch bản video ngắn✅ Có sẵnTạo kịch bản chia cảnh sẵn để quay từ chủ đề hoặc tư liệu, theo đối tượng, nền tảng, thời lượng và giọng điệu; sửa, sao chép hoặc tải xuống
Hoạt hình người que✅ Có sẵnBiến văn bản hoặc nội dung YouTube thành lời kể, giọng đọc, hình phân cảnh có nhân vật nhất quán, phụ đề và hoạt hình có thể tải xuống
Cắt clip tự độngĐang phát triểnPhân tích video dài, tìm điểm nổi bật và biến khoảnh khắc được chọn thành clip ngắn tái sử dụng
Text to Speech✅ Có sẵnBiến kịch bản thành lời thuyết minh với lựa chọn giọng, nhịp độ và cảm xúc
Tạo video✅ Có sẵnTạo video bằng Seedance / Kling / Veo từ prompt và ảnh tham chiếu; xem trước, tạo lại và tải từng phiên bản
Nhân vật sốĐang phát triểnKết hợp kịch bản, giọng nói và nhân vật đại diện để tạo video người nói

Mẫu sáng tạo

Bắt đầu từ mẫu thay vì tự xây dựng mọi prompt và thiết lập. Duyệt mẫu nổi bật theo danh mục, gồm tạo video và thiết kế ảnh, để tìm điểm khởi đầu cho ý tưởng.

Bộ sưu tập gồm mẫu do OpenCreator và các nhà sáng tạo độc lập tạo ra. Trang chi tiết của mẫu bên thứ ba ghi công tác giả và dẫn tới nguồn gốc.

Mở mẫu để xem kết quả ví dụ, prompt, thiết lập, thẻ, tác giả và nguồn gốc. Chọn Use this template để bắt đầu, rồi điều chỉnh đầu vào cho công việc của bạn.

Chi tiết mẫu tạo ảnh với kết quả ví dụ, thiết lập và prompt

Skills

Công cụ sáng tạo cung cấp điều khiển trực quan; Skills cung cấp cho Agent hướng dẫn và quy trình công cụ tái sử dụng. Kho mã có Skills sản xuất video và hỗ trợ quản lý Skills Codex cục bộ.

Thư mục skills/ chứa hướng dẫn tái sử dụng cho Agent vận hành KrillinAI CLI được nhúng.

Skill Khả năng
KrillinAI CLI Chọn lệnh, kiểm tra cấu hình, đọc tiến độ, manifest, đầu ra và lỗi
Phụ đề Tải phụ đề nền tảng hoặc chép lời, dịch phụ đề, tạo phụ đề song ngữ hoặc phụ đề ngắn cho video dọc
TTS Tạo lồng tiếng ngôn ngữ đích từ phụ đề và tùy chọn tạo video đã lồng tiếng
Kết xuất ngang Kết xuất video ngang có phụ đề song ngữ hoặc âm thanh lồng tiếng và phụ đề ngôn ngữ đích
Kết xuất dọc Dựng video dọc có tiêu đề, phụ đề song ngữ hoặc lồng tiếng
Ảnh bìa Tạo ảnh bìa từ prompt văn bản đầy đủ, lưu ảnh và prompt cuối cùng
Kế hoạch quy trình Kiểm tra kế hoạch đầu ra nhiều giai đoạn ở chế độ dry-run; thực thi qua từng Skill của giai đoạn

Mở rộng bằng Skills của bạn

OpenCreator hỗ trợ Skills Codex cục bộ được định nghĩa bằng SKILL.md, cho phép thêm phương pháp và quy trình riêng. Skills khả dụng tùy thuộc Codex home đang dùng và Skills đã cài; Skills video cần cấu hình CLI và dịch vụ liên quan. Có trong kho mã không có nghĩa mọi Skill tự được cài hoặc mọi dịch vụ ngoài đều đi kèm.

Hội thoại và không gian làm việc đồng hành

Mô tả tác vụ tự nhiên, rồi dùng công cụ trực quan khi cần điều khiển chính xác.

Hội thoại và không gian trực quan OpenCreator phối hợp

Điều khiển chi tiết

Điều chỉnh chính xác phụ đề, cảnh quay, âm thanh và thiết lập tạo nội dung.

Chỉnh sửa qua hội thoại

Nói cho Agent điều cần thay đổi và tinh chỉnh kết quả bằng ngôn ngữ tự nhiên.

Trạng thái đồng bộ

Hội thoại và không gian làm việc dùng chung trạng thái tác vụ, không cần lặp lại thông tin.

Phiên bản độc lập

Mỗi lần sửa tạo phiên bản riêng, không ghi đè kết quả hoặc thiết lập trước đó.

Mô hình được hỗ trợ

Mô hình ngôn ngữ theo danh mục Codex hoặc nhà cung cấp tương thích OpenAI của bạn. Mô hình ảnh, video, giọng nói và chép lời dùng dịch vụ cấu hình tại Settings → AI Services.

Các nhà cung cấp và mô hình hiển thị là ví dụ; khả dụng thực tế tùy thông tin xác thực, quyền tài khoản và nền tảng.

Mô hình ngôn ngữ

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

Hình ảnh

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

Giọng nói và chép lời

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

Chép lời cục bộ cũng hỗ trợ faster-whisper, WhisperKit và whisper.cpp khi có sẵn.

Ví dụ

Dịch video

Các ví dụ công khai dưới đây được tạo khi OpenCreator còn tên KrillinAI. Chúng thể hiện quy trình căn chỉnh phụ đề, dịch, lồng tiếng và video dọc đã được kiểm chứng, nay được đưa vào quy trình Agent rộng hơn qua không gian Dịch video.

Dự án tạo tệp phụ đề bên dưới từ video cục bộ dài 46 phút trong một lần chạy, không sửa phụ đề thủ công. Kết quả công bố phủ đủ nội dung, không chồng dòng, phân đoạn tự nhiên và bản dịch chất lượng cao.

Ví dụ căn chỉnh phụ đề OpenCreator

Dịch phụ đề

subtitle_translation.mp4

Lồng tiếng

tts.mp4

Chế độ dọc

agi.mp4

Các video ví dụ và ảnh căn chỉnh phụ đề được tạo khi OpenCreator còn dùng tên KrillinAI.

Tải video

Phân tích liên kết video công khai từ 10 nền tảng hỗ trợ, so sánh định dạng và tải video hoặc âm thanh thẳng vào dự án.

Nguồn video hỗ trợ:

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

Khả dụng tùy video và khu vực; một số nguồn cần cookie nền tảng.

Chọn định dạng trong trình tải video OpenCreator

Tạo video

Tạo video AI từ prompt văn bản hoặc ảnh tham chiếu bằng Seedance. Đặt mô hình, tỷ lệ, độ phân giải và thời lượng, rồi xem trước, tạo lại hoặc tải từng phiên bản trong không gian dự án.

Tạo video OpenCreator bằng Seedance

Hoạt hình người que

OpenCreator phát triển bộ nhân vật gốc này cùng họa sĩ Harbor Hsia, tác giả Stickman trên Behance. Bộ nhân vật tích hợp giữ danh tính nhân vật nhất quán suốt quy trình hoạt hình.

Nhân vật người que OpenCreator hợp tác cùng họa sĩ

Biến văn bản hoặc nội dung YouTube thành hoạt hình hoàn chỉnh qua quy trình hướng dẫn: duyệt kịch bản, lời kể, thời gian, hình phân cảnh, phụ đề, kết xuất và video tải xuống.

Khung hình ví dụ hoạt hình người que OpenCreator

Bắt đầu nhanh

Cài ứng dụng Desktop

Tải bộ cài phù hợp từ bản OpenCreator mới nhất cho macOS Apple Silicon, macOS Intel hoặc Windows x64. Cài và mở ứng dụng; không cần Node.js hay pnpm. Gói Desktop có Codex CLI; tác vụ mô hình thực cần đăng nhập ChatGPT hoặc cấu hình API key dùng được.

Lần đầu mở, Desktop khởi động Runtime cục bộ, chuẩn bị dự án mặc định và kiểm tra cấu hình Codex. Nếu tìm thấy đăng nhập hoặc API key và thiết lập mô hình dùng được, chọn Use local Codex and continue để dùng lại. Bạn cũng có thể cấu hình nhà cung cấp khác ngay trong bước này:

Thiết lập nhà cung cấp mô hình khi mở Desktop lần đầu

Sau thiết lập, nhập yêu cầu vào ô soạn để bắt đầu. Khi gặp lỗi, xem hướng dẫn sử dụng và xử lý sự cố.

Chạy Web từ mã nguồn

Để phát triển hoặc dùng qua trình duyệt, cài:

  • Node.js 22 trở lên
  • pnpm 9.15.0, được cố định qua trường packageManager của kho mã
  • Tệp thực thi Codex CLI có thể gọi từ terminal
  • Đăng nhập Codex CLI hợp lệ cho tác vụ mô hình thực

Kiểm tra môi trường cục bộ trước:

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

Mở http://127.0.0.1:19861/. Máy chủ phát triển khởi động daemon khi cần và chèn token Runtime tạm thời qua proxy cùng nguồn; không phải sao chép token thủ công.

Lần đầu mở, Runtime chuẩn bị dự án mặc định và kiểm tra thiết lập Codex. Xác nhận đăng nhập ChatGPT hoặc API key hiện có để dùng Codex cục bộ, hoặc chọn nhà cung cấp rồi nhập mô hình, endpoint và API key. Ô soạn sẵn sàng sau thiết lập. Để chỉ làm việc với daemon:

pnpm daemon:dev

Daemon chỉ lắng nghe địa chỉ loopback và in địa chỉ kết nối cùng token tạm thời ra stdout một lần.

Desktop

Desktop và trình duyệt dùng cùng giao diện React từ apps/web. Dự án, hội thoại, tác vụ và thiết lập chung gọi cùng Daemon/API. Electron chỉ thêm đường dẫn hệ thống thực, điều khiển cửa sổ, khay hệ thống và thông báo gốc.

Chế độ phát triển

pnpm desktop:dev

Đóng gói cục bộ

Lệnh Đầu ra
pnpm desktop:package Thư mục chạy được cho nền tảng hiện tại, phục vụ kiểm tra cục bộ
pnpm desktop:dist Bộ cài cho nền tảng hiện tại
pnpm desktop:release Lệnh đóng gói phát hành chính thức
pnpm --filter @opencreator/desktop verify:package Kiểm tra gói Desktop đã có
pnpm krillinai:package Các tệp nén KrillinAI Server và CLI riêng cho nền tảng đã chọn

Đóng gói Desktop dựng lại Web từ không gian hiện tại, ghi commit, trạng thái thay đổi chưa commit, nền tảng, kiến trúc và hash Web; so sánh apps/web/dist với tài nguyên nhúng trong ứng dụng. Khác nhau sẽ làm đóng gói thất bại. Xem quy trình phát hành Desktop về ký, notarization, bản Windows và yêu cầu phát hành.

Quy trình chính

Hội thoại và Run

  1. Chọn dự án hoặc bắt đầu hội thoại mới.
  2. Nhập tác vụ, chọn mức quyền, Profile, mô hình và mức suy luận.
  3. Khi Run đang chạy, xếp hàng tác vụ tiếp theo hoặc ngắt và tiếp tục ngay.
  4. Dùng Timeline để xem tóm tắt suy luận, lệnh gọi công cụ, thay đổi tệp, phê duyệt và kết quả cuối.
  5. Dùng trung tâm tác vụ để theo dõi toàn cục tác vụ đang chạy, hoàn tất, thất bại hoặc chờ phê duyệt.

Skills và MCP

  • Duyệt chợ Skills, lịch sử cài đặt và Skills cục bộ trong trung tâm plugin.
  • Chọn Skill qua / hoặc menu thêm trong ô soạn để tác vụ tiếp theo theo quy trình đó.
  • Quản lý MCP qua lệnh và cấu hình gốc của Codex, không duy trì bộ máy thực thi thứ hai.
  • Mặc định dùng $CODEX_HOME đang hoạt động; kiểm tra ảnh hưởng trước khi đổi Skills toàn cục hoặc cấu hình MCP.

Lịch chạy và luồng tác vụ riêng

  • Mỗi lịch chạy có một hội thoại OpenCreator riêng được lưu lâu dài.
  • Kích hoạt tự động, chạy thủ công và yêu cầu tiếp theo dùng lại hội thoại đó, chạy tuần tự theo chính sách queue hoặc skip.
  • Xóa lịch sẽ lưu trữ hội thoại riêng, giữ Run, kết quả và lịch sử Codex bên dưới.
  • Đổi hoặc khôi phục luồng Codex bên dưới không đổi mục tác vụ OpenCreator hoặc đường dẫn trang.

Kiến trúc hệ thống OpenCreator

Không gian trực quan và hội thoại Agent là hai giao diện của cùng tác vụ sáng tạo. Mỗi quy trình được mô hình hóa thành máy trạng thái với đầu vào, cấu hình, tạo nội dung, duyệt, sửa và xuất dưới dạng trạng thái và sự kiện rõ ràng. Thao tác trực quan và lệnh hội thoại đi vào cùng máy trạng thái; bước hiện tại, cấu hình, tiến độ, phiên bản và kết quả hiển thị lại ở cả hai giao diện, giữ đồng bộ với một nguồn trạng thái duy nhất.

Sáng tạo cần lặp lại; chỉnh sửa không ghi đè kết quả hiện tại. Mỗi lần sửa hoặc tạo lại sinh phiên bản mới từ trạng thái quy trình hiện có, giữ thiết lập và đầu ra cũ để xem lại, so sánh và tiếp tục tinh chỉnh.

+-----------------------------+     +------------------------------------+
| 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   |
+---------------------+  +---------------------+  +-------------------------+
Thành phần OpenCreator Trách nhiệm Triển khai
Trải nghiệm sáng tạo Dashboard, công cụ, hội thoại Agent, thiết lập và tệp apps/web · React 18 · Vite · TypeScript
Lõi cộng tác Đồng bộ bước, ngữ cảnh hội thoại, tiến độ, kết quả và chỉnh sửa Trạng thái quy trình chung · CreatorCollaborationPanel · lịch sử phiên bản
Runtime cục bộ Quản lý dự án, Run, phê duyệt, lịch chạy, bộ nhớ và thông báo apps/daemon · Fastify · Runtime API · SSE
Thành phần Runtime Theo dõi bản đi kèm, đang dùng, mới nhất; kiểm tra định kỳ, chỉ cài khi người dùng yêu cầu yt-dlp nightly · xác minh cập nhật · quay về bản hoạt động
Bộ máy Codex Cung cấp vòng lặp Agent, phiên, suy luận, công cụ, Skills và MCP Codex CLI · app-server
Chuỗi công cụ media Tải, chép lời, chuyển đổi, tạo và xuất media yt-dlp · Whisper · FFmpeg · dịch vụ AI đã cấu hình
Dữ liệu cục bộ Lưu dự án, Run, tệp đính kèm, đầu ra và thông tin xác thực trên máy SQLite · hệ thống tệp · kho thông tin xác thực hệ thống
Desktop Host Tải bản dựng Web chung, bổ sung khả năng hệ điều hành apps/desktop · Electron · Preload Bridge

Nguyên tắc chính:

  • Không gian làm việc và hội thoại Agent hiển thị cùng trạng thái quy trình và gửi sự kiện vào cùng máy trạng thái.
  • Chỉnh sửa tạo phiên bản mới, giữ ngữ cảnh và đầu ra của mỗi lần lặp sáng tạo.
  • Frontend không khởi động Codex trực tiếp và không phụ thuộc định dạng sự kiện Codex JSONL thô.
  • Daemon quản lý vòng đời tiến trình, chuẩn hóa sự kiện, lưu trữ, phê duyệt, lịch và hộp thư thông báo đi.
  • Codex là nguồn thực thi chuẩn cho vòng lặp Agent, Skills và MCP.
  • Browser Bridge và Desktop Bridge không triển khai hai bản logic sản phẩm chung.

Cấu trúc kho mã

OpenCreator/
├── apps/
│   ├── web/          # Giao diện React duy nhất
│   ├── daemon/       # Runtime Fastify cục bộ và bộ chuyển đổi Codex
│   ├── desktop/      # Electron Main, Preload, tính năng gốc và đóng gói
│   └── harness/      # Công cụ dòng lệnh kiểm tra Runtime
├── packages/
│   ├── protocol/     # Hợp đồng Runtime chung cho Web, Daemon và Desktop
│   └── skill-market/ # Mô hình chợ Skills và logic dùng chung
├── docs/             # Tài liệu thiết kế, API, vận hành và báo cáo kiểm thử
├── scripts/          # Kiểm tra cấp kho mã
└── .runtime/         # Dữ liệu Runtime cục bộ, tạo khi mở lần đầu

Cấu hình

API key dịch vụ AI

Mở Settings → AI Services để cấu hình nhà cung cấp mô hình, chép lời, giọng nói và ảnh cho các không gian hiện tại. Có thể có thêm danh mục chuẩn bị cho công cụ sắp ra mắt. Mỗi danh mục chỉ hiển thị trường nhà cung cấp đã chọn cần: Base URL, API Key, mô hình, proxy hoặc thông tin xác thực riêng.

Thiết lập API key dịch vụ AI OpenCreator

Thông tin xác thực lưu qua kho thông tin xác thực hệ thống của Runtime cục bộ, không bao giờ đưa vào kho mã. Một số nhà cung cấp cục bộ hoặc dựa trên hệ thống như Edge TTS không cần API Key.

Tài khoản và gói đăng ký

Trung tâm cá nhân hiển thị tài khoản, gói đã xác nhận và tín dụng khả dụng. Đăng nhập mở https://www.open-creator.ai/device trong trình duyệt. Đăng nhập trên web rồi phê duyệt thiết bị; Daemon cục bộ nhận phiên riêng. Trình duyệt và ứng dụng dùng chung tài khoản, nhưng có phiên độc lập.

Chọn gói trong OpenCreator. Mua mở Stripe Checkout; quản lý gói mở Stripe Billing Portal. Quay lại ứng dụng sau thanh toán dùng trang /billing/return, không cần phiên web. OpenCreator cập nhật quyền lợi từ Gateway sau thông báo Stripe đã xác minh. Trang /pricing và /account là lối mua khác tới cùng hệ thống đăng ký.

Thành phần Runtime bên thứ ba

Mở Settings → Third-party Components để xem bản yt-dlp nightly đang dùng, bản kèm ứng dụng, nguồn và bản mới nhất. OpenCreator kiểm tra mỗi bảy ngày, không tự cài. Cập nhật cần người dùng yêu cầu; bản hoạt động hiện tại vẫn dùng được nếu tải, xác minh hoặc cài đặt thất bại.

Thiết lập thành phần bên thứ ba OpenCreator

Biến môi trường Runtime

Phần lớn người dùng không cần biến môi trường. Dùng khi cần tách dữ liệu, chỉ định tệp Codex hoặc thư mục dự án được quản lý:

Biến môi trường Mặc định Mục đích
OPENCREATOR_DATA_DIR .runtime Cơ sở dữ liệu OpenCreator, Run, tệp đính kèm và không gian được quản lý
OPENCREATOR_GATEWAY_ORIGIN https://www.open-creator.ai Gateway đăng nhập, đăng ký, tín dụng và dịch vụ mô hình chính thức; ghi đè để dùng Gateway cục bộ
OPENCREATOR_CODEX_BIN codex Đường dẫn tệp thực thi Codex CLI
CODEX_HOME ~/.codex Nguồn chuẩn cho phiên Codex, cấu hình, Skills, MCP và Profiles
OPENCREATOR_DEFAULT_CWD Thư mục làm việc hiện tại Thư mục làm việc mặc định của daemon
OPENCREATOR_DEFAULT_PROJECT_ROOT Chính sách mặc định Runtime Thư mục gốc dự án được quản lý; khi đặt, dùng thư mục con OpenCreator/
OPENCREATOR_CODEX_THREAD_ROTATION_RUN_THRESHOLD 50 Số Run kết thúc để đổi luồng Codex của lịch chạy dài hạn; 0 tắt đổi chủ động

Ví dụ tách dữ liệu Runtime và môi trường Codex:

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

Dữ liệu và bảo mật

Dữ liệu Runtime mặc định lưu tại .runtime/ ở gốc kho mã:

Đường dẫn Nội dung
.runtime/app.sqlite Dự án, luồng, Run, sự kiện, lịch, thông báo, siêu dữ liệu tệp đính kèm, phê duyệt, bộ nhớ và tóm tắt
.runtime/runs/ Nhật ký đã che dữ liệu nhạy cảm, chẩn đoán và siêu dữ liệu từng Run
.runtime/attachments/ Tệp đính kèm có kiểm soát
.runtime/workspaces/ Không gian dự án do Runtime quản lý

Phiên và cấu hình Codex vẫn ở $CODEX_HOME; cần sao lưu riêng với .runtime/.

Các ranh giới bảo mật:

  • Daemon chỉ lắng nghe 127.0.0.1; mọi API trừ kiểm tra sức khỏe đều cần Bearer token.
  • Xem trước HTML mặc định tắt script, điều hướng và popup; chỉ cho tài nguyên tương đối được kiểm soát trong cùng không gian.
  • Bộ nhớ nhạy cảm cần xác nhận lần hai. Không tự lưu vĩnh viễn đề xuất chưa xác nhận.
  • Chẩn đoán và nhật ký Run được che thông tin nhạy cảm trước khi trả về hoặc xuất.
  • Gói Desktop bật toàn vẹn ASAR và mã hóa cookie; tắt RunAsNode, NODE_OPTIONS và Node CLI Inspector.

Xem hướng dẫn sử dụng và xử lý sự cố để biết đầy đủ cách sao lưu, khôi phục, dọn dẹp và đặt lại.

Phát triển

Lệnh thường dùng

Lệnh Mục đích
pnpm web:dev Khởi động Web, chạy daemon cục bộ khi cần
pnpm daemon:dev Chỉ khởi động daemon
pnpm desktop:dev Dựng các phụ thuộc và khởi động Electron ở chế độ phát triển
pnpm test Chạy kiểm thử đơn vị và tích hợp
pnpm typecheck Kiểm tra TypeScript toàn kho mã
pnpm build Dựng mọi workspace
pnpm e2e Chạy kiểm thử Web Playwright E2E
pnpm smoke:ci Chạy kiểm tra nhanh Runtime với Codex giả lập
pnpm perf:check Kiểm tra mốc hiệu năng đã ghi

Trước khi gửi thay đổi, chọn kiểm tra phù hợp ảnh hưởng theo hướng dẫn đóng góp. Tài liệu, nội dung và kiểu dáng chỉ cần kiểm tra liên quan; hành vi chung và Runtime cần kiểm thử mô-đun và typecheck có mục tiêu. Chạy toàn bộ kiểm thử hoặc build khi phạm vi yêu cầu, ghi kiểm tra đã chạy trong PR.

Thay đổi Desktop, Host Bridge, proxy Runtime hoặc quy trình giao diện chung còn cần kiểm tra nhất quán Web/Desktop, E2E ứng dụng đóng gói và hash bản dựng Web. Chỉ kiểm thử đơn vị Web chưa đủ chứng minh sẵn sàng phát hành Desktop.

Kiểm tra nhanh với Codex thật mặc định tắt. Bật rõ ràng bằng:

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

Tài liệu

Quy ước dịch thuật

README.md ở gốc là bản tiếng Anh chuẩn. Bản dịch được duy trì tại docs/<locale>/README.md. Chỉ thêm ngôn ngữ vào bộ chuyển đổi sau khi đã dịch toàn bộ tài liệu và đồng bộ cấu trúc với bản tiếng Anh.

Cộng đồng

Người dùng GitHub từ ít nhất 105 quốc gia và vùng lãnh thổ đã gắn sao OpenCreator.

Bản đồ quốc gia và vùng lãnh thổ có người gắn sao OpenCreator trên GitHub

Nhóm phụ trách

Mỗi thành viên phụ trách tiêu chuẩn, xét duyệt và hợp nhất đóng góp, cùng hỗ trợ cộng đồng trong lĩnh vực của mình.

wulien avatar
wulien
Mã nguồn & sửa lỗi
DLe-kb avatar
DLe-kb
Mẫu sáng tạo
xiaheyuan avatar
xiaheyuan
Thiết kế & tài nguyên
krillinai avatar
krillinai
Skills & tài liệu
hbxugang avatar
hbxugang
Triển khai doanh nghiệp

Người đóng góp

Cảm ơn mọi người đã đóng góp mã nguồn, tài liệu, phản hồi, báo lỗi, Skills, minh họa và ý tưởng. Danh sách README này được quản lý riêng với biểu đồ Contributors tự động của 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

Đóng góp

Chào đón đóng góp trong các lĩnh vực:

Loại Nội dung Vị trí Quy mô
Mã nguồn Sửa lỗi, quy trình sáng tạo, tính năng chung apps/web/, apps/daemon/ Một PR tập trung kèm kiểm thử
Skills Quy trình Agent tái sử dụng skills/ Một thư mục có SKILL.md và tài liệu tham khảo tùy chọn → hướng dẫn
Mẫu sáng tạo Mẫu ảnh, video hoặc ảnh bìa tái sử dụng template/ Một thư mục có template.json và tài nguyên → hướng dẫn
Minh họa và thiết kế Minh họa, biểu tượng hoặc thiết kế UI gốc Vị trí tài nguyên đã thống nhất Một PR có bản xem trước, tệp nguồn và giấy phép
Tích hợp bên thứ ba Hỗ trợ nhà cung cấp AI hoặc media Mô-đun Web hoặc Daemon liên quan Một PR xử lý lỗi, bảo vệ thông tin xác thực và có kiểm thử
Tài liệu và bản dịch Cải thiện tài liệu hoặc thêm ngôn ngữ README.md, docs/, docs/<locale>/ Một PR

Hướng dẫn đầy đủ về thiết lập cục bộ, tiêu chí duyệt và các lý do thường bị từ chối nằm ở CONTRIBUTING.md, có 10 ngôn ngữ.

Lịch sử sao

OpenCreator trước đây có tên KrillinAI. Biểu đồ bao gồm toàn bộ lịch sử kho mã trước và sau đổi tên.

Lịch sử sao OpenCreator

Dự án liên quan

Dự án Vai trò
OpenAI Codex Bộ máy Agent cung cấp truy cập mô hình, suy luận, lệnh gọi công cụ, phiên, Skills và tích hợp MCP.
yt-dlp Kiểm tra liên kết media công khai, liệt kê định dạng và tải video hoặc âm thanh cho quy trình sáng tạo.
FFmpeg FFmpeg và ffprobe xử lý chuyển đổi media, dựng, trích khung hình và xác minh đầu ra.
Whisper, whisper.cpp, faster-whisper và WhisperKit Tùy chọn chép lời đám mây và cục bộ theo nền tảng, lựa chọn theo khả năng Runtime.
React Nền tảng giao diện chung của Web và Desktop.
Fastify Nền tảng HTTP và API của Runtime cục bộ.
Electron Desktop host cung cấp khả năng hệ thống gốc, vòng đời ứng dụng và đóng gói.
SQLite Lưu trữ cục bộ dự án, hội thoại, Run, lịch, bộ nhớ và dữ liệu khác.
Model Context Protocol Giao thức mở kết nối công cụ và dịch vụ bên ngoài với không gian Agent.

OpenCreator · Sáng tạo trên máy, làm việc liên tục.

Thứ hạng hiện tại

Diễn biến 30 ngày

Không có bản ghi nào trong 30 ngày qua.

← Về bảng xếp hạng