Zwyich SDK

Zwyich es un SDK en TypeScript para enrutar llamadas a modelos de lenguaje (LLM) entre distintos proveedores, con reglas contextuales, fallback y A/B testing.

Características

• Enrutamiento por contexto usando reglas definidas en JSON.
• Compatible con múltiples proveedores: OpenAI, Claude (Anthropic), Gemini (Google) y DeepSeek.
• Fallback configurable si un proveedor falla.
• A/B testing nativo para comparar dos configuraciones.
• Métricas de latencia (latencyMs) para cada llamada.

Instalación

npm install zwyich

Configuración

Crea un archivo zwyich.config.json en la raíz de tu proyecto. Ejemplo:

{
  "apiKeys": {
    "openai": "sk-...",
    "claude": "claude-...",
    "gemini": "gemini-...",
    "deepseek": "deepseek-..."
  },
  "rules": {
    "modulo-usuarios": { "provider": "openai",  "model": "gpt-4" },
    "modulo-finanzas": { "provider": "deepseek","model": "deepseek-coder" },
    "default":          { "provider": "openai",  "model": "gpt-4" }
  },
  "fallback": true,
  "abTest": true
}

Uso

import { initZwyich, callLLM } from 'zwyich';

async function main() {
  // Inicia configuración (local o descarga remota si no existe)
  await initZwyich({ remoteUrl: 'https://miapi.com/config.json' });

  // Llamada al LLM según contexto
  const resultado = await callLLM({
    context: 'modulo-usuarios',
    messages: [{ role: 'user', content: 'Hola, ¿cómo estás?' }]
  });
  console.log(resultado);
}

Flags por llamada

• abTest: true fuerza A/B testing en esta llamada.
• fallback: true fuerza uso de la regla default en caso de error.

Documentación

La documentación completa está en el directorio docs. Para verlo localmente:

npm install -g gitbook-cli
gitbook serve docs

Licencia

El uso de este SDK está sujeto a los términos de la licencia incluida en el archivo LICENSE.