Quipu

Un banco de trabajo de escritorio para escribir, validar, compilar y probar reglas YARA.

Quipu (pronunciado «KEE-poo») reúne un explorador de proyectos, un editor con reconocimiento de YARA, el compilador YARA-X y resultados de escaneo enfocados en una única aplicación local. Incorpora tanto YARA-X como su servidor de lenguaje, por lo que no necesita una instalación de YARA por separado.

[!IMPORTANT] Quipu se encuentra en fase MVP. Las compilaciones están dirigidas a Linux y Windows x86-64. La validación de escritorio en Windows abarca Windows 11 24H2; consulte el registro de validación. Las compilaciones experimentales para macOS cuentan con cobertura de CI y validación de compilación confirmada por usuarios; consulte el registro de validación.

Características

• Abra una carpeta de archivos .yar y .yara como espacio de trabajo, o comience con una regla en borrador.
• Explore puntos de entrada inferidos o configurados, inclusiones anidadas, inclusiones externas y problemas del proyecto.
• Edite con resaltado de sintaxis de Monaco, autocompletado, documentación al pasar el cursor y diagnósticos de YARA-X en vivo.
• Compile un espacio de trabajo completo y luego escanee texto escrito o un archivo seleccionado.
• Inspeccione reglas coincidentes, patrones, desplazamientos, longitudes de bytes y bytes resaltados en un visor hexadecimal.
• Salte desde diagnósticos y coincidencias directamente a sus definiciones de origen.
• Restaure conjuntos de reglas compilados sin cambios desde una caché local acotada.
• Trabaje a partir de un conjunto de proyectos de ejemplo pequeños y autocontenidos incluidos con la aplicación.

Las reglas y los objetivos de escaneo se procesan localmente. Quipu no envía sus contenidos a un servicio remoto.

Instalación en Linux

Los paquetes para Linux x86-64 se publican en la página de GitHub Releases:

Paquete	Ideal para	Instalar o ejecutar
AppImage	Uso portátil en distribuciones compatibles	chmod +x Quipu_*.AppImage && ./Quipu_*.AppImage
.deb	Ubuntu 22.04+ y Debian 12+	sudo apt install ./Quipu_*.deb
.rpm	Versiones recientes de Fedora	sudo dnf install ./Quipu-*.rpm

Los paquetes .deb y .rpm utilizan el entorno de ejecución WebKitGTK del sistema. Si su distribución no puede satisfacer esa dependencia, utilice el AppImage.

Los paquetes de desarrollo están disponibles como artefactos quipu-linux-x86_64 de ejecuciones de CI exitosas. CI y Release llaman al mismo flujo de trabajo de Linux, incluida la validación de paquetes y las pruebas de humo del menú nativo. El archivo combinado SHA256SUMS lo proporciona Release, no los artefactos individuales de CI.

Los paquetes de Quipu no están firmados actualmente. Cada versión incluye un archivo SHA256SUMS; descárguelo junto a los paquetes y verifique los archivos que descargó con:

sha256sum --ignore-missing --check SHA256SUMS

Las sumas de verificación detectan corrupción accidental, pero no son una firma autenticada.

Instalación en Windows

Para los paquetes de Windows x86-64 (v0.3.0 y posteriores), descargue un instalador desde GitHub Releases. Las compilaciones de desarrollo también están disponibles como artefactos quipu-windows-x86_64 y quipu-windows-offline-x86_64 de ejecuciones de CI exitosas.

• Utilice el instalador NSIS .exe para una instalación del usuario actual.
• También está disponible un instalador MSI .msi.
• Para sistemas aislados de la red, elija un instalador -offline.exe o -offline.msi (el artefacto de CI quipu-windows-offline-x86_64). Estos paquetes más grandes incluyen el instalador completo del runtime de Microsoft Edge WebView2 y pueden instalarlo sin acceso a internet.
• Los instaladores estándar descargan WebView2 cuando el runtime no está presente, por lo que la instalación puede necesitar acceso a internet.

Los instaladores no están firmados, por lo que Windows puede mostrar una advertencia de editor desconocido o de SmartScreen. Verifique que su descarga provenga de la versión o del flujo de trabajo de este repositorio antes de continuar.

Los paquetes de la versión incluyen un archivo combinado SHA256SUMS. En PowerShell, calcule el hash de su instalador descargado (reemplace el nombre de archivo de ejemplo):

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

Compare el hash con la entrada de ese nombre de archivo exacto, ignorando mayúsculas y minúsculas. Los artefactos de CI individuales no incluyen el archivo de suma de verificación combinado de la versión.

Si se olvida un conjunto de reglas compilado tras reiniciar, consulte la sección Windows Defender troubleshooting de la guía incluida. Explica cómo confirmar una cuarentena y, si es necesario, excluir únicamente el directorio de caché.

Compilaciones experimentales para macOS

El flujo de trabajo de CI compila DMGs firmados ad-hoc para Apple Silicon e Intel, dirigidos a macOS 15 o superior. No requieren una membresía de Apple Developer para compilarse, pero no están notarizados y pueden requerir una anulación de Gatekeeper para iniciarse. Consulte macOS development para los artefactos de CI, las instrucciones de compilación y el estado de validación actual.

Inicio rápido

1. Inicie Quipu y elija File → Open Example… → Basic text match.
2. Explore text_indicators.yar en el editor.
3. Elija Rules → Compile Workspace o pulse Ctrl+Shift+B.
4. Escanee el objetivo preparado con Rules → Scan Target o pulse Ctrl+Shift+Enter.
5. Expanda una coincidencia y selecciónela para inspeccionar los bytes resaltados.

La guía completa se incluye con Quipu en Help → Documentation. Su código fuente también está disponible en documentation/content.

Espacios de trabajo y quipu.toml

Sin configuración, Quipu descubre recursivamente los archivos de reglas e infiere un punto de entrada a partir de cada archivo que no esté incluido por otro archivo. Añada un quipu.toml en la raíz del espacio de trabajo cuando necesite puntos de entrada explícitos, directorios incluidos o exclusiones: