Quipu

Un atelier de bureau pour écrire, valider, compiler et tester des règles YARA.

Quipu (prononcé « KEE-poo ») réunit un explorateur de projet, un éditeur compatible YARA, le compilateur YARA-X et des résultats d'analyse ciblés dans une seule application locale. Il intègre à la fois YARA-X et son serveur de langage, ce qui vous évite une installation YARA séparée.

[!IMPORTANT] Quipu est au stade MVP. Les builds ciblent Linux/Windows x86-64 et macOS 15+ Apple Silicon/Intel. La validation du bureau Windows couvre Windows 11 24H2 ; voir le dossier de validation. Les paquets macOS signés utilisent Developer ID et la notarisation Apple ; voir le dossier de validation.

Fonctionnalités

• Ouvrez un dossier de fichiers .yar et .yara comme espace de travail, ou commencez avec une règle temporaire.
• Explorez les points d'entrée inférés ou configurés, les inclusions imbriquées, les inclusions externes et les problèmes du projet.
• Éditez avec la coloration syntaxique Monaco, la complétion, la documentation au survol et les diagnostics YARA-X en direct.
• Compilez un espace de travail complet, puis analysez un texte saisi ou un fichier sélectionné.
• Inspectez les règles correspondantes, les motifs, les décalages, les longueurs d'octets et les octets surlignés dans un visualiseur hexadécimal.
• Accédez directement depuis les diagnostics et les correspondances à leurs définitions sources.
• Restaurez les ensembles de règles compilés inchangés depuis un cache local borné.
• Travaillez à partir d'un ensemble de petits projets d'exemple autonomes inclus avec l'application.

Les règles et les cibles d'analyse sont traitées localement. Quipu n'envoie pas leur contenu à un service distant.

Installation sous Linux

Les paquets Linux x86-64 sont publiés sur la page GitHub Releases :

Paquet	Idéal pour	Installation ou exécution
AppImage	Utilisation portable sur les distributions prises en charge	chmod +x Quipu_*.AppImage && ./Quipu_*.AppImage
.deb	Ubuntu 22.04+ et Debian 12+	sudo apt install ./Quipu_*.deb
.rpm	Versions récentes de Fedora	sudo dnf install ./Quipu-*.rpm

Les paquets .deb et .rpm utilisent le runtime WebKitGTK du système. Si votre distribution ne peut pas satisfaire cette dépendance, utilisez l'AppImage.

Les paquets de développement sont disponibles sous forme d'artefacts quipu-linux-x86_64 à partir des exécutions CI réussies. CI et Release appellent le même workflow Linux, y compris la validation des paquets et les tests de fumée des menus natifs. Le fichier SHA256SUMS combiné est fourni par Release, et non par les artefacts CI individuels.

Les paquets Quipu ne sont actuellement pas signés. Chaque version inclut un fichier SHA256SUMS ; téléchargez-le à côté des paquets et vérifiez les fichiers téléchargés avec :

sha256sum --ignore-missing --check SHA256SUMS

Les sommes de contrôle détectent une corruption accidentelle mais ne constituent pas une signature authentifiée.

Installation sous Windows

Pour les paquets Windows x86-64 (v0.3.0 et ultérieurs), téléchargez un installateur depuis GitHub Releases. Des builds de développement sont également disponibles sous forme d'artefacts quipu-windows-x86_64 et quipu-windows-offline-x86_64 à partir des exécutions CI réussies.

• Utilisez l'installateur NSIS .exe pour une installation pour l'utilisateur courant.
• Un installateur MSI .msi est également disponible.
• Pour les systèmes isolés (air-gapped), choisissez un installateur -offline.exe ou -offline.msi (l'artefact CI quipu-windows-offline-x86_64). Ces paquets plus volumineux incluent l'installateur complet du runtime Microsoft Edge WebView2 et peuvent l'installer sans accès à Internet.
• Les installateurs standard téléchargent WebView2 lorsque le runtime est absent, l'installation peut donc nécessiter un accès à Internet.

Les installateurs ne sont pas signés, Windows peut donc afficher un avertissement d'éditeur inconnu ou SmartScreen. Vérifiez que votre téléchargement provient bien de la release ou du workflow de ce dépôt avant de continuer.

Les paquets de release incluent un fichier SHA256SUMS combiné. Dans PowerShell, calculez le hachage de votre installateur téléchargé (remplacez le nom de fichier d'exemple) :

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

Comparez le hash avec l'entrée correspondant à ce nom de fichier exact, sans tenir compte de la casse. Les artefacts CI individuels n'incluent pas le fichier de somme de contrôle combiné de la release.

Si un ensemble de règles compilé est oublié après un redémarrage, consultez la section Dépannage de Windows Defender du guide fourni. Elle explique comment confirmer une mise en quarantaine et, si nécessaire, exclure uniquement le répertoire de cache.

Paquets macOS

Les DMG de release pour Apple Silicon et Intel ciblent macOS 15 ou une version ultérieure. L'application et le DMG sont signés avec un Developer ID, notariés par Apple et agrafés. Téléchargez le DMG approprié depuis Releases, puis glissez Quipu dans Applications. Les artefacts CI ordinaires utilisent des signatures ad-hoc et sont destinés au développement. Consultez macOS pour l'installation, les instructions de compilation et l'état actuel de validation.

Démarrage rapide

1. Lancez Quipu et choisissez File → Open Example… → Basic text match.
2. Explorez text_indicators.yar dans l'éditeur.
3. Choisissez Rules → Compile Workspace ou appuyez sur Ctrl+Shift+B.
4. Analysez la cible préparée avec Rules → Scan Target ou appuyez sur Ctrl+Shift+Enter.
5. Développez une correspondance et sélectionnez-la pour inspecter les octets mis en évidence.

Le guide complet est fourni avec Quipu sous Help → Documentation. Sa source est également disponible dans documentation/content.

Espaces de travail et quipu.toml