De Cero a Pro: El Viaje de 5 Minutos

Objetivo: Transformarte de “Desarrollador Python” a “Ingeniero de Assurance IA” en 3 pasos.

---

La Filosofía: Cumplimiento como Código

Estás acostumbrado a pytest para verificar si tu función suma 2+2 correctamente. Pero, cómo pruebas si tu modelo de IA respeta los Derechos Humanos?

Venturalitica trata la “Assurance” como una dependencia. En lugar de consejos legales vagos, defines Políticas (OSCAL) estrictas. Tu pipeline CI/CD las aplica igual que reglas de linter.

El Plan de Estudios

Nivel	Rol	Objetivo
Empieza Aquí	Desarrollador	Ejecuta tu primera auditoría en < 60s.
Nivel 1	Ingeniero	Implementar Controles para Riesgos.
Nivel 2	Integrador	Viz & MLOps: “Cumplimiento como Metadata”.
Nivel 3	Auditor	Prueba: “Confía en la Caja de Cristal”.
Nivel 4	Arquitecto	Docs GenAI: “Anexo IV”.

---

Paso 1: Instalación

Recomendamos uv para velocidad extrema, o pip estándar.

uv

uv pip install venturalitica

pip

pip install venturalitica

Nota

Nota sobre Telemetría: Venturalitica recolecta estadísticas de uso anónimas (comandos ejecutados, errores técnicos) para mejorar la experiencia del desarrollador. No recolectamos datos de tus modelos ni de tus datasets. Puedes desactivarla configurando VENTURALITICA_NO_ANALYTICS=1. Ver política completa.

Paso 2: Obtén el Código

Para seguir la Academia, clona el repositorio de ejemplos. Este será tu directorio de trabajo para todos los niveles.

git clone https://github.com/venturalitica/venturalitica-sdk-samples.git
cd venturalitica-sdk-samples/scenarios/loan-credit-scoring

Paso 3: Ejecutando Tu Primera Auditoría

Ejecuta esta única línea de código. Descarga un dataset, carga una política y audita un modelo de riesgo crediticio.

import venturalitica as vl

# Ejecutar el escenario 'loan' (préstamos)
vl.quickstart('loan')

Salida:

  CONTROL                DESCRIPTION                            ACTUAL     LIMIT      RESULT
  ────────────────────────────────────────────────────────────────────────────────────────────────
  credit-data-imbalance  Data Quality                           0.429      > 0.2      PASS
  credit-data-bias       Disparate impact                       0.818      > 0.8      PASS
  credit-age-disparate   Age disparity                          0.286      > 0.5      FAIL
  ────────────────────────────────────────────────────────────────────────────────────────────────
  Audit Summary: VIOLATION | 2/3 controls passed

Mensaje para Llevar a Casa

Nota

“El Cumplimiento transforma Principios vagos en restricciones de Ingeniería verificables.”

• La Política: ratio > 0.5 (La Ley).
• La Realidad: 0.286 (Tu Código).
• El Veredicto: FAIL (La Brecha de Cumplimiento).

No necesitaste un abogado. Solo necesitaste una falla de test visible.

Paso 4: Elige Tu Camino

Ahora que has visto la falla, aprende cómo arreglarla y verificarla.

Nivel	Título	Descripción
Nivel 1	El Ingeniero	Aprende a implementar Controles que mitigan Riesgos identificados. Detecta y Bloquea modelos no conformes.
Nivel 2	El Integrador	Registra resultados en herramientas MLOps y verifica resultados visualmente en el Dashboard.
Nivel 3	El Auditor	Aprende a realizar una auditoría de “Caja de Cristal” en el modelo de préstamos y genera pruebas criptográficas.
Nivel 4	El Arquitecto	El Nivel Jefe. Entrena un modelo financiero de alto riesgo y genera la masiva Documentación Técnica requerida por la EU AI Act.

---

Referencias Externas

• EU AI Act: Texto Legal Completo (EUR-Lex) (Español)
• ISO 42001: Sistema de Gestión de IA (AIMS)
• NIST AI RMF: Marco de Gestión de Riesgos 1.0