TealTiger

---

⚡ Inicio rápido en 60 segundos

Instala: npm install tealtiger o pip install tealtiger, luego envuelve una llamada existente de OpenAI:```typescript import { TealOpenAI } from 'tealtiger'; const client = new TealOpenAI({ apiKey: process.env.OPENAI_API_KEY, guardrails: { promptInjection: true } }); const res = await client.chat.completions.create({ model: 'gpt-4o-mini', messages: [{ role: 'user', content: 'Hello!' }] }); console.log(res.security?.decision ?? 'ALLOW');

[No content provided in the input.]```python
import os
from tealtiger import TealOpenAI
client = TealOpenAI(api_key=os.environ["OPENAI_API_KEY"], guardrails={"prompt_injection": True})
print(client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Hello!"}]).security.decision)

Este es el fragmento 5 de 33 de un documento Markdown más largo que se traduce en secuencia. El idioma de origen es en. Idioma de destino: es. Tipo de contenido: fragmento 5/33 del README.

REGLAS ESPECÍFICAS DEL FRAGMENTO:

1. Traduzca SOLO texto en lenguaje natural. NUNCA traduzca: bloques de código, comandos de terminal, rutas de archivos, URLs, nombres de paquetes, identificadores técnicos, IDs CVE, nombres de variables de entorno.
2. Preserve TODA la sintaxis de Markdown EXACTAMENTE como está.
3. NO agregue encabezados introductorios como "## Fragmento N", "## Parte N", "## Continuación de..." o "## Traducción del fragmento...". NO agregue marcadores de "Fin del fragmento N" o "El contenido continúa...".
4. NO agregue marcadores de puntos suspensivos "..." para indicar omisión. Traduzca SOLO el texto exacto proporcionado, carácter por carácter en estructura.
5. Los límites de los fragmentos son intencionales. Preserve la estructura para que los fragmentos se puedan concatenar sin problemas y sin artefactos visuales.
6. Devuelva SOLO el texto traducido. Sin preámbulos, sin comentarios, sin envolver en bloques de código, sin JSON/YAML/XML, sin arreglos, sin objetos, sin esquemas, sin pares clave/valor.
7. Si el fragmento comienza a mitad de un párrafo, continúe traduciendo desde ese punto. No agregue un salto de línea inicial ni sangría a menos que exista en la fuente.

ENTRADA:```text ALLOW Governance receipt emitted; cost and guardrails tracked.

Siguiente: [Guía de inicio rápido completa](#-quick-start) y [ejemplos](https://github.com/agentguard-ai/tealtiger/blob/main/examples).

---

## 🔭 observe() — Instrumentación sin configuración (v1.4)

Una línea añade seguimiento de costos, registro de auditoría, detección de PII y líneas base de comportamiento a cualquier cliente LLM. Sin archivos de configuración, sin definiciones de políticas.```typescript
import { observe, freeze } from 'tealtiger';
const client = observe(new OpenAI());  // done — all calls are now instrumented
console.log(client.getCost());         // { totalCost: 0.0023, requestCount: 1, ... }

Tutorial

Guía paso a paso.

El siguiente repositorio es una herramienta predeterminada con muchas referencias del único e inigualable TCM Security y aquí hay una lista de recursos útiles.

Integraciones

Se integra con las siguientes herramientas.

• Bettercap - bettercap es un framework potente, fácilmente extensible y portátil.
• Responder - Responder es un envenenador de LLMNR, NBT-NS y MDNS.```python from tealtiger.observe import observe, freeze client = observe(OpenAI()) # done — all calls are now instrumented print(client.get_cost()) # ObserveCostSummary(total_cost=0.0023, ...)

**Lo que obtienes automáticamente:** seguimiento de costos por solicitud en 12 proveedores, registro de auditoría estructurado con ID de correlación, línea base de comportamiento (P50/P95/P99), detección de PII en modo REPORT_ONLY, y un interruptor de parada instantánea mediante `freeze()`. Menos de 5ms de sobrecarga por llamada.

Ver [examples/observe-quickstart.ts](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe-quickstart.ts) y [examples/observe_quickstart.py](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe_quickstart.py).

---

---

## 📊 Panel de Gobierno (v1.4)

Visibilidad en tiempo real de tu flota de agentes de IA — postura de seguridad, gobierno de costos y alertas de comportamiento en una sola vista.

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12842/41f95973c706522c5b907a5d7d96565247adff159a2de9a15c45087ae8dd1351.png" alt="TealTiger Governance Dashboard" width="900">
</div>



**Lo que ves de un vistazo:**
- **Fila de KPIs** — Solicitudes totales, costo, denegaciones de gobierno, consumo presupuestario con indicadores codificados por colores
- **Velocidad de Costo y Pronóstico Presupuestario** — Tendencias de tasa de consumo y proyección de agotamiento
- **Pipeline de Defensa** — Flujo de evaluación de seguridad en 3 etapas con tasas de cortocircuito y latencia por etapa
- **Alertas Canarias** — Detección de desviación de comportamiento con estado de congelación del agente y porcentajes de desviación
- **Matriz de Agentes** — Tabla de estado de la flota (activo/inactivo/congelado) con métricas de solicitudes por agente
- **Ahorros de Costo** — Recomendaciones de optimización clasificadas por impacto
- **Enrutamiento de Modelos** — Enrutamiento de origen a destino con ahorros por solicitud
- **Gobierno de Protocolo** — Tarjetas de políticas ENFORCE/MONITOR/REPORT_ONLY con conteos de denegaciones

Cada panel obtiene datos de forma independiente con aislamiento de fallos — un fallo de widget nunca se propaga a otros.

Ejecutar localmente: `cd dashboard/api && npm run dev` then `cd dashboard/web && npm run dev` (API on :3100, UI on :3000)

### Ruta de Divulgación Progresiva