// readme

rosetta-ai

Universal translator between AI provider protocols.

Convert between OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, and Google Gemini APIs β€” with full support for tool calling, multimodal content, extended thinking, web search, grounding, and streaming.

Install

npm install @zenmux/rosetta-ai

How It Works

Each converter follows the gateway pattern: request goes forward (user protocol β†’ backend protocol), while response and stream go backward (backend β†’ user).

User ──request──→ [Converter] ──request──→ Backend
User ←─response── [Converter] ←─response── Backend
User ←──stream─── [Converter] ←──stream─── Backend

One converter instance handles the full round-trip for a single gateway route.

Converters

ConverterUser ProtocolBackend Protocol
ChatCompletionToMessagesConverterOpenAI Chat CompletionsAnthropic Messages
ChatCompletionToResponsesConverterOpenAI Chat CompletionsOpenAI Responses
ChatCompletionToGeminiConverterOpenAI Chat CompletionsGoogle Gemini
ChatCompletionToInteractionsConverterOpenAI Chat CompletionsGoogle Interactions V1
…