¿Qué hace ProgramAsWeights (PAW)?
ProgramAsWeights compila una breve especificación en lenguaje natural en una función neuronal diminuta ("software neuronal") que toma una entrada de texto y devuelve una salida de texto y se ejecuta localmente. Compilas una vez en la API alojada; la función resultante luego se ejecuta localmente y sin conexión para siempre.
- Sitio web: https://programasweights.com
- Documentación: https://programasweights.readthedocs.io
Cuándo usar esto
Recurre a PAW cuando una tarea es difusa texto -> texto y la deseas barata, rápida, local
y repetible:
- Clasificación / categorización - sentimiento, urgencia, intención, tema, spam o líneas de registro
ALERTAvsTRANQUILO. - Extracción - extraer correos electrónicos, nombres, fechas, IDs o campos de texto desordenado/no estructurado.
- Reparación de formato / normalización - arreglar JSON roto, normalizar fechas, limpiar entradas inconsistentes.
- Coincidencia difusa - coincidencia tolerante a errores tipográficos, detección de casi duplicados, mapear una frase a la opción más cercana.
- Triaje / enrutamiento - filtrar ruido de registros, enrutar una solicitud al controlador correcto.
Reemplaza una expresión regular frágil o una costosa llamada LLM por elemento con una función pequeña que, después de compilar, se ejecuta en aproximadamente 0.05-0.5s localmente sin red.
Cuándo NO usarlo
- Generación larga o abierta (ensayos, código, chat) - usa un LLM completo.
- Razonamiento de múltiples pasos, matemáticas o tareas que necesitan amplio conocimiento del mundo.
- Cualquier cosa que no sea una sola entrada de texto -> una sola salida de texto. Las funciones son sin estado y comparten una ventana de ~2048 tokens entre especificación + entrada + salida.
Cómo usarlo (el flujo de trabajo)
1. Revisa el Hub primero. Alguien puede haber publicado una función; prueba un slug antes de compilar:
import programasweights as paw
fn = paw.function("email-triage") # descarga una vez, luego se ejecuta localmente
fn("¡Urgente: el servidor está caído!") # "inmediato"
fn("Boletín: picnic de primavera") # "esperar"
2. De lo contrario, compila tu propia. Una buena especificación es una descripción MÁS algunos
ejemplos Entrada: ... Salida: ... y una restricción de salida explícita:
import programasweights as paw
fn = paw.compile_and_load("""
Clasificar tickets de soporte. Devuelve SOLO uno de: facturación, error, función, otro.
Entrada: Me cobraron dos veces este mes
Salida: facturación
Entrada: El botón de exportar no hace nada
Salida: error
Entrada: Por favor añadan un modo oscuro
Salida: función
""")
fn("me volvieron a cobrar la tarjeta") # "facturación"
3. Itera con casos de prueba - la práctica #1. No aceptes el primer resultado. Construye un pequeño conjunto de pares entrada/esperado, mide la precisión, luego refina el texto y los ejemplos y recompila hasta que sea lo suficientemente bueno. Trátalo como software: prueba, depura los fallos específicos, corrige la especificación, vuelve a probar. Un bucle de evaluación mínimo:
import programasweights as paw
tests = [
{"input": "Me cobraron dos veces este mes", "expected": "facturación"},
{"input": "El botón de exportar no hace nada", "expected": "error"},
{"input": "Por favor añadan un modo oscuro", "expected": "función"},
]
fn = paw.compile_and_load(open("spec.txt").read())
results = [(t, fn(t["input"]).strip()) for t in tests]
misses = [(t, got) for t, got in results if got != t["expected"]]
print(f"precisión: {(len(tests) - len(misses)) / len(tests):.0%}")
for t, got in misses: # inspecciona fallos, luego corrige la especificación + recompila
print("FALLO:", t["input"], "-> obtuvo", repr(got), "deseaba", repr(t["expected"]))
Consulta references/writing-good-specs.md para saber cómo depurar los fallos.
4. Guarda el id del programa o slug y reutilízalo localmente. La inferencia no necesita servidor después de la primera descarga del activo.
Instalación
pip install programasweights --extra-index-url https://pypi.programasweights.com/simple/
Navegador / JavaScript: npm install @programasweights/web. Las funciones compiladas con
compiler="paw-4b-gpt2" se ejecutan en el lado del cliente a través de WebAssembly. Consulta references/browser-sdk.md.
Qué se ejecuta dónde (flujo de datos - lee antes de usar)
- Compilar envía tu especificación a la API de PAW alojada (
https://programasweights.com) y devuelve un id de programa. No pongas secretos en una especificación. - La inferencia se ejecuta localmente a través del SDK y funciona sin conexión después de la primera descarga.
- La autenticación es opcional - el uso anónimo funciona. Inicia sesión solo para límites de compilación más altos
y slugs con nombre (
export PAW_API_KEY=paw_sk_...).
Más detalles (cargar bajo demanda)
- API completa, compiladores, versionado, encadenamiento, autenticación:
references/api.md - Escribir y depurar especificaciones:
references/writing-good-specs.md - SDK de navegador / JavaScript:
references/browser-sdk.md - Errores comunes y correcciones:
references/troubleshooting.md - Casos de estudio prácticos (monitoreo de registros, búsqueda semántica, llamada a herramientas): https://programasweights.readthedocs.io