PASH Ecosystem

Protocol for Agentic Semantic Hypermedia — Token-efficient format for AI agents

---

🌍 English

PASH is a complete ecosystem for reducing LLM token consumption across all stages of agent interaction:

• UI Generation (LLM → User Interface)
• Tool Calls (LLM → MCP Servers)
• Document Processing (LLM → Structured Data)

Components

Repository	Language	Purpose	Token Savings
pash-sdk	Node.js/TS	UI component generation	79-87%
pash-js	React/TS	React components for PASH/UI	79-87%
pash-gateway-v2	Node.js/TS	Enterprise gateway with billing	79-87%
pash-mcp-server	Python	MCP aggregator with PASH compression	87%

Total Token Savings

When used together, PASH ecosystem provides ~95% total token savings:

• Input optimization (schema minification): 70%
• Output optimization (PASH compression): 87%
• UI optimization (PASH/UI): 87%

Benchmarks (pash-mcp-server)

Scenario	Raw Tokens	PASH Tokens	Savings
GitHub MCP	293	47	84.0%
Scrapling MCP	3,032	209	93.1%
Filesystem MCP	1,972	387	80.4%
PostgreSQL MCP	6,649	1,285	80.7%
Research MCP	672	136	79.8%

Average: 85.3% token savings on MCP tool calls

Quick Start

For MCP Tool Calls (pash-mcp-server)

git clone https://github.com/AkynZH/pash-mcp-server.git
cd pash-mcp-server
pip install -r requirements.txt
python server.py

For UI Generation (pash-sdk)

npm install @akynzh/pash-sdk

Architecture

See docs/ARCHITECTURE.md for detailed architecture documentation.

License

All PASH ecosystem projects are licensed under MIT License.

---

🇷🇺 Русский

PASH — полная экосистема для экономии токенов AI-агентов на всех этапах взаимодействия:

• Генерация UI (LLM → Пользовательский интерфейс)
• Вызовы инструментов (LLM → MCP-серверы)
• Обработка документов (LLM → Структурированные данные)

Компоненты

Репозиторий	Язык	Назначение	Экономия токенов
pash-sdk	Node.js/TS	Генерация UI-компонентов	79-87%
pash-js	React/TS	React-компоненты для PASH/UI	79-87%
pash-gateway-v2	Node.js/TS	Enterprise gateway с биллингом	79-87%
pash-mcp-server	Python	MCP-агрегатор с PASH-сжатием	87%

Общая экономия токенов

При совместном использовании экосистема PASH обеспечивает ~95% общей экономии токенов:

• Оптимизация входа (сжатие схем): 70%
• Оптимизация выхода (PASH-сжатие): 87%
• Оптимизация UI (PASH/UI): 87%

Бенчмарки (pash-mcp-server)

Сценарий	Сырые токены	PASH-токены	Экономия
GitHub MCP	293	47	84.0%
Scrapling MCP	3,032	209	93.1%
Filesystem MCP	1,972	387	80.4%
PostgreSQL MCP	6,649	1,285	80.7%
Research MCP	672	136	79.8%

Средняя экономия: 85.3% токенов на вызовах MCP-инструментов

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

Для вызовов MCP-инструментов (pash-mcp-server)

git clone https://github.com/AkynZH/pash-mcp-server.git
cd pash-mcp-server
pip install -r requirements.txt
python server.py

Для генерации UI (pash-sdk)

npm install @akynzh/pash-sdk

Архитектура

См. docs/ARCHITECTURE.md для детальной документации по архитектуре.

Лицензия

Все проекты экосистемы PASH лицензированы под MIT License.

Contributing

Contributions welcome! Please see individual repositories for contribution guidelines.

Contact

• GitHub: @AkynZH
• Issues: Open an issue in the respective repository