Começar

    Requisitos

    O que o teu Mac precisa para correr o Ploy: Apple Silicon e 16 GB, o Ollama, o modelo qwen3:8b, o ffmpeg e, para a voz, o whisper.cpp.

    Resumo

    Requisito Para quê Obrigatório
    Mac com Apple Silicon O lançador só procura o binário cli-darwin-arm64 Sim
    16 GB de memória O modelo, a voz e o browser têm de caber juntos com as tuas outras aplicações Recomendado: é o que foi medido
    macOS recente Vozes do sistema, microfone e a proteção em que o Nesko corre as provas Sim
    Ollama Corre o modelo Sim
    Modelo qwen3:8b, cerca de 5 GB O motor de todos os modelos do Ploy Sim
    ffmpeg (com o ffprobe) Ferramenta de áudio e vídeo, e a voz Para essas duas partes
    whisper.cpp e um modelo de voz Transcrever o que dizes Só para a voz
    Bun Correr a versão de desenvolvimento a partir do código Enquanto não houver instalador

    O Mac

    O Ploy foi desenhado e medido num Mac com Apple M5 e 16 GB de memória. Esses 16 GB são partilhados com tudo o que tiveres aberto, e o projeto verifica o uso de swap sempre que um passo acrescenta memória. Um Mac com menos memória não foi testado, e o lançador só conhece a compilação para Apple Silicon.

    A versão mínima do macOS ainda não está determinada. Sabe-se que três partes dependem do sistema: a voz que lê as respostas é a voz portuguesa do macOS, o microfone passa pela autorização do macOS, e o Nesko corre as provas dos seus passos dentro da proteção (sandbox-exec) que o macOS traz. Sem essa proteção, o Nesko não corre nenhum comando.

    O Ollama

    O Ploy precisa de uma versão recente do Ollama. O modelo do Ploy liga e desliga o raciocínio pedido a pedido, e o seu TEMPLATE usa para isso o campo Think do pedido, que versões antigas do Ollama não têm. A versão mínima exata ainda não está determinada.

    Quando o Ollama não está a correr, o lançador inicia-o com estas definições:

    OLLAMA_NUM_PARALLEL=1
OLLAMA_MAX_LOADED_MODELS=1
OLLAMA_KEEP_ALIVE=15m
OLLAMA_FLASH_ATTENTION=1
OLLAMA_KV_CACHE_TYPE=q8_0

    Há um modelo carregado de cada vez, e fica na memória 15 minutos depois do último uso. Se já tens o Ollama a correr por outra via, o lançador usa-o como está e não lhe aplica estas definições. Nesse caso, garante pelo menos o OLLAMA_NUM_PARALLEL=1, que as fontes indicam como necessário.

    Para o Ollama estar noutro endereço, define PLOY_OLLAMA. A predefinição é http://127.0.0.1:11434.

    O modelo

    O modelo base é o qwen3:8b, com cerca de 5 GB (o Ollama indica 5,2 GB). O lançador cria a partir dele o qwen3-ploy, com um TEMPLATE que deixa ligar e desligar o raciocínio em cada pedido e com estes parâmetros: contexto de 16 384 tokens, temperatura 0,5, top_p 0,9 e top_k 20. É esse qwen3-ploy que os cinco modelos do Ploy usam. Ver Os modelos do Ploy.

    O contexto de 16 mil tokens é pequeno. É por isso que as conversas compactam o que é antigo (Conversas e projetos) e que as páginas do browser são cortadas (Browser).

    O ffmpeg

    A ferramenta de áudio e vídeo chama o ffmpeg e o ffprobe, e a voz usa o ffmpeg para converter a gravação. No Mac do autor foram instalados com o Homebrew (brew install ffmpeg).

    A voz (opcional)

    A transcrição precisa de dois componentes que não vêm com o Ploy:

    • o programa whisper-cli, do whisper.cpp. No Mac do autor foi instalado com o Homebrew (fórmula whisper.cpp);
    • um modelo de voz, ggml-small.bin (cerca de 0,5 GB), em ~/.local/share/ploy/models/. Para o pores noutro sítio, define PLOY_WHISPER_MODEL.

    A origem do ggml-small.bin ainda não está documentada nas fontes do Ploy. Ver Voz.

    O Bun

    A janela (ploy app) arranca hoje com o Bun, em modo de desenvolvimento, a partir da pasta do código. O terminal usa o binário compilado e, se ele não existir, também o Bun. Para compilar o binário, as fontes pedem o Bun 1.3.14 ou mais recente. O estado do instalador está em Descarregar.

    Rede

    Para conversar e trabalhar com os teus ficheiros, o Ploy não precisa de internet. Precisa dela para instalar o Ollama e descarregar o modelo, e para o Veta pesquisar na web (com PLOY_WEB=0 o Veta responde sem a web). Como parte das definições de local primeiro, o lançador desliga as atualizações automáticas, a lista de modelos online e os modelos gratuitos alojados.