HabeasSafe v1.1.0

Anonimización Judicial Colombiana · Ley 1581 & PCSJA24-12243

Detectando motor...
Swagger Docs
Documento Judicial Fuente

Arrastra un documento DOCX, PDF o TXT aquí

o haz clic para examinar archivos

Documento Protegido & Supervisión
El resultado anonimizado aparecerá aquí con los seudónimos aplicados...

Supervisión Humana y Control Judicial de Entidades Acuerdo PCSJA24-12243, numeral 3.9 · Sentencia T-323/24

0 activas
Aplicar Tipo Original (PII) Seudónimo Ocurr.
No hay entidades procesadas todavía.
Guía y Demostrador de Capacidades v1.1.0

Manual de Operación de HabeasSafe

HabeasSafe está concebido para operar en múltiples entornos judiciales mediante cinco interfaces complementarias: desde juzgados municipales sin conexión a internet hasta integraciones corporativas con sistemas procesales (Justicia XXI / SAMAI).

🛡️ Ley 1581/2012 ⚖️ Sentencia T-323/24 (Human-in-the-Loop) 📋 Circular PCSJA24-12243 🔒 Custodia Criptográfica SHA-256 ⚡ 1,107 Pruebas Aprobadas
🌐 Web SPA 🖥️ Desktop GUI ⌨️ Terminal CLI ⚡ API REST 💻 cURL HTTP 🔄 Pipeline 7 Tareas
Secretarías y Despachos Conectados Vanilla CSS · JS Nativo · FastAPI
🌐

1. Interfaz Web (SPA + Dashboard Judicial)

Consola de anonimización visual para usuarios finales con supervisión en tiempo real.

¿Cómo funciona y qué resuelve?

Permite al operador judicial cargar expedientes en formatos DOCX, PDF o TXT mediante arrastrar y soltar, o pegar directamente el texto de la demanda o providencia.

  • Visor Comparativo Lado a Lado: Texto original a la izquierda y resultado protegido a la derecha.
  • Revisión humana obligatoria (Acuerdo PCSJA24-12243, numeral 3.9): Cada entidad detectada aparece en una tabla interactiva con conmutadores individuales. Si el juez desactiva una entidad, el texto se re-renderiza instantáneamente.
  • Selector de Motor: Alterna dinámicamente entre la Cascada IA Cloud, IA local soberana o motor determinista puro.
  • Exportación Doble: Descarga el texto anonimizado limpio y el archivo mapping.jsonl para la custodia segura de los datos des-identificados.
HabeasSafe Web SPA — https://habeassafe.sprintjudicial.com
Texto Original

...interpone tutela el ciudadano Juan Pérez identificado con C.C. 12.345.678 domiciliado en Calle 50 # 45-20...

Documento Protegido

...interpone tutela el ciudadano PERSONA_001 ANON ANON identificado con C.C. 990000001 domiciliado en DIRECCION_001...

✓ Juan Pérez ➔ PERSONA_001 ✓ 12.345.678 ➔ 990000001 ✓ Calle 50 # 45-20 ➔ DIRECCION_001
Juzgados Municipales Offline (Air-Gapped) Python 3.12 Nativo · Tkinter · ttk MVC
🖥️

2. Interfaz de Escritorio (Desktop Tkinter)

Aplicación nativa de escritorio para operadores judiciales sin conexión a internet.

Garantía de Aislamiento y Soberanía Local

Diseñada específicamente para despachos judiciales con restricciones de conectividad o que manejan información de reserva legal absoluta (procesos de menores, seguridad nacional, reserva bancaria).

  • 100% Offline: No realiza ninguna llamada de red externa. Todo el análisis corre en la CPU del equipo.
  • Árbol de Conflictos Supervisados: Muestra un árbol interactivo para resolver discrepancias entre entidades complejas.
  • Empaquetado Standalone: Puede ejecutarse directamente con Python o empaquetarse con PyInstaller en un único ejecutable sin instalación.
  • Scripts de Arranque Rápido: Incluidos en la raíz para Mac, Linux y Windows.
Comandos de Ejecución Local: ./run_mac.sh desktop # En macOS ./run_linux.sh desktop # En Linux run_windows.bat desktop # En Windows
HabeasSafe Desktop GUI (Tkinter MVC)
Captura de Pantalla Interfaz Desktop Tkinter HabeasSafe
Ingenieros Judiciales & Procesamiento Masivo Click 8.1 · Multiprocesamiento · Rich Logs
⌨️

3. Terminal CLI (Lotes y Automatización)

Procesamiento por lotes de miles de fojas, auditorías forenses y benchmarks.

Alto Rendimiento y Scripts de Producción

Ideal para secretarías generales, centros de digitalización de la Rama Judicial y scripts desatendidos de migración documental.

  • habeassafe anonymize <archivo>: Procesa un documento individual (TXT, PDF, DOCX) y genera el archivo limpio y su mapa.
  • habeassafe batch <directorio>: Procesa carpetas enteras de expedientes en paralelo aprovechando todos los núcleos de CPU.
  • habeassafe benchmark: Evalúa la precisión y velocidad entre modelos de lenguaje locales y en la nube.
  • habeassafe servir: Despliega el servidor web y la API REST en el puerto deseado.
  • habeassafe revert <doc> --mapping <mapa>: Des-anonimiza y valida el hash criptográfico SHA-256.
zsh — habeassafe CLI (deploy@srv889511)
Captura de Pantalla Terminal CLI HabeasSafe
Sistemas Integrados (Justicia XXI / SAMAI) FastAPI · Uvicorn · OpenAPI 3.1
⚡

4. API REST & Swagger Interactivo

Microservicio asíncrono para consumo programático desde cualquier lenguaje.

Arquitectura Microservicio de Alta Concurrencia

Permite a las plataformas de gestión judicial integrar capacidades de anonimización en tiempo real en flujos de radicación y publicación de sentencias.

  • POST /api/v1/anonymize: Anonimiza texto judicial recibiendo opciones de motor y formato de seudónimos.
  • POST /api/v1/anonymize/file: Ingesta de archivos binarios (PDF, DOCX) con extracción automática.
  • POST /api/v1/rerender: Recibe modificaciones del operador y genera el documento final en milisegundos.
  • POST /api/v1/revert: Restaura el documento original aplicando el diccionario criptográfico inverso.
  • GET /api/v1/health: Healthcheck con monitoreo de cascada y latencia de inferencia.
  • GET /api/v1/models: Catálogo de modelos disponibles locales y cloud.
Abrir Swagger UI (/docs)
Swagger UI — HabeasSafe Core API v1.1.0
Captura de Pantalla Swagger UI HabeasSafe
Automatización, CI/CD y DevOps HTTP/2 · SSL TLS 1.3 · HMAC-SHA256
💻

5. Peticiones Directas cURL & Pipelines

Consumo directo mediante comandos de terminal para pruebas y automatizaciones.

Ejemplo: Anonimizar texto judicial en producción vía cURL 
curl -s -X POST https://habeassafe.sprintjudicial.com/api/v1/anonymize \
  -H "Content-Type: application/json" \
  -d '{
    "text": "El ciudadano Carlos Gómez con cédula 12345678 presentó tutela.",
    "mode": "tag"
  }'
Ecosistema IA · Model Context Protocol npx -y habeassafe-mcp · npm v1.0.1
🔌

6. Servidor MCP en npm (Claude Code, Cursor, Windsurf, OpenCode)

Conecta cualquier LLM o agente a HabeasSafe con 6 herramientas nativas para anonimizar documentos judiciales en tiempo real.

Conexión con Clientes de Inteligencia Artificial

El paquete habeassafe-mcp está publicado en el registro público de npm y no requiere instalar Python ni descargar modelos en el equipo local:

Claude Code (CLI oficial de Anthropic) 
claude mcp add habeassafe -- npx -y habeassafe-mcp
Cursor / Windsurf / Cline / Continue (mcp.json) 
{
  "mcpServers": {
    "habeassafe": {
      "command": "npx",
      "args": ["-y", "habeassafe-mcp"],
      "env": {
        "HABEASSAFE_API_BASE": "https://habeassafe.sprintjudicial.com/api/v1"
      }
    }
  }
}

6 Herramientas Nativas Disponibles para LLMs

  • anonimizar: Procesa expedientes judiciales con IA en cascada y genera mapping con hash SHA-256.
  • detectar_entidades: Inspecciona y cataloga PII sin alterar el documento original.
  • re_renderizar: Supervisión humana obligatoria del operador judicial (Acuerdo PCSJA24-12243, numeral 3.9).
  • revertir: Restaura el expediente original con verificación criptográfica de integridad.
  • salud_y_modelos: Consulta en vivo estado del motor, latencia y modelos en cascada.
  • cargar_caso_ejemplo: Entrega tutelas o demandas modelo colombianas listas para pruebas.
Ver en npmjs.com ↗
Núcleo de Procesamiento Lingüístico Presidio · spaCy · Regex Especializado
🔄

Pipeline Resiliente de 7 Tareas Especializadas

Diseñado para la especificidad jurídica colombiana y superación de limitaciones del NER genérico.

Tarea A

Identificadores Judiciales

Detección exacta de números de radicación de 23 dígitos de la Rama Judicial (formatos continuo, con guiones CSJ y con espacios) y Tarjetas de Identidad (T.I.).

Recall: 100%
Tarea B

Control de Sobre-Anonimización

Léxicos jurídicos que impiden anonimizar fórmulas procesales ("Acción de tutela", "Señor Juez", "Pretensiones", "Juzgado") que arruinarían el sentido del documento.

0% Falsos Positivos
Tarea C

Mapeo Reversible y Custodia

Asignación biunívoca de seudónimos, cálculo de huella criptográfica SHA-256 y exportación en formato JSONL para custodia bajo la Ley 1581 de 2012.

SHA-256 Sellado
Tarea D

Vías y Contactos Colombianos

Reconocimiento de prefijo internacional +57, celulares con espacios y nomenclaturas viales colombianas (Carrera, Kra, Calle, Diagonal, Manzana, Vereda).

Recall: 100%
Tarea E

Sujetos de Especial Protección

Detección contextual de fechas de nacimiento para proteger a menores de edad y adultos mayores conforme al mandato constitucional del Art. 44 C.P.

Art. 44 CP
Tarea F

Aislamiento entre Párrafos

El algoritmo SpanMerger prohíbe de forma estricta la fusión accidental de entidades a través de saltos de párrafo dobles (\n\n).

Sin Fugas
Tarea G

Cascada de IA Multi-Nivel

Arquitectura de fallback automático: Ollama Cloud (DeepSeek-V4.1-Flash / GLM-5.3) ➔ Tutelabots Soberanos Locales ➔ Motor Determinista Puro sin fallo.

Resiliencia 99.9%
Consola HTTP Ejecutor y Generador de Comandos cURL en Vivo
Base URL: https://habeassafe.sprintjudicial.com
Comando cURL generado 
curl -s -X POST https://habeassafe.sprintjudicial.com/api/v1/anonymize \
  -H "Content-Type: application/json" \
  -d '{"text": "El accionante Carlos Alberto Gómez con cédula 79845123 presentó tutela.", "mode": "tag"}'
Respuesta del Servidor HTTP Esperando ejecución... - 
Haz clic en "▶ Ejecutar Petición Directa" para enviar la llamada HTTP real a la API en producción.
OpenAPI Explorer Probador Interactivo de Endpoints REST
Ver en Swagger UI
POST /api/v1/anonymize
GET /api/v1/health
GET /api/v1/models
POST /api/v1/revert

POST /api/v1/anonymize

Procesa un texto judicial mediante Presidio + Reglas de Colombia + Cascada IA, retornando entidades, seudónimos y mapa de reversibilidad.

Respuesta JSON 200 OK 
{
  "message": "Presiona 'Enviar Solicitud a la API' para ejecutar en vivo contra el servidor."
}
Consola zsh Simulador Interactivo de Terminal CLI de HabeasSafe
Haz clic en un comando prefabricado o escribe en la consola
deploy@srv889511: ~/HabeasSafe (zsh)
Python 3.12
=== HABEASSAFE CLI v1.1.0 — PLATAFORMA JUDICIAL COLOMBIANA ===
Escribe un comando o selecciona una de las opciones de arriba para simular la ejecución.
deploy@srv889511:~/HabeasSafe$ _
$
Desktop Tkinter MVC Explorador de Componentes de la Interfaz de Escritorio (Offline)
Haz clic en los puntos interactivos numerados (Hotspots) para explorar cada módulo
HabeasSafe Desktop Application (macOS / Windows / Linux)
HabeasSafe Desktop Interface
Componente #1

Visor Comparativo de Documentos

Permite al juez u operador judicial visualizar el expediente original en paralelo con el documento intervenido. Soporta documentos de cientos de páginas con renderizado virtualizado para mantener fluidez en equipos con recursos moderados.

Cumplimiento Normativo: Sentencia T-323/24 (Principio de Transparencia y Trazabilidad Documental).
Lanzar en tu equipo local: ./run_mac.sh desktop
Expedientes Judiciales Modelo Casos de Prueba Reales de la Judicatura Colombiana
Haz clic en "Cargar y Probar" para ejecutar en la Consola en Vivo
Tutela de Salud

Tutela vs EPS por Cirugía Pediátrica

Contiene nombres del menor, madre accionante, número de cédula, celular, EPS y prescripciones médicas protegidas.

Menor de Edad Cédula Dirección Diagnóstico
Proceso Laboral

Demanda Ordinaria Laboral e Indemnización

Contiene razón social de la empresa, NIT con dígito de verificación, correo institucional, cédula del trabajador y cuantía.

NIT Email Cédula Salario
Rama Judicial

Auto con Radicado de 23 Dígitos CSJ

Contiene radicado oficial de 23 dígitos de la Rama Judicial, juzgado civil del circuito, fiscalía seccional y fecha de audiencia.

Radicado 23D Juzgado Fiscalía Fecha
Model Context Protocol HabeasSafe MCP Server (habeassafe-mcp v1.0.1 en npm)
📦 npm package 6 Tools MCP
anonimizar

Anonimiza un texto legal o judicial protegiendo datos personales (PII) con seudónimos coherentes y reversibles conforme a la Ley 1581 de 2012 y el Acuerdo PCSJA24-12243, numeral 3.9.

Respuesta JSON-RPC MCP Protocol
- Listo 
{
  "hint": "Selecciona una herramienta y haz clic en 'Ejecutar Herramienta MCP' para ver la respuesta JSON-RPC en tiempo real."
}
Calculadora de Huella Criptográfica SHA-256 en Vivo
Ley 1581 / 2012

Escribe o pega cualquier texto judicial para generar su firma digital SHA-256 inmutable de custodia.

Firma Digital Criptográfica (SHA-256):
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
0 caracteres · 0 bytes · Integridad certificable conforme al Decreto 1377 de 2013
Laboratorio de Des-Anonimización Reversible
Custodia Cerrada

Valida la restauración del documento original utilizando el mapa reversible mapping.json emitido por el sistema.

Mandatos de la Corte Constitucional (Sentencia T-323 de 2024)
1
Supervisión Humana Obligatoria

La IA es una herramienta de auxilio; el operador judicial mantiene la responsabilidad jurídica exclusiva y vinculante.

2
Transparencia y Explicabilidad

Las partes tienen derecho a conocer qué herramientas de IA o anonimización intervinieron en la providencia.

3
Seguridad y Soberanía de Datos

Prohibición de alimentar servicios externos comerciales con piezas de expedientes protegidas por reserva legal.

4
Reversibilidad y Auditoría

Garantía de acceso al expediente íntegro mediante custodia criptográfica para fines procesales legítimos.