Repolode
Enviar
hystax

hystax/optscale-kompressor

Un binario de Rust que comprime de forma determinista los prompts y la salida de herramientas de agentes de programación, y permite recuperar el contenido eliminado cuando se solicita.

Ver en GitHub
Estrellas
21
Forks
6
Issues abiertos
13
Último commit
hace 18 horas

¿Qué es?

OptScale Kompressor reduce el tamaño del historial de trabajo que agentes de programación como Codex, Claude Code y Aider vuelven a enviar al modelo en cada paso, sobre todo los registros de compilación extensos, la salida del compilador y los listados. Está diseñado para ser determinista: la misma entrada produce los mismos bytes en cada turno, por lo que se mantienen los aciertos de la caché de prompts del proveedor. Cada fragmento eliminado se guarda tras un identificador basado en su contenido, que el modelo puede usar para recuperarlo mediante una herramienta retrieve.

El proyecto se distribuye como un único binario que funciona como CLI, API HTTP, servidor MCP y proxy de LLM para OpenAI Chat Completions, OpenAI Responses y Anthropic Messages. El comando `kompressor wrap codex` inicia el proxy, configura el agente para que lo use y lo cierra al terminar. La compresión se ejecuta localmente, sin descargar modelos, mediante detección ordenada de contenido y gramáticas de tree-sitter para código fuente. Hay tres modos disponibles: agresivo (con pérdida), sin pérdida y recuperable (el predeterminado).

El repositorio informa de una reducción de costos del 22,7 % frente a no aplicar compresión, en una ejecución de 89 tareas de Terminal-Bench 2.1, medida según las facturas de los proveedores e incluyendo los descuentos de la caché de prompts.

Funciones clave

  • 01Salida determinista que conserva los aciertos de la caché de prompts entre turnos.
  • 02El contenido eliminado se puede recuperar mediante identificadores y una herramienta retrieve integrada.
  • 03Admite Codex, Claude, Aider, OpenCode y Cursor, o funciona como proxy para cualquier cliente.
  • 04Se ejecuta localmente, sin descargar modelos, y usa detección basada en reglas y tree-sitter para el código.
  • 05Ofrece CLI, API HTTP, servidor MCP y biblioteca de Rust desde un mismo binario.

Casos de uso

  • Reducir los costos de tokens en sesiones prolongadas de agentes de programación con una salida extensa de compilación o pruebas.
  • Enrutar el tráfico de LLM de un equipo a través de un proxy local compartido que comprime los resultados de las herramientas.
  • Añadir compresión y recuperación basadas en MCP a un agente compatible con servidores MCP.

Inicio rápido

  1. 1

    Instalar con Cargo (Rust 1.90 o posterior)

    cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli
  2. 2

    Ejecutar Codex a través del proxy compressor

    kompressor wrap codex

Antes de usarlo

  • El envoltorio automático solo es compatible con Codex; Claude Code pasa sin compresión.
  • Se rechaza Cursor-agent porque el proxy no puede leer su protocolo.
  • Los resultados del benchmark son autodeclarados por el proveedor del proyecto, OptScale AI.

Temas

#prompt-compression#coding-agent#llm#llm-proxy#mcp#rust#token-optimization#prompt-caching

Preguntas frecuentes

¿Qué es optscale-kompressor?
Un binario de Rust que comprime de forma determinista los prompts y la salida de herramientas de agentes de programación, y permite recuperar el contenido eliminado cuando se solicita. OptScale Kompressor reduce el tamaño del historial de trabajo que agentes de programación como Codex, Claude Code y Aider vuelven a enviar al modelo en cada paso, sobre todo los registros de compilación extensos, la salida del compilador y los listados. Está diseñado para ser determinista: la misma entrada produce los mismos bytes en cada turno, por lo que se mantienen los aciertos de la caché de prompts del proveedor. Cada fragmento eliminado se guarda tras un identificador basado en su contenido, que el modelo puede usar para recuperarlo mediante una herramienta retrieve.
¿optscale-kompressor es gratuito? ¿Qué licencia tiene?
optscale-kompressor es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿optscale-kompressor sigue mantenido?
Mantenimiento activo. El último commit de optscale-kompressor fue el 20 oct 2026.
¿Para qué puedo usar optscale-kompressor?
Reducir los costos de tokens en sesiones prolongadas de agentes de programación con una salida extensa de compilación o pruebas. Enrutar el tráfico de LLM de un equipo a través de un proxy local compartido que comprime los resultados de las herramientas. Añadir compresión y recuperación basadas en MCP a un agente compatible con servidores MCP.
¿Cómo se instala optscale-kompressor?
Instalar con Cargo (Rust 1.90 o posterior): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli Ejecutar Codex a través del proxy compressor: kompressor wrap codex
¿Dónde consigo optscale-kompressor?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/hystax/optscale-kompressor

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados