Repolode
omnichar

omnichar/OmniChar

Estúdio open source e formato de arquivo .char portátil para manter personagens de IA consistentes em diferentes modelos de imagem e vídeo, localmente ou por APIs hospedadas.

Estrelas
556
Forks
74
Issues abertas
0
Último commit
há 5 dias

O que é?

O Omnichar cria personagens de IA que mantêm o mesmo rosto, corpo, roupa e voz em diferentes cenas e modelos. Cada personagem é reunido em um único arquivo .char portátil, que armazena fotos de referência, uma impressão digital de identidade, uma descrição fixa e, opcionalmente, um clipe de voz. A geração pode ser executada na sua própria GPU NVIDIA, no ComfyUI por meio de um custom node complementar ou com modelos hospedados via fal.

O estúdio é um app Python servido em uma única porta local, com um canvas de nodes para prompts, modelos, treinamento de LoRA e edição de vídeo. Entre os modelos compatíveis estão FLUX.1, FLUX.2, Krea 2, Z-Image Turbo, MiniMax H3 e LTX-2.5. Alguns modelos usam as imagens de referência diretamente; outros treinam um pequeno adaptador LoRA com as mesmas fotos. Cada geração recebe uma pontuação de continuidade em relação ao personagem.

O treinamento de LoRA é executado localmente com imagens estáticas ou clipes curtos, e os arquivos .safetensors treinados são carregados diretamente nos nodes de geração. O projeto é licenciado sob GPL-3.0, e os pesos dos modelos têm licenças próprias, separadas.

Recursos principais

  • 01Arquivos .char portáteis reúnem fotos de referência, impressão digital de identidade e descrição fixa.
  • 02Geração local e treinamento de LoRA em GPUs NVIDIA, com alternativa de execução na CPU.
  • 03Compatibilidade com FLUX.1, FLUX.2, Krea 2, Z-Image Turbo, MiniMax H3 e LTX-2.5.
  • 04Modelos hospedados via fal, com o mesmo personagem aplicado às solicitações da API.
  • 05Funciona como um custom node do ComfyUI que lê o mesmo formato .char.
  • 06Cada geração recebe uma pontuação de continuidade em relação ao personagem.

Casos de uso

  • Manter um personagem consistente em uma série de imagens ou em um curta-metragem.
  • Treinar uma LoRA com suas próprias fotos ou clipes de vídeo, sem depender da nuvem.
  • Gerar vídeos de personagens com som sincronizado usando MiniMax H3 ou LTX-2.5.
  • Compartilhar um arquivo de personagem entre workflows do ComfyUI e um estúdio independente.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/omnichar/OmniChar
  2. 2

    Acesse o diretório core

    cd OmniChar/core
  3. 3

    Instale tudo (macOS/Linux)

    ./webui.sh --install --extra all
  4. 4

    Inicie a interface web e abra http://127.0.0.1:8848

    ./webui.sh

Antes de usar

  • É necessário ter Python 3.11 ou superior e, para gerar localmente, uma GPU potente. A inferência do Krea 2 requer uma placa com cerca de 40 GB de memória.
  • Algumas configurações de hardware, como Apple Silicon e AMD ROCm, não foram testadas.
  • As opções de modelos hospedados dependem de APIs externas, em vez de serem executadas totalmente localmente.

Tópicos

Perguntas frequentes

O que é OmniChar?
Estúdio open source e formato de arquivo .char portátil para manter personagens de IA consistentes em diferentes modelos de imagem e vídeo, localmente ou por APIs hospedadas. O Omnichar cria personagens de IA que mantêm o mesmo rosto, corpo, roupa e voz em diferentes cenas e modelos. Cada personagem é reunido em um único arquivo .char portátil, que armazena fotos de referência, uma impressão digital de identidade, uma descrição fixa e, opcionalmente, um clipe de voz. A geração pode ser executada na sua própria GPU NVIDIA, no ComfyUI por meio de um custom node complementar ou com modelos hospedados via fal.
OmniChar é gratuito? Qual é a licença?
OmniChar é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
OmniChar ainda é mantido?
Manutenção ativa. O último commit de OmniChar foi em 16 de out. de 2026.
Para que posso usar OmniChar?
Manter um personagem consistente em uma série de imagens ou em um curta-metragem. Treinar uma LoRA com suas próprias fotos ou clipes de vídeo, sem depender da nuvem. Gerar vídeos de personagens com som sincronizado usando MiniMax H3 ou LTX-2.5. Compartilhar um arquivo de personagem entre workflows do ComfyUI e um estúdio independente.
Como instalar OmniChar?
Clone o repositório: git clone https://github.com/omnichar/OmniChar Acesse o diretório core: cd OmniChar/core Instale tudo (macOS/Linux): ./webui.sh --install --extra all Inicie a interface web e abra http://127.0.0.1:8848: ./webui.sh
Onde consigo OmniChar?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/omnichar/OmniChar

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados