Instalar o Yomika¶
Baixe a versão para Windows¶
Baixe o .exe ou .zip portátil mais recente para Windows na página de releases do Yomika. O ZIP contém o mesmo executável. Extraia-o para uma pasta sob seu controle e execute Yomika-<version>-windows-x64.exe; não há instalador. Para desenvolvimento ou uma build personalizada, consulte Build a Partir do Código-Fonte.
O que o Yomika armazena localmente¶
O Yomika é uma aplicação local-first. Além do executável portátil, a primeira execução cria um diretório local de dados por usuário para:
- bibliotecas de runtime usadas pelo llama.cpp e pelos backends de GPU
- modelos de visão e OCR baixados
- modelos locais opcionais de tradução que você selecionar mais tarde
O Yomika mantém seus próprios arquivos em uma pasta raiz Yomika de dados da aplicação e armazena os pesos dos modelos separadamente do binário.
O que esperar na primeira execução¶
Na primeira execução, o Yomika pode:
- extrair ou baixar bibliotecas de runtime exigidas pela stack de inferência local
- baixar os modelos padrão de visão e OCR usados por detection, segmentação, OCR, inpainting e estimativa de fonte
- aguardar até que você escolha Download no seletor de modelos para baixar uma LLM local de tradução
Isso é normal e pode levar algum tempo dependendo da sua conexão e hardware. O progresso de cada modelo fica visível, o download pode ser cancelado e uma notificação confirma a conclusão. Use Settings > Runtime para mudar a pasta da biblioteca de modelos, excluir modelos baixados ou baixá-los novamente.
Se você quiser pré-baixar essas dependências de runtime, execute o Yomika uma vez com --download. Esse caminho inicializa os pacotes de runtime e a stack de visão padrão, e então encerra sem abrir a GUI.
Atualizações da aplicação¶
O Yomika verifica a release mais recente do GitHub ao iniciar. Você também pode verificar manualmente em Settings > About. Quando houver uma versão nova, uma notificação abre a página de Releases; o Yomika nunca baixa nem instala uma atualização da aplicação automaticamente.
Notas sobre aceleração por GPU¶
O Yomika suporta:
- CUDA em GPUs NVIDIA compatíveis
- Metal em Macs com Apple Silicon
- Vulkan no Windows e Linux para OCR e inferência de LLM
- Fallback para CPU em todas as plataformas
Alguns detalhes práticos importam:
- detection e inpainting se beneficiam mais de CUDA ou Metal
- Vulkan é basicamente o caminho de fallback de GPU para OCR e inferência de LLM local
- se o Yomika não conseguir verificar que seu driver NVIDIA suporta CUDA 13.0 ou superior, ele faz fallback para CPU
Em sistemas com CUDA, o Yomika empacota e inicializa as peças de runtime de que precisa, em vez de exigir que você configure manualmente cada caminho de biblioteca.
Note
Mantenha seu driver NVIDIA atualizado. O Yomika requer um driver com suporte a CUDA 13.0 ou superior para a aceleração GPU de visão, e a CUDA 13.1+ no Windows para o caminho CUDA do LLM local. Se o driver for muito antigo, o Yomika faz fallback para CPU.
Após a instalação¶
Depois que o Yomika abrir com sucesso, as próximas decisões geralmente são:
- GUI desktop vs modo headless
- modelo local de tradução vs provider remoto
- exportação renderizada vs exportação em PSD com camadas
Veja:
- Executar nos Modos GUI, Headless e MCP
- Modelos e Providers
- Exportar Páginas e Gerenciar Projetos
- Troubleshooting
Precisa de ajuda?¶
Pesquise ou abra um relato no GitHub Issues.