🛡️ GuardScan

100% Gratis y de Código Abierto • CLI de Escaneo de Seguridad con Privacidad Primero y Revisión de Código con IA

  ____ _   _   _    ____  ____    ____   ____    _    _   _            ____ _     ___ 
 / ___| | | | / \  |  _ \|  _ \  / ___| / ___|  / \  | \ | |          / ___| |   |_ _|
| |  _| | | |/ _ \ | |_) | | | | \___ \| |     / _ \ |  \| |  _____  | |   | |    | |
| |_| | |_| / ___ \|  _ <| |_| |  ___) | |___ / ___ \| |\  | |_____| | |___| |___ | | 
 \____|\___/_/   \_\_| \_\____/  |____/ \____/_/   \_\_| \_|          \____|_____|___|

 Privacy-First AI Code Review & Security Scanning

---

🎉 Completamente gratis: sin suscripciones, sin límites

GuardScan es 100% gratuito y de código abierto. Sin sistema de créditos, sin muros de pago, sin suscripciones.

Lo que obtienes (todo GRATIS)

• ✅ Análisis estático ilimitado: 9 escáneres de seguridad + herramientas de calidad de código
• ✅ Revisión de código mejorada con IA: usa tu propia clave de API (OpenAI, Claude, Gemini, Ollama)
• ✅ Funciona totalmente sin conexión: no se requiere internet para el análisis estático
• ✅ Privacidad ante todo: nunca sube tu código fuente
• ✅ Sin límites de uso: escanea líneas de código ilimitadas, repositorios ilimitados

---

🚀 Inicio rápido

# Install globally via npm
npm install -g guardscan

# Initialize GuardScan
guardscan init

# Run comprehensive security scan (100% FREE, offline)
guardscan security

# Configure AI provider for enhanced review (optional, BYOK)
guardscan config

# Run AI-enhanced code review
guardscan run

# Check status
guardscan status

🐳 Docker / Alpine Linux

Para entornos Docker, especialmente Alpine Linux:

# Install dependencies first
apk add --no-cache python3 make g++ pkgconfig cairo-dev pango-dev \
  libjpeg-turbo-dev giflib-dev pixman-dev freetype-dev build-base git

# Install GuardScan
npm install -g guardscan

# Set home directory (important for Docker)
export GUARDSCAN_HOME=/app/.guardscan

# Initialize
guardscan init

Documentación:

• 📖 Guía completa de Docker - Guía completa para Linux, macOS y Windows
• 🐧 Referencia rápida de Docker y Alpine - Referencia rápida específica para Alpine Linux

---

📋 Funciones principales

🔒 Análisis de seguridad (GRATIS, sin conexión)

GuardScan incluye escáneres de seguridad completos:

1. Detección de secretos - Encuentra claves de API, contraseñas y tokens codificados directamente (más de 20 patrones)
2. Vulnerabilidades en dependencias - Analiza dependencias de npm, pip, Maven y Cargo
3. OWASP Top 10 - Inyección SQL, XSS, configuraciones inseguras, CSRF, XXE
4. Seguridad de Docker - Análisis de Dockerfile y contenedores
5. Infraestructura como código - Seguridad de Terraform, CloudFormation y Kubernetes
6. Seguridad de API - Análisis de endpoints REST y GraphQL

📊 Calidad y análisis de código (GRATIS, sin conexión)

7. Métricas de código - Complejidad ciclomática, métricas de Halstead, índice de mantenibilidad
8. Code smells - Más de 30 antipatrones (god classes, métodos largos, números mágicos)
9. Cumplimiento de licencias - Verifica las licencias de las dependencias (MIT, GPL, Apache, etc.)
10. Verificaciones de cumplimiento - Análisis de cumplimiento de GDPR, HIPAA y PCI-DSS
11. Integración con linters - ESLint, Pylint, RuboCop, etc.
12. Contador de LOC - Conteo de líneas según el lenguaje (más de 20 lenguajes)

🧪 Pruebas y rendimiento (GRATIS, sin conexión)

13. Ejecutor de pruebas - Ejecuta y analiza pruebas de Jest, pytest y JUnit
14. Pruebas de mutación - Valida la eficacia de la suite de pruebas (requiere Stryker - opcional)
15. Pruebas de rendimiento - Pruebas de carga y benchmarking (requiere k6 - opcional)
16. Generación de SBOM - Lista de materiales de software (CycloneDX, SPDX)

Nota: Las pruebas de rendimiento y de mutación requieren herramientas externas opcionales.

🤖 Funciones mejoradas con IA (BYOK - Bring Your Own Key)

9 funciones avanzadas impulsadas por IA:

1. Explicador de código (guardscan explain) - Comprende código complejo
2. Revisión de código (guardscan review) - Revisión de código completa con IA
3. Generador de commits (guardscan commit) - Genera mensajes de commit
4. Generador de documentación (guardscan docs) - Genera documentación automáticamente
5. Generador de pruebas (guardscan test-gen) - Genera pruebas unitarias
6. Sugerencias de refactorización (guardscan refactor) - Mejora la calidad del código
7. Modelado de amenazas (guardscan threat-model) - Análisis de arquitectura de seguridad
8. Asistente de migración (guardscan migrate) - Migraciones de frameworks/lenguajes
9. Chat interactivo (guardscan chat) - Preguntas y respuestas sobre el código con RAG

🌍 Compatibilidad con varios lenguajes

Analizadores AST para más de 7 lenguajes:

• TypeScript/JavaScript
• Python
• Java
• Go
• Rust
• Ruby
• PHP
• C#

🔌 Integraciones con proveedores de IA

Configura el proveedor de IA que prefieras:

• OpenAI (GPT-4, GPT-4 Turbo, GPT-3.5)
• Anthropic Claude (Claude 3 Opus, Sonnet, Haiku)
• Google Gemini (Gemini Pro)
• Ollama (Local, centrado en la privacidad - llama2, codellama, mistral)
• LM Studio (Modelos locales)
• OpenRouter (Acceso a múltiples modelos)

Pagas directamente al proveedor de IA - ¡GuardScan no cobra nada!

---

🛠️ Comandos

¡Todos los comandos son 100% GRATIS y sin límites!

Comandos de configuración

Comando	Descripción
guardscan init	Inicializa la configuración, genera client_id
guardscan config	Configura el proveedor de IA y los ajustes
guardscan status	Muestra la configuración y la información del repositorio
guardscan reset	Borra la caché y la configuración locales

Comandos de seguridad y análisis

Comando	Descripción
guardscan security	Ejecuta un análisis de seguridad completo (sin conexión)
guardscan scan	Análisis de seguridad rápido
guardscan run	Revisión de código completa mejorada con IA (BYOK)

Comandos de pruebas y calidad

Comando	Descripción
guardscan test	Ejecutar pruebas y análisis de calidad del código
guardscan perf	Pruebas de rendimiento y pruebas de carga (requiere k6 - opcional)
guardscan mutation	Pruebas de mutación para la calidad de las pruebas (requiere Stryker - opcional)

Nota: los comandos perf y mutation requieren herramientas externas opcionales. Consulte la Guía de herramientas de pruebas para obtener detalles de instalación y uso.

Comandos de utilidad

Comando	Descripción
guardscan sbom	Generar una lista de materiales de software (SBOM)
guardscan rules	Motor de reglas personalizado basado en YAML

Comandos impulsados por IA (BYOK)