Repolode
Enviar
hystax

hystax/optscale-kompressor

Binário Rust que comprime de forma determinística prompts de agentes de programação e saídas de ferramentas, com opção de recuperar o conteúdo removido quando necessário.

Ver no GitHub
Estrelas
21
Forks
6
Issues abertas
13
Último commit
há 18 horas

O que é?

O OptScale Kompressor reduz o tamanho do histórico de trabalho que agentes de programação como Codex, Claude Code e Aider reenviam ao modelo a cada etapa, principalmente logs longos de build, saídas do compilador e listagens. O projeto é desenvolvido com foco em determinismo: a mesma entrada produz os mesmos bytes em todas as etapas, preservando os acertos do cache de prompts do provedor. Cada trecho removido é armazenado por trás de um identificador baseado no conteúdo, que o modelo pode usar para recuperá-lo por meio de uma ferramenta retrieve.

O projeto é distribuído como um único binário que funciona como CLI, HTTP API, servidor MCP e proxy de LLM para OpenAI Chat Completions, OpenAI Responses e Anthropic Messages. O comando `kompressor wrap codex` inicia o proxy, direciona o agente para ele e encerra tudo ao sair. A compressão é executada localmente, sem baixar modelos, usando detecção ordenada de conteúdo e gramáticas tree-sitter para código-fonte. Há três modos disponíveis: agressivo (com perda), sem perdas e recuperável (padrão).

O repositório informa uma redução de custos de 22,7% em comparação com a ausência de compressão, em uma execução de 89 tarefas do Terminal-Bench 2.1, com medição baseada nas faturas dos provedores e incluindo os descontos do cache de prompts.

Recursos principais

  • 01Saída determinística, preservando os acertos do cache de prompts entre etapas.
  • 02O conteúdo removido pode ser recuperado por meio de identificadores e de uma ferramenta retrieve integrada.
  • 03Integra-se ao Codex, Claude, Aider, OpenCode e Cursor, ou funciona como proxy para qualquer cliente.
  • 04Funciona localmente, sem baixar modelos, usando detecção baseada em regras e tree-sitter para código.
  • 05Oferece CLI, HTTP API, servidor MCP e biblioteca Rust no mesmo binário.

Casos de uso

  • Reduzir os custos com tokens em sessões longas de agentes de programação com saídas extensas de build ou testes.
  • Direcionar o tráfego de LLM de uma equipe por um proxy local compartilhado que comprime resultados de ferramentas.
  • Adicionar compressão e recuperação baseadas em MCP a um agente compatível com servidores MCP.

Início rápido

  1. 1

    Instale com Cargo (Rust 1.90 ou mais recente)

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

    Execute o Codex pelo proxy compressor

    kompressor wrap codex

Antes de usar

  • O encapsulamento automático só é compatível com o Codex; o Claude Code é encaminhado sem compressão.
  • O Cursor-agent é recusado porque o proxy não consegue ler o protocolo.
  • Os resultados do benchmark são autodeclarados pelo fornecedor do projeto, a OptScale AI.

Tópicos

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

Perguntas frequentes

O que é optscale-kompressor?
Binário Rust que comprime de forma determinística prompts de agentes de programação e saídas de ferramentas, com opção de recuperar o conteúdo removido quando necessário. O OptScale Kompressor reduz o tamanho do histórico de trabalho que agentes de programação como Codex, Claude Code e Aider reenviam ao modelo a cada etapa, principalmente logs longos de build, saídas do compilador e listagens. O projeto é desenvolvido com foco em determinismo: a mesma entrada produz os mesmos bytes em todas as etapas, preservando os acertos do cache de prompts do provedor. Cada trecho removido é armazenado por trás de um identificador baseado no conteúdo, que o modelo pode usar para recuperá-lo por meio de uma ferramenta retrieve.
optscale-kompressor é gratuito? Qual é a licença?
optscale-kompressor é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
optscale-kompressor ainda é mantido?
Manutenção ativa. O último commit de optscale-kompressor foi em 20 de out. de 2026.
Para que posso usar optscale-kompressor?
Reduzir os custos com tokens em sessões longas de agentes de programação com saídas extensas de build ou testes. Direcionar o tráfego de LLM de uma equipe por um proxy local compartilhado que comprime resultados de ferramentas. Adicionar compressão e recuperação baseadas em MCP a um agente compatível com servidores MCP.
Como instalar optscale-kompressor?
Instale com Cargo (Rust 1.90 ou mais recente): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli Execute o Codex pelo proxy compressor: kompressor wrap codex
Onde consigo optscale-kompressor?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/hystax/optscale-kompressor

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados