Quipu

Uma bancada de trabalho desktop para escrever, validar, compilar e testar regras YARA.

Quipu (pronunciado "KEE-poo") reúne um explorador de projetos, um editor com reconhecimento de YARA, o compilador YARA-X e resultados de varredura focados em uma única aplicação local. Ele incorpora tanto o YARA-X quanto o seu servidor de linguagem, de modo que você não precisa de uma instalação separada do YARA.

[!IMPORTANT] O Quipu está em estágio de MVP. As builds têm como alvo Linux/Windows x86-64 e macOS 15+ Apple Silicon/Intel. A validação do desktop Windows abrange o Windows 11 24H2; consulte o registro de validação. Os pacotes macOS assinados usam Developer ID e notarização da Apple; consulte o registro de validação.

Recursos

• Abra uma pasta de arquivos .yar e .yara como um workspace, ou comece com uma regra em rascunho.
• Explore entrypoints inferidos ou configurados, includes aninhados, includes externos e problemas do projeto.
• Edite com realce de sintaxe do Monaco, autocompletar, documentação ao passar o mouse e diagnósticos ao vivo do YARA-X.
• Compile um workspace completo e, em seguida, faça a varredura de um texto digitado ou de um arquivo selecionado.
• Inspecione regras correspondentes, padrões, offsets, comprimentos em bytes e bytes realçados em um visualizador hexadecimal.
• Salte de diagnósticos e correspondências diretamente para suas definições de origem.
• Restaure conjuntos de regras compilados inalterados a partir de um cache local limitado.
• Trabalhe a partir de um conjunto de pequenos projetos de exemplo autocontidos incluídos com a aplicação.

As regras e os alvos de varredura são processados localmente. O Quipu não envia seus conteúdos para um serviço remoto.

Instalação no Linux

Os pacotes Linux x86-64 são publicados na página GitHub Releases:

Pacote	Ideal para	Instalar ou executar
AppImage	Uso portátil em distribuições suportadas	chmod +x Quipu_*.AppImage && ./Quipu_*.AppImage
.deb	Ubuntu 22.04+ e Debian 12+	sudo apt install ./Quipu_*.deb
.rpm	Versões recentes do Fedora	sudo dnf install ./Quipu-*.rpm

Os pacotes .deb e .rpm usam o runtime WebKitGTK do sistema. Se a sua distribuição não conseguir satisfazer essa dependência, use o AppImage.

Os pacotes de desenvolvimento estão disponíveis como artefatos quipu-linux-x86_64 de execuções de CI bem-sucedidas. O CI e o Release chamam o mesmo workflow Linux, incluindo validação de pacotes e testes de fumaça do menu nativo. O arquivo SHA256SUMS combinado é fornecido pelo Release, não por artefatos individuais de CI.

Os pacotes do Quipu não são assinados atualmente. Cada release inclui um arquivo SHA256SUMS; baixe-o junto com os pacotes e verifique os arquivos que você baixou com:

sha256sum --ignore-missing --check SHA256SUMS

Os checksums detectam corrupção acidental, mas não são uma assinatura autenticada.

Instalar no Windows

Para pacotes Windows x86-64 (v0.3.0 e posteriores), baixe um instalador em GitHub Releases. Builds de desenvolvimento também estão disponíveis como artefatos quipu-windows-x86_64 e quipu-windows-offline-x86_64 a partir de execuções de CI bem-sucedidas.

• Use o instalador NSIS .exe para uma instalação para o usuário atual.
• Um instalador MSI .msi também está disponível.
• Para sistemas air-gapped, escolha um instalador -offline.exe ou -offline.msi (o artefato de CI quipu-windows-offline-x86_64). Esses pacotes maiores incluem o instalador completo do runtime Microsoft Edge WebView2 e podem instalá-lo sem acesso à internet.
• Os instaladores padrão baixam o WebView2 quando o runtime está ausente, portanto a instalação pode precisar de acesso à internet.

Os instaladores não são assinados, então o Windows pode exibir um aviso de editor desconhecido ou do SmartScreen. Verifique se o seu download veio da release ou do workflow deste repositório antes de prosseguir.

Os pacotes de release incluem um arquivo SHA256SUMS combinado. No PowerShell, calcule o hash do instalador baixado (substitua o nome de arquivo de exemplo):

Get-FileHash -Algorithm SHA256 .\Quipu_VERSION_x64-setup.exe
Get-Content .\SHA256SUMS

Compare o hash com a entrada para esse nome de arquivo exato, ignorando maiúsculas e minúsculas. Artefatos de CI individuais não incluem o arquivo de checksum combinado da release.

Se um conjunto de regras compilado for esquecido após reiniciar, consulte o solução de problemas do Windows Defender no guia incluído. Ele explica como confirmar uma quarentena e, se necessário, excluir apenas o diretório de cache.

Pacotes macOS

Os DMGs de release para Apple Silicon e Intel têm como alvo o macOS 15 ou mais recente. O app e o DMG são assinados com Developer ID, notarizados pela Apple e com staple. Baixe o DMG apropriado em Releases, depois arraste o Quipu para Aplicativos. Artefatos de CI comuns usam assinaturas ad-hoc e destinam-se ao desenvolvimento. Consulte macOS para instalação, instruções de build e o status de validação atual.

Início rápido

1. Inicie o Quipu e escolha File → Open Example… → Basic text match.
2. Explore text_indicators.yar no editor.
3. Escolha Rules → Compile Workspace ou pressione Ctrl+Shift+B.
4. Escaneie o alvo preparado com Rules → Scan Target ou pressione Ctrl+Shift+Enter.
5. Expanda uma correspondência e selecione-a para inspecionar os bytes destacados.

O guia completo está incluído no Quipu em Help → Documentation. Seu código-fonte também está disponível em documentation/content.

Workspaces e quipu.toml

Sem configuração, o Quipu descobre recursivamente arquivos de regras e infere um entrypoint a partir de cada arquivo que não é incluído por outro arquivo. Adicione um quipu.toml na raiz do workspace quando precisar de entrypoints explícitos, diretórios de inclusão ou exclusões:

schema = 1
entrypoints = ["main.yar"]
include_dirs = ["rules", "../shared-rules"]
exclude = ["fixtures/**", "vendor/legacy/**"]