Começar

Visão geral

O que é o Ploy, para quem serve, o que está dentro e fora do âmbito, e como esta documentação está organizada.

O que é o Ploy

O Ploy é um assistente local para o Mac. Faz o que faz um agente de programação (lê, edita e escreve ficheiros, corre comandos) e também trabalho do dia a dia no computador: usa um browser, corta e junta áudio e vídeo, ouve-te e fala. Tudo com um modelo que corre inteiro na tua máquina.

O modelo é o Qwen3 8B, servido pelo Ollama. Sobre ele, o Ploy tem cinco modelos próprios: o Saturn, o Veta, o Kant, o Nesko e o Automático, que escolhe entre os outros. A página Os modelos do Ploy explica o que cada um faz.

O Ploy é um fork do OpenCode, com licença MIT. O nome, o aspeto, os modelos e as ferramentas de áudio, vídeo e browser são do Ploy; a licença e o aviso de direitos de autor do OpenCode mantêm-se. Os detalhes estão em Licenças.

Escreve e responde em português de Portugal.

Para quem é

Para uma só pessoa, num só Mac. Não há contas, nem nuvem, nem funcionalidades de equipa. O Ploy foi desenhado e medido num Mac com Apple M5 e 16 GB de memória.

Porque vale a pena

  • Privado. Os teus pedidos, os teus ficheiros e o texto das páginas que o Ploy lê não saem do Mac. A única coisa que sai são as frases de pesquisa do Veta, depois de limpas de caminhos, e-mails e segredos. Para as ler, o Veta também tem de descarregar as páginas, como qualquer visita a um site. Mais em Segurança.
  • Gratuito. Não há subscrição nem gastos de API. Todos os componentes são software livre.
  • Rápido o suficiente. Numa suíte de dez tarefas com ferramentas, o Saturn acertou 28 de 30 (três repetições), com 17 segundos por tarefa. Foi uma suíte em que o Ploy foi afinado, por isso numa suíte nova o resultado é mais baixo. Todas as medições estão em Medições.
  • Honesto. Diz o que fez e o que verificou, e o projeto mede com que frequência acerta.

O que está dentro do âmbito

  • Tarefas de programação e de ficheiros: ler, editar, escrever e correr comandos, com a verificação do resultado.
  • Uma janela com várias conversas, memória entre elas e um painel de browser. Ver Conversas e projetos e Memória.
  • Os cinco modelos: conversa, pesquisa na web com fontes, raciocínio, e projetos inteiros.
  • Ferramentas de browser e de áudio e vídeo pensadas para um modelo pequeno.
  • Voz: falar com o Ploy e ouvir as respostas.
  • Um comando ploy para o terminal. Ver Linha de comandos.

O que fica de fora

  • Uso alojado ou com vários utilizadores, aplicações para telemóvel, e treinar ou afinar modelos.
  • Igualar um modelo grande em raciocínio difícil.

Estado de hoje

Como esta documentação está organizada

Grupo O que encontras
Começar Esta visão geral, o Arranque rápido, os Requisitos e as Pastas e dados.
Modelos A página Os modelos do Ploy e uma página por modelo: Automático, Saturn, Veta, Kant e Nesko.
Funcionalidades Conversas e projetos, Memória, Voz, Browser, Áudio e vídeo e Linha de comandos.
Segurança e honestidade O que o Ploy protege e o que não consegue: Segurança, Limites e Medições.
Referência Ambiente, Arquitetura, Princípios, Resolução de problemas e Marca.

Se queres só experimentar, vai direto ao Arranque rápido. Se queres perceber primeiro o que podes esperar de cada modelo, começa por Os modelos do Ploy.