Repolode
Предложить
hystax

hystax/optscale-kompressor

Бинарный файл на Rust, который детерминированно сжимает промпты coding-агентов и вывод инструментов, сохраняя возможность при необходимости получить удалённые данные.

Открыть на GitHub
Звёзды
21
Форки
6
Открытые issues
13
Последний коммит
18 часов назад

Что это?

OptScale Kompressor уменьшает объём истории работы, которую coding-агенты, например Codex, Claude Code и Aider, отправляют модели на каждом шаге. В первую очередь сжимаются длинные логи сборки, вывод компилятора и списки файлов. В основе проекта — детерминированность: одинаковые входные данные каждый раз дают одинаковые байты, поэтому кэширование промптов у провайдера продолжает работать. Каждый удалённый фрагмент сохраняется под контентно-адресуемым идентификатором, по которому модель может получить его через инструмент retrieve.

Проект поставляется в виде одного бинарного файла, который может работать как CLI, HTTP API, MCP-сервер и LLM-прокси для OpenAI Chat Completions, OpenAI Responses и Anthropic Messages. Команда `kompressor wrap codex` запускает прокси, направляет через него агент и завершает его работу при выходе. Сжатие выполняется локально, без загрузки модели, с использованием упорядоченного определения содержимого и грамматик tree-sitter для исходного кода. Доступны три режима: aggressive (с потерями), lossless и recoverable (по умолчанию).

По данным репозитория, в запуске Terminal-Bench 2.1 на 89 задачах расходы снизились на 22,7% по сравнению с работой без сжатия. Расчёт основан на счетах провайдера и учитывает скидки за кэширование промптов.

Ключевые возможности

  • 01Детерминированный результат сохраняет попадания в кэш промптов между шагами.
  • 02Удалённое содержимое можно получить по идентификаторам через встроенный инструмент retrieve.
  • 03Поддерживает Codex, Claude, Aider, OpenCode и Cursor или работает как прокси для любого клиента.
  • 04Работает локально без загрузки модели, определяя содержимое по правилам и используя tree-sitter для кода.
  • 05В одном бинарном файле доступны CLI, HTTP API, MCP-сервер и библиотека Rust.

Сценарии использования

  • Снижение расходов на токены в длительных сессиях coding-агентов с объёмными логами сборки или тестов.
  • Направление трафика команды к LLM через общий локальный прокси, который сжимает результаты работы инструментов.
  • Добавление сжатия и извлечения данных на основе MCP в агента с поддержкой MCP-серверов.

Быстрый старт

  1. 1

    Установите с помощью Cargo (Rust 1.90 или новее)

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

    Запустите Codex через прокси compressor

    kompressor wrap codex

Что важно знать

  • Автоматическая обёртка поддерживается только для Codex; Claude Code проходит через прокси без сжатия.
  • Запросы Cursor-agent отклоняются, поскольку прокси не может прочитать его протокол.
  • Результаты бенчмарков предоставлены самим поставщиком проекта — OptScale AI.

Темы

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

Частые вопросы

Что такое optscale-kompressor?
Бинарный файл на Rust, который детерминированно сжимает промпты coding-агентов и вывод инструментов, сохраняя возможность при необходимости получить удалённые данные. OptScale Kompressor уменьшает объём истории работы, которую coding-агенты, например Codex, Claude Code и Aider, отправляют модели на каждом шаге. В первую очередь сжимаются длинные логи сборки, вывод компилятора и списки файлов. В основе проекта — детерминированность: одинаковые входные данные каждый раз дают одинаковые байты, поэтому кэширование промптов у провайдера продолжает работать. Каждый удалённый фрагмент сохраняется под контентно-адресуемым идентификатором, по которому модель может получить его через инструмент retrieve.
optscale-kompressor можно использовать бесплатно? Какая у него лицензия?
optscale-kompressor распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
optscale-kompressor всё ещё поддерживается?
Активно поддерживается. Последний коммит в optscale-kompressor — 20 окт. 2026 г..
Для чего можно использовать optscale-kompressor?
Снижение расходов на токены в длительных сессиях coding-агентов с объёмными логами сборки или тестов. Направление трафика команды к LLM через общий локальный прокси, который сжимает результаты работы инструментов. Добавление сжатия и извлечения данных на основе MCP в агента с поддержкой MCP-серверов.
Как установить optscale-kompressor?
Установите с помощью Cargo (Rust 1.90 или новее): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli Запустите Codex через прокси compressor: kompressor wrap codex
Где скачать optscale-kompressor?
Исходный код и инструкции по установке — на GitHub: https://github.com/hystax/optscale-kompressor

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты