Por que meu Mac usa 100% de CPU com CoreML?

Isso e esperado. O CoreML so pode acelerar certas operacoes e o resto volta para a CPU.

Posso usar o modo webcam no Mac?

Sim, mas conceda permissao de camera ao app do terminal primeiro.

Existe alternativa gratuita ao instalador pago?

Sim. O metodo manual via Conda e o Pinokio sao ambos gratuitos.

Como Instalar e Usar o FaceFusion no Mac (Apple Silicon)

O FaceFusion funciona nativamente no Mac com Apple Silicon -- os chips M1, M2, M3 e M4 sao todos suportados. Mas configurar e fazer tudo funcionar bem exige conhecer alguns truques especificos do Mac que a documentacao oficial mal menciona.

Este guia cobre tudo: instalacao (tres metodos), o provedor de execucao CoreML, expectativas realistas de desempenho, bugs especificos do Mac e suas correcoes, configuracoes ideais e o que fazer quando o seu Mac e lento demais para processar videos.

Ja esta usando o FaceFusion mas tendo problemas? Veja nosso guia de problemas comuns ou a pagina de solucao de problemas de instalacao.

Quais Macs Podem Rodar o FaceFusion?

Antes de comecar, verifique se o seu Mac e compativel. O FaceFusion abandonou completamente o suporte a Macs com Intel — apenas Apple Silicon e suportado agora.

Chip do Mac	Suportado?	Desempenho
M1 / M1 Pro / M1 Max / M1 Ultra	Sim	Utilizavel para imagens, lento para video
M2 / M2 Pro / M2 Max / M2 Ultra	Sim	Moderado — funciona para videos curtos
M3 / M3 Pro / M3 Max	Sim	Moderado — leve melhoria em relacao ao M2
M4 / M4 Pro / M4 Max	Sim	Melhor experiencia no Mac, ainda mais lento que NVIDIA
Mac Intel (qualquer)	Nao	Sem suporte desde o FaceFusion 3.5+

Versao do macOS: Sequoia e Tahoe sao totalmente suportados. Versoes anteriores podem funcionar, mas nao sao oficialmente testadas.

A verdade honesta sobre o desempenho no Mac: O desenvolvedor do FaceFusion, henryruhs, disse diretamente no Reddit (junho de 2026):

"Embora o Apple Silicon tenha sido um grande avanco comparado a arquitetura Intel, ele ainda e conhecido pelo desempenho geral ruim para inferencia de IA."

Isso nao significa que o FaceFusion e inutilizavel no Mac. Significa que voce deve ter expectativas realistas — especialmente para processamento de video. Mais sobre os numeros de desempenho abaixo.

Metodo 1: Instalador Oficial para macOS (Mais Facil)

O FaceFusion oferece um instalador pago para macOS com um clique (v3.6.1, atualizado em abril de 2026). Este e o caminho mais facil se voce nao se sente confortavel com o terminal.

O Que Ele Faz

Instala automaticamente Git, Conda e FFmpeg
Cria um atalho na area de trabalho e no menu iniciar
Permite iniciar o FaceFusion sem ativar nenhum ambiente manualmente
Funciona no macOS Sequoia e macOS Tahoe

Como Obter

O instalador oficial do macOS esta disponivel no Ko-fi e no Buy Me a Coffee.

Aviso do Gatekeeper

O macOS provavelmente bloqueara o instalador na primeira vez que voce tentar abri-lo. Isso e normal. Para corrigir:

Clique com o botao direito no instalador e selecione Abrir (nao clique duas vezes)
Ou arraste o install.sh para o app Terminal e pressione Enter

Metodo 2: Instalacao Manual via Conda (Recomendado)

Este e o metodo recomendado pela documentacao oficial do FaceFusion. Da controle total sobre o seu ambiente e e gratuito.

Pre-requisitos

Voce precisa de tres coisas instaladas antes de comecar:

Homebrew — o gerenciador de pacotes do Mac
Git — para clonar o repositorio do FaceFusion
Miniconda — para gerenciar o ambiente Python

Se voce nao tem o Homebrew, instale-o primeiro:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Depois instale o Git:

brew install git

Baixe e instale o Miniconda do site oficial. Escolha a versao Apple Silicon (ARM64).

Instalacao Passo a Passo

Abra o Terminal e execute estes comandos um de cada vez:

# Inicializar o Conda (necessario apenas uma vez)
conda init --all

# Criar um ambiente Python 3.12
conda create --name facefusion python=3.12 pip=25.0

# Ativar o ambiente
conda activate facefusion

# Clonar o repositorio do FaceFusion
git clone https://github.com/facefusion/facefusion

# Entrar no diretorio
cd facefusion

# Instalar com suporte CoreML (IMPORTANTE: nao use --onnxruntime default)
python install.py --onnxruntime coreml

# Instalar FFmpeg
conda install ffmpeg

# Iniciar o FaceFusion
python facefusion.py run

Critico: Use CoreML, Nao Default

A linha mais importante e python install.py --onnxruntime coreml. Se voce usar --onnxruntime default em vez disso, o FaceFusion rodara apenas na sua CPU — que e dramaticamente mais lento. O CoreML diz ao FaceFusion para usar a GPU e o Neural Engine do seu Mac.

Primeiro Inicio

No primeiro inicio, o FaceFusion baixa centenas de MB de modelos de IA. Isso leva alguns minutos dependendo da sua velocidade de internet. Quando terminar, uma URL aparece no terminal (geralmente http://127.0.0.1:7860). Abra esta URL no Safari ou Chrome para usar o FaceFusion.

Reabrindo o FaceFusion Depois

Toda vez que quiser usar o FaceFusion:

conda activate facefusion
cd facefusion
python facefusion.py run

Metodo 3: Instalador Pinokio com Um Clique (Gratuito, Mas Com Ressalvas)

Pinokio e um aplicativo gratuito que instala ferramentas de IA com um clique. Funciona no Mac, mas tem um problema conhecido que atrapalha muitos usuarios.

O Problema do Travamento

Em configuracoes de Mac novas (especialmente maquinas M4), a instalacao do Pinokio trava silenciosamente na etapa "(6/11) Installing brew." Fica ali para sempre sem mensagem de erro e sem progresso.

A Correcao: Instale o Xcode Command Line Tools Primeiro

Antes de iniciar o Pinokio, abra o Terminal e execute:

xcode-select --install

Uma caixa de dialogo aparece pedindo para instalar as Ferramentas de Desenvolvedor de Linha de Comando. Clique em Instalar e aguarde cerca de 10 minutos. Depois que terminar, reinicie o Pinokio e a instalacao do FaceFusion prosseguira normalmente.

Metodos de Instalacao Comparados

Fator	Instalador Oficial	Manual (Conda)	Pinokio
Dificuldade	Facil	Intermediario	Facil (com correcao)
Custo	Pago	Gratuito	Gratuito
CoreML auto-configurado	Sim	Voce escolhe	Sim
Atualizacoes automaticas	Sim	git pull manual	Via interface do Pinokio
Problemas conhecidos	Bloqueio do Gatekeeper	Conflitos de dependencia	Trava sem xcode-select
Melhor para	Usuarios nao-tecnicos	Desenvolvedores	Quem quer gerenciamento por GUI

Entendendo o CoreML: Como o FaceFusion Usa a GPU do Seu Mac

Quando voce instala o FaceFusion com --onnxruntime coreml, ele usa o framework CoreML da Apple atraves do ONNX Runtime. Este e o unico caminho de aceleracao por GPU disponivel atualmente para Mac.

O Que o CoreML Realmente Faz

O CoreML pode executar operacoes de IA em tres unidades de computacao dentro do seu chip Apple Silicon:

CPU — sempre disponivel, mais lento
GPU — graficos integrados da Apple, aceleracao significativa
Neural Engine (ANE) — acelerador de IA dedicado, mais rapido para operacoes suportadas

Verificando Seu Provedor de Execucao

Antes de processar qualquer midia, verifique o menu suspenso Execution Provider na interface do FaceFusion. Se ele mostra "cpu" em vez de "coreml", a GPU do seu Mac nao esta sendo usada.

Provedor de Execucao	Velocidade Estimada	Video de 1 Minuto (30fps)
CoreML (correto)	~1,5 fps	~20 minutos
CPU apenas (errado)	~0,3 fps	~100 minutos

Desempenho: Quao Rapido e o FaceFusion no Mac?

Vamos ser honestos. O Mac e utilizavel para o FaceFusion, mas e significativamente mais lento que um PC Windows com uma GPU NVIDIA.

Dados de Benchmark do Mundo Real

Hardware	FPS Aprox.	Video 1 Min (troca apenas)	Video 1 Min (troca + melhoria)
Mac M4 (CoreML)	~1,5 fps	~20 min	~60 min
RTX 4080 (CUDA)	~2,5 fps (HD)	~12 min	~25 min
RTX 5090 (CUDA)	~5–20 fps	~3 min	~6 min
RTX 4090 (CUDA)	~4–8 fps	~4 min	~10 min

M4 Pro vs M4 Max: Vale a Pena Fazer Upgrade?

O desenvolvedor do FaceFusion compartilhou benchmarks mostrando uma pequena diferenca entre M1 Max e M4 Max. Seu conselho:

"A diferenca e pequena, eu aconselharia comprar um PC com GPU NVIDIA se voce realmente quer se dedicar a IA."

Melhores Configuracoes para Usuarios de Mac

Configuracao	Valor Recomendado	Por Que
Provedor de Execucao	CoreML	Usa GPU + Neural Engine em vez de apenas CPU
Contagem de Threads	10–16	Combina com a arquitetura de memoria compartilhada do Apple Silicon
Estrategia de Memoria	Padrao	Apple Silicon usa memoria unificada
Processadores	face_swapper + face_enhancer	Adicionar expression_restorer triplica o tempo
Modelo de Troca	hyperswap_1a_256	Melhor equilibrio entre qualidade e velocidade
Modelo de Melhoria	gfpgan_1.4	Mais leve que modelos GPEN, bons resultados
Pixel Boost	768x768	Valores maiores mal melhoram a qualidade mas desaceleram muito

O Que Evitar no Mac

frame_enhancer — extremamente intensivo em GPU, recomendado apenas para RTX 4090 ou superior
gpen_bfr_2048 — qualidade impressionante mas dolorosamente lento no Mac
Rodar 3+ processadores simultaneamente — cada um multiplica o tempo de processamento

Bugs Especificos do Mac e Como Corrigi-los

Corrupcao do Cache CoreML Apos Atualizacoes do macOS

O bug mais reportado no Mac. Apos atualizar o macOS (especialmente para Tahoe 26.3), o FaceFusion mostra este erro:

[E:onnxruntime] Non-zero status code returned while running CoreML node.
Status Message: output_features has no value for 682

Correcoes (em ordem de preferencia):

Atualize o FaceFusion para 3.5.1+ — inclui correcao automatica
Delete a pasta .caches no diretorio de instalacao do FaceFusion
Atualize o onnxruntime-silicon: pip install --upgrade onnxruntime-silicon
Alternativa temporaria: Mude o provedor de execucao para CPU na interface

Webcam/Camera Nao Funciona

O macOS requer permissao explicita de camera para o app que inicia o Python.

Abra Ajustes do Sistema → Privacidade e Seguranca → Camera
Encontre o seu app de terminal (Terminal.app, iTerm2, ou Pinokio) e ative-o
Se o pedido de permissao nunca apareceu: tccutil reset Camera
Se a camera ainda nao funciona: sudo killall VDCAssistant && sudo killall AppleCameraAssistant

Videos do QuickTime Nao Processam

Re-encode o video com FFmpeg:

ffmpeg -i input.mov -c:v libx264 -c:a aac fixed_input.mp4

GPU na Nuvem: A Alternativa Rapida para Usuarios de Mac

Se o seu Mac e lento demais, alugar uma GPU na nuvem e surpreendentemente barato.

RunPod (Recomendado)

GPU	Preco/Hora	Velocidade vs Mac M4
RTX 4090	US$ 0,34/hr	~3–5x mais rapido
A100	US$ 1,19/hr	~5–8x mais rapido
H100	US$ 1,99/hr	~8–12x mais rapido

Matematica de custo: Um video de 5 minutos custa cerca de US$ 0,17 na nuvem. Mesmo 100 videos somam apenas US$ 17 — compare com comprar um PC com GPU NVIDIA (US$ 800–2.000+).

O Futuro: Suporte PyTorch MPS no FaceFusion 4

O desenvolvedor do FaceFusion confirmou no Reddit (janeiro de 2026):

"Eu planejo suportar diferentes drivers de execucao como onnxruntime e PyTorch quando a API do FF4 estiver estavel."

O PyTorch MPS (Metal Performance Shaders) fornece acesso direto a GPU Metal — contornando a camada de traducao ONNX-para-CoreML. Isso poderia potencialmente reduzir a diferenca de desempenho entre Mac e NVIDIA de 10-15x para 3-5x. Nenhum cronograma foi anunciado.

Perguntas Frequentes

Posso rodar o FaceFusion em um Mac Intel?

Nao. O FaceFusion abandonou o suporte a Mac Intel a partir da versao 3.5. Voce precisa de um Mac com Apple Silicon (M1 ou mais recente). Se voce tem um Mac Intel, pode usar o FaceFusion online — funciona inteiramente no seu navegador.

Quanto tempo leva um video de 1 minuto no Mac?

Apenas troca de rosto em um Mac M4, cerca de 20 minutos. Adicionando o melhorador facial, chega a cerca de 60 minutos. Para comparacao, uma NVIDIA RTX 4090 faz o mesmo trabalho em 4-10 minutos.

O M4 Max e muito mais rapido que o M4 para o FaceFusion?

Nao dramaticamente. O desenvolvedor compartilhou benchmarks mostrando "pequena diferenca" entre M1 Max e M4 Max. O gargalo e o caminho de execucao CoreML do ONNX Runtime, nao a capacidade bruta do chip.

Por que meu Mac usa 100% de CPU mesmo com CoreML ativado?

Isso e esperado. O CoreML so pode acelerar certas operacoes — o resto volta para a CPU. Alem disso, o pipeline de dados do FaceFusion roda na CPU antes de alimentar dados para a GPU.

Devo comprar um Mac mais caro para o FaceFusion?

Provavelmente nao. Pela diferenca de preco entre um MacBook Air M4 e um MacBook Pro M4 Max, voce poderia alugar GPUs na nuvem por anos de uso ocasional do FaceFusion.

Como corrigir o erro "output_features has no value"?

Isso acontece quando atualizacoes do macOS corrompem o cache do CoreML. Delete a pasta .caches no diretorio de instalacao do FaceFusion, ou atualize para o FaceFusion 3.5.1+.

Posso usar o modo webcam do FaceFusion no Mac?

Sim, mas voce precisa conceder permissao de camera ao app do terminal primeiro. Va para Ajustes do Sistema → Privacidade e Seguranca → Camera e ative o Terminal.app.

Existe uma alternativa gratuita ao instalador pago do macOS?

Sim. O metodo de instalacao manual via Conda e completamente gratuito. O Pinokio tambem e gratuito.

Ainda Com Problemas?

Se o FaceFusion e lento demais no seu Mac, experimente o FaceFusion online. Funciona no navegador sem instalacao, sem GPU e sem linha de comando.

Experimente o FaceFusion Online — Gratuito, Sem Download