GitHub Hot Board

GitHub Hot Board · Arquivo do repositório

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. (Esta descrição vem do próprio repositório.)

Dados de October 25krillinai

Melhor colocação

#15

Semanal · TypeScript por idioma

14K

Total de estrelas

1.5K

Total de forks

0

Dias nos rankings (30 d)

Estado do projetoLicença: desconhecidoÚltimo push: desconhecidoIssues abertos (PR incl.): 0

Coletado desde 2026-10-25; desconhecido = ainda não coletado

Coloque o emblema no seu README · krillinai/OpenCreator[![Coloque o emblema no seu README](https://git.vaiox.xyz/api/badge/krillinai/OpenCreator.svg)](https://git.vaiox.xyz/pt/repo/krillinai/OpenCreator)
<a href="https://git.vaiox.xyz/pt/repo/krillinai/OpenCreator"><img src="https://git.vaiox.xyz/api/badge/krillinai/OpenCreator.svg" alt="Coloque o emblema no seu README" height="20"></a>

Documentação do projeto

OpenCreator
O espaço de trabalho de IA open source e Skills para criadores

Reúna ferramentas visuais de criação, Skills reutilizáveis e Agents para roteiros, vídeos, imagens, voz, avatares, tradução e edição — tudo em um único espaço de trabalho.

O OpenCreator se chamava anteriormente KrillinAI.

OpenCreator (anteriormente KrillinAI): repositório n.º 1 do dia no 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 QQ

Destaques · Ferramentas · Skills · Exemplos · Começar · Desktop · Docs · Comunidade

Espaço de trabalho Agent do OpenCreator

Visão geral do projeto

O OpenCreator foi criado para pessoas e equipes que desejam manter o trabalho criativo e de desenvolvimento em execução local. Em vez de reimplementar um loop de Agent, ele usa o Codex CLI como mecanismo de execução e acrescenta um Runtime local estável, um espaço de trabalho visual e um host Desktop.

O OpenCreator oferece duas formas de trabalho conectadas:

  • Espaço de trabalho de conteúdo: use ferramentas visuais e modelos de criação para traduzir e baixar vídeos, gerar miniaturas e imagens e realizar outras tarefas criativas.
  • Conversa com o Agent: inicie e conduza tarefas criativas ou de desenvolvimento em linguagem natural, organize conversas por projeto, mantenha Runs em segundo plano e gerencie aprovações, anexos, arquivos, Skills, MCP, agendamentos, notificações, memória e diagnósticos em um só lugar.

Web é a única implementação do frontend. Desktop carrega a mesma compilação Web e adiciona somente os recursos que exigem o sistema operacional, como seleção de diretórios, ciclo de vida das janelas, comportamento da bandeja e notificações nativas. Com os mesmos dados e o mesmo viewport de conteúdo, as duas plataformas compartilham a mesma interface geral e o mesmo comportamento do Runtime.

Destaques do projeto

  • 🤖 Nativo do Codex: reutilize o loop de Agent, os modelos, o raciocínio, as chamadas de ferramentas, as conversas, Skills e MCP do Codex sem manter um segundo mecanismo de execução.

  • 🚀 Aplicativo Desktop pronto para uso: inicie o OpenCreator diretamente pelo aplicativo Desktop, que inclui o Codex CLI; o Runtime local inicia sob demanda e prepara automaticamente um projeto padrão.

  • ⚙️ Detecção da configuração local do Codex: na primeira abertura, o Desktop verifica a configuração existente e oferece a opção de reutilizar um login do ChatGPT ou uma chave de API válida. Outros provedores de modelos podem ser configurados no assistente inicial.

  • 🔄 Componentes de Runtime gerenciados: consulte as versões incluída, ativa e mais recente do yt-dlp, verifique atualizações periodicamente e atualize manualmente, mantendo a versão atual disponível se uma atualização falhar.

  • 🎨 Criação multimodal: crie e gerencie vídeos, imagens, áudio, legendas e documentos por meio de um único fluxo de trabalho conectado.

  • 🧩 Modelos de criação: crie imagens e vídeos a partir de modelos reutilizáveis sem preparar prompts e configurações do zero.

  • 🔗 Fluxo de trabalho em dois modos: trabalhe pelo espaço de trabalho visual ou por uma conversa com o Agent, enquanto uma máquina de estados compartilhada mantém etapas, progresso e resultados sincronizados.

  • 🕘 Versionamento: cada revisão cria uma nova versão e preserva as configurações e os resultados anteriores para análise e comparação.

  • 🧩 Skills reutilizáveis: use Skills de fluxo de trabalho de vídeo, amplie o Agent com seus próprios Skills e gerencie MCP pela configuração nativa do Codex.

  • 🧠 Memória: mantenha memória global, por projeto e por thread, com resumos e snapshots reproduzíveis das entradas de Run.

  • 🔐 Segurança local: mantenha dados, anexos e logs localmente por padrão, com aprovações e diagnósticos que ocultam informações confidenciais.

  • 🌐 Interface multilíngue: Web e Desktop oferecem 43 idiomas, detecção do idioma do sistema, seleção manual e layout da direita para a esquerda para árabe, persa, urdu e hebraico.

Ferramentas de criação

A versão atual inclui seis ferramentas de criação. Os modelos e serviços disponíveis dependem do seu ambiente local do Codex e das configurações dos serviços de IA.

Abra o Dashboard para traduzir ou baixar vídeos, gerar miniaturas ou imagens, criar locuções com Text to Speech ou gerar vídeos com Seedance.

Dashboard de criação do OpenCreator

Novas ferramentas de criação são adicionadas continuamente.

A tradução de vídeos oferece 123 idiomas de origem e 124 opções de destino, incluindo saída em pinyin. Pesquise pelo nome nativo, inglês, chinês ou código do idioma. A cobertura do reconhecimento e da síntese de voz depende do serviço e modelo escolhidos.

  • Tradução apenas de legendas: Importe e visualize um SRT e traduza sem vídeo de origem, dublagem ou renderização de vídeo.

  • Edição avançada de legendas: Use um editor imersivo com forma de onda e linha do tempo sincronizadas com a reprodução para ajustar tempos, dividir ou unir legendas e localizar e substituir texto. Visualize estilos no vídeo, ajuste idioma, voz e saída e gere uma nova versão preservando as anteriores.

  • Criação em uma página: Configure geração de imagens, vídeos e Text to Speech em uma página, com seleção de modelos, prévia de referências, opções de imagem por modelo e biblioteca de vozes com busca.

  • Saída multilíngue e progresso: Fontes alternativas incluídas melhoram escritas complexas e legendas da direita para a esquerda. Acompanhe transcrição, tradução, dublagem e renderização com contagens concluídas e totais quando disponíveis.

Ferramenta Status Recursos
Tradução de vídeos✅ DisponívelImporte vídeos locais ou públicos; transcreva com serviços Whisper locais ou na nuvem; use o contexto de um LLM para segmentar e alinhar legendas, gerenciar terminologia e traduzir; configure legendas bilíngues, dublagem ou uma amostra de voz personalizada, estilos de legenda e composição horizontal ou vertical, e exporte SRT, áudio ou vídeo
Download de vídeos✅ DisponívelAnalise vídeos públicos individuais do YouTube, Bilibili, X, TikTok, Instagram, Douyin, Facebook, Xiaohongshu, Pinterest e Reddit; compare os formatos disponíveis e baixe vídeo ou áudio. Algumas plataformas podem exigir cookies. Quando a plataforma oferece legendas, consulte a lista e baixe SRT; o inglês aparece primeiro, seguido pelo idioma da interface quando disponível.
Geração de miniaturas✅ DisponívelCombine um tema, um link de vídeo e uma imagem de referência opcional para gerar e comparar várias opções de miniaturas de conteúdo
Geração de imagens✅ DisponívelGere imagens com GPT Image / Seedream / Kling Image / Gemini a partir de um prompt e de uma imagem de referência opcional, configure a proporção e a quantidade de resultados e depois visualize e baixe cada imagem
Redação de artigos✅ DisponívelTransforme temas, links, vídeos ou documentos em opções de tema, esboço e artigo editáveis; adicione imagens e exporte Markdown, HTML ou PDF.
Posts do Xiaohongshu✅ DisponívelCrie posts a partir de temas ou materiais com controles de público, tipo e tamanho; copie ou baixe o resultado.
Roteiro para vídeo curto✅ DisponívelCrie um roteiro segmentado pronto para gravar a partir de um tema ou material, ajustado ao público, plataforma, duração e tom; edite ou exporte.
Animação de bonecos palito✅ DisponívelTransforme texto ou conteúdo do YouTube em narração, voz, imagens de storyboard com personagens consistentes, legendas e uma animação para download.
Clipes automáticosEm desenvolvimentoAnalise vídeos longos, identifique destaques e transforme os momentos escolhidos em clipes curtos reutilizáveis
Text to Speech✅ DisponívelTransforme roteiros em locuções com opções de voz e controles de ritmo e emoção
Geração de vídeo✅ DisponívelGere vídeos com Seedance / Kling / Veo a partir de prompts e imagens de referência e depois visualize, gere novamente ou baixe cada versão
Avatar digitalEm desenvolvimentoCombine roteiros, voz e apresentação de avatar para produzir vídeos de pessoas falando

Modelos de criação

Comece a criar a partir de um modelo, sem precisar preparar cada prompt e configuração do zero. Explore os modelos em destaque por categoria, incluindo criação de vídeos e design de imagens.

A coleção reúne modelos originais do OpenCreator e de criadores independentes. Para modelos de terceiros, a página de detalhes identifica o autor e inclui um link para a fonte original.

Abra um modelo para visualizar um resultado de exemplo e consultar prompt, configurações, tags, autor e fonte original. Selecione Usar este modelo para começar a criar e ajuste as entradas para o seu projeto.

Detalhes de um modelo de imagem com resultado de exemplo, configurações e prompt

Skills

As ferramentas de criação oferecem controles visuais; os Skills fornecem ao Agent instruções e fluxos de trabalho reutilizáveis. O OpenCreator inclui Skills de produção de vídeo no repositório e oferece suporte ao gerenciamento de Skills locais do Codex.

O diretório skills/ do repositório contém instruções reutilizáveis para Agents que operam a CLI integrada do KrillinAI.

Skill Recursos
KrillinAI CLI Escolher comandos, verificar a configuração e interpretar progresso, manifestos, saídas e erros
Legendas Baixar legendas das plataformas ou transcrever mídia, traduzir legendas e produzir legendas bilíngues ou curtas para vídeos verticais
TTS Gerar dublagem no idioma de destino a partir de legendas e, opcionalmente, produzir um vídeo dublado
Renderização horizontal Renderizar vídeos horizontais com legendas bilíngues ou áudio dublado e legendas no idioma de destino
Renderização vertical Compor vídeos verticais com títulos, legendas bilíngues ou dublagem
Capa Gerar uma imagem de capa a partir de um prompt de texto completo e salvar a imagem e o prompt final
Planejamento do pipeline Validar um plano de saídas de várias etapas no modo dry-run; executar o trabalho real pelos Skills de cada etapa

Amplie com seus próprios Skills

O OpenCreator oferece suporte a Skills locais do Codex definidos por SKILL.md, permitindo adicionar seus próprios métodos e fluxos de trabalho sem depender apenas de ferramentas de criação fixas. A disponibilidade depende do Codex home ativo e dos Skills instalados; os Skills de vídeo exigem a configuração da CLI e dos serviços relacionados. A inclusão de um Skill no repositório não significa que ele será instalado automaticamente nem que todos os serviços externos estão incluídos.

Conversa e espaço de trabalho avançam juntos

Descreva as tarefas naturalmente e passe para as ferramentas visuais sempre que precisar de controle preciso.

Os provedores e modelos mostrados são exemplos; a disponibilidade real depende de credenciais, acesso da conta e plataforma.

Controles detalhados do espaço de trabalho

Ajuste com precisão legendas, cenas, áudio e configurações de geração.

Edições flexíveis por conversa

Diga ao Agent o que deve mudar e refine o resultado em linguagem natural.

Estado sincronizado

A conversa e o espaço de trabalho compartilham o estado da tarefa atual, sem necessidade de repetir informações.

Versões independentes

Cada revisão cria uma versão separada sem sobrescrever resultados ou configurações anteriores.

Modelos compatíveis

A disponibilidade dos modelos de linguagem segue o catálogo de modelos do Codex ou o provedor compatível com OpenAI configurado. Modelos de imagem, vídeo, voz e transcrição usam os serviços configurados em Configurações → Serviços de IA.

As tabelas mostram provedores integrados e modelos recomendados; a disponibilidade real depende de credenciais, acesso da conta e plataforma.

Modelos de linguagem

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

Imagem

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

Vídeo

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

Voz e transcrição

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

A transcrição local também oferece faster-whisper, WhisperKit e whisper.cpp nas plataformas compatíveis.

Exemplos

Tradução de vídeos

Os exemplos públicos abaixo foram produzidos quando o OpenCreator ainda se chamava KrillinAI. Eles demonstram o fluxo de trabalho consolidado de alinhamento de legendas, tradução, dublagem e vídeo vertical que o espaço de Tradução de vídeos do OpenCreator incorpora a um fluxo de Agent mais amplo.

O projeto gerou o arquivo de legendas abaixo a partir de um vídeo local de 46 minutos em uma única execução, sem ajustes manuais. O resultado publicado apresenta cobertura completa, nenhuma linha sobreposta, segmentação natural e tradução de alta qualidade.

Exemplo de alinhamento de legendas do OpenCreator

Tradução de legendas

subtitle_translation.mp4

Dublagem

tts.mp4

Modo vertical

agi.mp4

Estes exemplos de vídeo e a imagem de alinhamento de legendas foram produzidos quando o OpenCreator ainda usava o nome KrillinAI.

Download de vídeos

Analise links de vídeo públicos de 10 plataformas compatíveis, compare os formatos disponíveis e baixe o vídeo ou o áudio diretamente para o projeto.

Fontes de vídeo compatíveis:

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

A disponibilidade depende do vídeo e da região; algumas fontes podem exigir cookies da plataforma. O OpenCreator não importa automaticamente os cookies do navegador.

Seleção de formatos do downloader de vídeos do OpenCreator

Geração de vídeos

Gere um vídeo com IA a partir de um prompt de texto ou de uma imagem de referência com o Seedance. Configure o modelo, a proporção, a resolução e a duração; depois, visualize, gere novamente ou baixe cada versão no espaço de trabalho do projeto.

Geração de vídeos no OpenCreator com Seedance

Animação de bonecos palito

O OpenCreator desenvolveu esta coleção de personagens originais em colaboração com o artista Harbor Hsia, criador de Stickman no Behance. Os personagens integrados mantêm identidades consistentes durante a animação.

Personagens de bonecos palito do OpenCreator desenvolvidos com artistas

Transforme texto ou conteúdo do YouTube em animação com revisão do roteiro, narração, ajuste de tempo, storyboard, legendas, renderização e vídeo para download.

Quadro de exemplo de animação de bonecos palito do OpenCreator

Início rápido

Instalar o aplicativo Desktop

Baixe o instalador para macOS Apple Silicon, macOS Intel ou Windows x64 na versão mais recente. O Desktop não requer Node.js nem pnpm e inclui o Codex CLI. Tarefas reais com modelos exigem um login do ChatGPT ou uma configuração de chave de API válida.

Na primeira inicialização, o Desktop inicia o Runtime local, prepara um projeto padrão e verifica a configuração local do Codex. Se encontrar um login ou uma chave de API e configurações de modelo utilizáveis, selecione Usar o Codex local e continuar para reutilizá-los. Também é possível configurar outro provedor de modelos no mesmo assistente inicial.

Configuração do provedor de modelos na primeira inicialização do OpenCreator Desktop

Após a configuração, digite seu pedido para iniciar uma tarefa. Se houver problemas, consulte o guia do usuário.

Executar Web a partir do código-fonte

Para desenvolver ou usar Web a partir do código-fonte, prepare:

  • Node.js 22 ou posterior
  • pnpm 9.15.0, fixado pelo campo packageManager do repositório
  • Um executável do Codex CLI disponível no terminal
  • Um login válido no Codex CLI para tarefas reais com modelos

Primeiro, verifique seu ambiente local:

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

Abra http://127.0.0.1:19861/. O servidor de desenvolvimento inicia o daemon local sob demanda e injeta um token temporário do Runtime por meio de um proxy de mesma origem, portanto não é necessário copiar manualmente nenhum token de conexão.

Na primeira inicialização, o Runtime prepara um projeto padrão. O campo de entrada fica disponível assim que a conexão é concluída. Para trabalhar somente no daemon:

pnpm daemon:dev

O daemon escuta somente em um endereço de loopback e imprime uma vez no stdout seu endereço de conexão e o token temporário.

Desktop

Desktop e o navegador usam o mesmo frontend React de apps/web. O comportamento geral de projetos, conversas, tarefas e configurações chama o mesmo Daemon/API. O Electron acrescenta somente caminhos reais do sistema, controles de janela, comportamento da bandeja e notificações nativas.

Modo de desenvolvimento

pnpm desktop:dev

Empacotamento local

Comando Saída
pnpm desktop:package Um diretório executável para a plataforma atual, destinado à verificação local
pnpm desktop:dist Um instalador para a plataforma atual
pnpm desktop:release O ponto de entrada de empacotamento para uma versão oficial
pnpm --filter @opencreator/desktop verify:package Verificação de um pacote Desktop existente

O empacotamento do Desktop recompila Web a partir do espaço de trabalho atual, registra o commit, o estado dirty, a plataforma, a arquitetura e o hash de Web e compara apps/web/dist com os recursos incorporados ao aplicativo. O empacotamento falha se houver diferenças. Consulte o runbook de lançamento do Desktop para informações sobre assinatura, notarização, compilações para Windows e requisitos de lançamento.

Fluxos de trabalho principais

Conversas e Runs

  1. Selecione um projeto ou inicie uma nova conversa.
  2. Digite uma tarefa e escolha o nível de permissão, o Profile, o modelo e o esforço de raciocínio.
  3. Enquanto um Run estiver ativo, coloque tarefas de acompanhamento na fila ou interrompa-o e continue imediatamente.
  4. Use a Timeline para consultar resumos de raciocínio, chamadas de ferramentas, alterações em arquivos, aprovações e resultados finais.
  5. Use a central de tarefas para acompanhar globalmente tarefas em execução, concluídas, com falha e bloqueadas por aprovação.

Skills e MCP

  • Explore o marketplace de Skills, o histórico de instalações e as Skills disponíveis localmente na central de plugins.
  • Selecione uma Skill no campo de entrada usando / ou o menu de adição para que a próxima tarefa siga seu fluxo de trabalho.
  • O gerenciamento de MCP usa os comandos e a configuração nativos do Codex em vez de manter um segundo mecanismo de execução.
  • O OpenCreator usa o $CODEX_HOME ativo por padrão, portanto verifique o impacto antes de alterar as Skills globais ou a configuração de MCP.

Agendamentos e threads de tarefas dedicados

  • Cada agendamento tem uma conversa persistente e dedicada do OpenCreator.
  • Acionamentos automáticos, execuções manuais e acompanhamentos do usuário reutilizam essa conversa e são executados em série de acordo com a política queue ou skip.
  • Excluir um agendamento arquiva sua conversa dedicada, mas preserva Runs, resultados e o histórico subjacente do Codex.
  • Rotacionar ou recuperar uma thread subjacente do Codex não altera a entrada da tarefa nem a rota da página do OpenCreator.

Estrutura do sistema OpenCreator

O OpenCreator trata o espaço de trabalho visual e a conversa com o Agent como duas interfaces para a mesma tarefa criativa, e não como dois fluxos de trabalho separados. Cada fluxo de criação é modelado como uma máquina de estados: entrada de origem, configuração, geração, revisão, alteração e exportação tornam-se estados e eventos explícitos. As ações no espaço de trabalho e os comandos de conversa entram na mesma máquina de estados, enquanto a etapa atual, a configuração, o progresso, as versões e os resultados são projetados de volta nas duas interfaces. Isso mantém o espaço de trabalho e a conversa sincronizados sem introduzir uma segunda fonte de verdade.

O trabalho criativo é iterativo, portanto as revisões não substituem o resultado atual. Cada correção ou nova geração cria uma versão a partir do estado existente do fluxo de trabalho, mantendo as configurações e os resultados das versões anteriores para análise, comparação e aprimoramento contínuo.

+-----------------------------+     +------------------------------------+
| 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   |
+---------------------+  +---------------------+  +-------------------------+
Componente do OpenCreator Responsabilidade Implementação
Experiência de criação Dashboard, ferramentas de criação, conversa com Agent, configurações e arquivos apps/web · React 18 · Vite · TypeScript
Núcleo de colaboração Sincroniza etapas do espaço de trabalho, contexto da conversa, progresso, resultados e revisões Estado de fluxo compartilhado · CreatorCollaborationPanel · histórico de versões
Runtime local Gerencia projetos, Runs, aprovações, agendamentos, memória e notificações apps/daemon · Fastify · Runtime API · SSE
Componentes do Runtime Acompanha versões incluída, ativa e mais recente, verifica periodicamente e instala apenas atualizações solicitadas yt-dlp nightly · verificação de atualização · fallback para versão funcional
Mecanismo Codex Fornece loop de Agent, sessões, raciocínio, ferramentas, Skills e MCP Codex CLI · app-server
Ferramentas de mídia Baixa, transcreve, transforma, gera e exporta mídia criativa yt-dlp · Whisper · FFmpeg · serviços de IA configurados
Dados locais Armazena localmente dados de projetos, Runs, anexos, resultados e credenciais SQLite · sistema de arquivos · armazenamento de credenciais do sistema
Host Desktop Carrega a compilação Web compartilhada e adiciona recursos do sistema operacional apps/desktop · Electron · Preload Bridge

Princípios fundamentais:

  • O espaço de trabalho e a conversa com o Agent são projeções sincronizadas do mesmo estado do fluxo de trabalho; ambos enviam eventos para a mesma máquina de estados em vez de manter estados de tarefa paralelos.
  • As revisões criam novas versões em vez de substituir os resultados existentes, preservando o contexto e a saída de cada iteração criativa.
  • O frontend não inicia o Codex diretamente e não depende do formato bruto de eventos JSONL do Codex.
  • O daemon gerencia o ciclo de vida dos processos, a normalização de eventos, a persistência, as aprovações, os agendamentos e a caixa de saída de notificações.
  • O Codex continua sendo a fonte de verdade para a execução do loop de Agent, Skills e MCP.
  • Browser Bridge e Desktop Bridge não implementam cópias separadas da lógica geral do produto.

Estrutura do repositório

OpenCreator/
├── apps/
│   ├── web/          # A única implementação do frontend React
│   ├── daemon/       # Runtime Fastify local e adaptador do Codex
│   ├── desktop/      # Electron Main, Preload, recursos nativos e empacotamento
│   └── harness/      # Ferramenta de linha de comando para verificação do Runtime
├── packages/
│   ├── protocol/     # Contratos do Runtime compartilhados por Web, Daemon e Desktop
│   └── skill-market/ # Modelos do marketplace de Skills e lógica compartilhada
├── docs/             # Documentos de design, referências de API, runbooks e relatórios de testes
├── scripts/          # Verificações no nível do repositório
└── .runtime/         # Dados locais do Runtime, criados na primeira inicialização

Configuração

Chaves de API dos serviços de IA

Abra Configurações → Serviços de IA para configurar os provedores de modelo, transcrição, áudio e imagem usados pelos espaços de trabalho atuais. Categorias adicionais de serviços podem aparecer como preparação para futuras ferramentas de criação. Cada categoria exibe somente os campos exigidos pelo provedor selecionado, incluindo Base URL, API Key, modelo, proxy ou credenciais específicas do provedor.

Configurações de chaves de API dos serviços de IA do OpenCreator

As credenciais são salvas pelo armazenamento de credenciais do sistema do Runtime local e nunca devem ser enviadas ao repositório. Alguns provedores locais ou integrados ao sistema, como o Edge TTS, não exigem uma API Key.

Componentes de Runtime de terceiros

Abra Configurações → Componentes de terceiros para consultar a versão nightly do yt-dlp em uso, a versão incluída no OpenCreator, sua origem e a versão mais recente disponível. O OpenCreator verifica atualizações a cada sete dias, mas nunca as instala automaticamente. As atualizações exigem uma ação explícita do usuário, e a versão funcional atual permanece disponível se o download, a verificação ou a instalação falhar.

Configurações de componentes de terceiros do OpenCreator

Variáveis de ambiente do Runtime

A maioria dos usuários não precisa de variáveis de ambiente. Use-as quando precisar de dados isolados, de um executável específico do Codex ou de um diretório personalizado para projetos gerenciados:

Variável de ambiente Padrão Finalidade
OPENCREATOR_DATA_DIR .runtime Banco de dados do OpenCreator, Runs, anexos e espaços de trabalho gerenciados
OPENCREATOR_CODEX_BIN codex Caminho para o executável do Codex CLI
CODEX_HOME ~/.codex Fonte de verdade para sessões, configurações, Skills, MCP e Profiles do Codex
OPENCREATOR_DEFAULT_CWD Diretório de trabalho atual Diretório de trabalho padrão do daemon
OPENCREATOR_DEFAULT_PROJECT_ROOT Política padrão do Runtime Raiz dos projetos gerenciados; quando definida, o OpenCreator usa seu subdiretório OpenCreator/
OPENCREATOR_CODEX_THREAD_ROTATION_RUN_THRESHOLD 50 Limite de Runs encerrados para rotacionar a thread do Codex por trás de um agendamento de longa duração; use 0 para desativar a rotação proativa

Por exemplo, para isolar tanto os dados do Runtime quanto o ambiente do Codex:

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

Dados e segurança

Por padrão, os dados do Runtime são armazenados em .runtime/ na raiz do repositório:

Caminho Conteúdo
.runtime/app.sqlite Projetos, threads, Runs, eventos, agendamentos, notificações, metadados de anexos, aprovações, memória e resumos
.runtime/runs/ Logs com informações confidenciais ocultadas, diagnósticos e metadados de Runs individuais
.runtime/attachments/ Arquivos de anexo controlados
.runtime/workspaces/ Espaços de trabalho de projetos gerenciados pelo Runtime

As sessões e configurações do Codex permanecem em $CODEX_HOME e devem ser copiadas separadamente de .runtime/.

Os limites de segurança incluem:

  • O daemon escuta somente em 127.0.0.1; todas as APIs, exceto a verificação de integridade, exigem um token Bearer.
  • A visualização HTML desativa scripts, navegação e pop-ups por padrão e permite somente recursos relativos controlados do mesmo espaço de trabalho.
  • A memória sensível exige uma segunda confirmação. O OpenCreator nunca armazena automaticamente e de forma permanente sugestões não confirmadas.
  • Os diagnósticos e logs de Runs têm as informações confidenciais ocultadas antes de serem retornados ou exportados.
  • Os pacotes Desktop ativam a integridade ASAR e a criptografia de cookies, desativando RunAsNode, NODE_OPTIONS e o Node CLI Inspector.

Consulte o guia do usuário e de solução de problemas para conhecer os procedimentos completos de backup, restauração, limpeza e redefinição.

Desenvolvimento

Comandos comuns

Comando Finalidade
pnpm web:dev Iniciar Web e abrir o daemon local sob demanda
pnpm daemon:dev Iniciar somente o daemon
pnpm desktop:dev Compilar as dependências e iniciar o Electron no modo de desenvolvimento
pnpm test Executar testes unitários e de integração dos workspaces
pnpm typecheck Executar verificações do TypeScript em todo o repositório
pnpm build Compilar todos os workspaces
pnpm e2e Executar testes E2E do Playwright para Web
pnpm smoke:ci Executar o teste de fumaça do Runtime com um Codex simulado
pnpm perf:check Verificar a linha de base de desempenho registrada

Antes de enviar uma alteração, escolha verificações proporcionais ao impacto, conforme o guia de contribuição. Mudanças em documentação, texto e estilo requerem apenas verificações pertinentes; comportamento compartilhado e Runtime exigem testes direcionados e checagem de tipos. Execute testes ou builds completos apenas se necessário e informe no PR o que foi realmente verificado.

Alterações no Desktop, no Host Bridge, no proxy do Runtime ou nos fluxos de trabalho compartilhados do frontend também exigem testes de consistência Web/Desktop, E2E do aplicativo empacotado e verificação do hash da compilação Web. A aprovação apenas nos testes unitários de Web não comprova que uma versão Desktop está pronta para lançamento.

O teste de fumaça com o Codex real é desativado por padrão. Ative-o explicitamente com:

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

Documentação

Convenção de tradução

O arquivo README.md na raiz é o documento canônico em inglês. As traduções mantidas ficam em docs/<locale>/README.md. Adicione um idioma ao seletor somente depois que o documento completo tiver sido traduzido e sincronizado com a estrutura em inglês.

Comunidade

Usuários do GitHub de pelo menos 105 países e regiões deram uma estrela ao OpenCreator.

Mapa-múndi com países e regiões de usuários do GitHub que deram uma estrela ao OpenCreator

A equipe

Cada integrante é responsável pelos padrões, pela revisão e integração de contribuições e pelo suporte à comunidade em sua área.

wulien avatar
wulien
Código e correções de bugs
DLe-kb avatar
DLe-kb
Modelos de criação
xiaheyuan avatar
xiaheyuan
Design e recursos
krillinai avatar
krillinai
Skills e documentação
hbxugang avatar
hbxugang
Implantação empresarial

Colaboradores

Agradecemos a todas as pessoas que participaram com código, documentação, feedback, relatos de problemas, Skills, design e ideias.

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

Como contribuir

Você pode contribuir com o OpenCreator de várias maneiras, não apenas com código:

Tipo O que contribuir Como preparar Onde enviar
Código Correções, fluxos de criação, recursos compartilhados Mudança focada, demonstração ou reprodução, testes Issue → PR; apps/web/ ou apps/daemon/
Skills Fluxos reutilizáveis para Agents SKILL.md, pré-requisitos e exemplos Issue → PR em skills/
Modelos de criação Modelos reutilizáveis de imagem, vídeo ou capa template.json, capa e exemplos, prompts, configurações, atribuição e direitos de uso PR em template/; discuta novos formatos em uma Issue
Ilustração e design Ilustrações, ícones ou interfaces originais Prévia, arquivos-fonte editáveis e licença Issue → PR no local de recursos acordado
Integrações de serviços de terceiros Serviços de IA ou mídia Caso de uso, configuração, erros, segurança das credenciais e testes Issue → PR nos módulos Web / Daemon

Coloque cada modelo e seus arquivos em template/<module>/<id>/<version>/template.json. Os módulos atuais são image-generation, video-generation e cover-generator. Inclua título e descrição em chinês e inglês e execute pnpm templates:validate antes de enviar um PR.

Como participar:

  1. Descreva o problema, o caso de uso e o comportamento esperado em Issues.
  2. Crie uma branch específica de recurso ou correção a partir da branch de desenvolvimento mais recente.
  3. Siga a arquitetura existente: implemente os recursos gerais do produto uma única vez em Web e Daemon e isole as diferenças nativas atrás de capabilities explícitas.
  4. Adicione cobertura unitária, de integração ou E2E adequada para alterações de comportamento e liste no Pull Request tanto as verificações concluídas quanto as ignoradas.
  5. Nunca inclua em um commit .runtime/, credenciais locais, sessões do Codex, caches de compilação ou outros dados do usuário.

Histórico de Stars

O OpenCreator se chamava anteriormente KrillinAI. Este gráfico abrange todo o histórico do repositório antes e depois da mudança de nome.

Histórico de Stars do OpenCreator

Projetos relacionados

Projeto Função
OpenAI Codex Mecanismo de execução do Agent responsável por acesso a modelos, raciocínio, chamadas de ferramentas, sessões, Skills e integração com MCP.
yt-dlp Inspeciona links públicos de mídia compatíveis, lista os formatos disponíveis e baixa vídeo ou áudio para fluxos de criação.
FFmpeg FFmpeg e ffprobe cuidam da conversão e composição de mídia, extração de quadros e validação de resultados.
Whisper, whisper.cpp, faster-whisper e WhisperKit Opções de transcrição de voz na nuvem e locais específicas de plataforma, selecionadas conforme os recursos disponíveis do Runtime.
React Base da interface compartilhada entre Web e Desktop.
Fastify Base HTTP e API do Runtime local.
Electron Host Desktop para recursos nativos do sistema, ciclo de vida do aplicativo e empacotamento.
SQLite Persistência local de projetos, conversas, Runs, agendamentos, memória e outros dados do espaço de trabalho.
Model Context Protocol Protocolo aberto para conectar ferramentas e serviços externos ao espaço de trabalho Agent.

OpenCreator · Crie localmente, trabalhe sem interrupções.

Colocações atuais

Evolução em 30 dias

Sem registros nos últimos 30 dias.

← Voltar aos rankings