llm-rosetta 0.1.0a0__tar.gz

llm_rosetta-0.1.0a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Peng Ding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

llm_rosetta-0.1.0a0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: llm-rosetta
+Version: 0.1.0a0
+Summary: LLMIR: A library to convert between different LLM provider API standards using intermediate representation (IR).
+Author-email: Oaklight <oaklight@gmx.com>
+License-Expression: MIT
+Project-URL: Documentation, https://llmir.readthedocs.io
+Project-URL: Repository, https://github.com/Oaklight/llm-rosetta
+Project-URL: Issues, https://github.com/Oaklight/llm-rosetta/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing_extensions>=4.0.0; python_version < "3.11"
+Provides-Extra: openai
+Requires-Dist: openai; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic; extra == "anthropic"
+Provides-Extra: google
+Requires-Dist: google-genai; extra == "google"
+Provides-Extra: dev
+Requires-Dist: python-dotenv; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ty>=0.0.21; extra == "dev"
+Requires-Dist: build>=1.2.2.post1; extra == "dev"
+Requires-Dist: twine>=6.1.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: llm-rosetta[anthropic,dev,google,openai]; extra == "all"
+Dynamic: license-file
+
+# LLM-Rosetta
+
+[![PyPI version](https://badge.fury.io/py/llm-rosetta.svg)](https://badge.fury.io/py/llm-rosetta)
+[![GitHub version](https://badge.fury.io/gh/oaklight%2Fllmir.svg)](https://badge.fury.io/gh/oaklight%2Fllmir)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Oaklight/llmir)
+
+[English Version](README_en.md) | [中文版](README_zh.md)
+
+**Large Language Model Rosetta Stone** — A Python library for converting between different LLM provider API formats using a hub-and-spoke architecture with a central IR (Intermediate Representation).
+
+## Full Documentation
+
+Full documentation is available at:
+
+- **English**: [https://llmir.readthedocs.io/en/latest/](https://llmir.readthedocs.io/en/latest/)
+- **中文**: [https://llmir.readthedocs.io/zh-cn/latest/](https://llmir.readthedocs.io/zh-cn/latest/)
+
+## The Problem
+
+When building applications that work with multiple LLM providers, you face an N² conversion problem — every provider pair requires its own conversion logic. LLM-Rosetta solves this with a hub-and-spoke approach: each provider only needs a single converter to/from the shared IR format.
+
+```
+Provider A ──→ IR ──→ Provider B
+Provider C ──→ IR ──→ Provider D
+         ... and so on
+```
+
+## Supported Providers
+
+| Provider | API Standard | Request | Response | Streaming |
+|----------|-------------|:-------:|:--------:|:---------:|
+| OpenAI | Chat Completions | ✅ | ✅ | ✅ |
+| OpenAI | Responses API | ✅ | ✅ | ✅ |
+| Anthropic | Messages API | ✅ | ✅ | ✅ |
+| Google | GenAI API | ✅ | ✅ | ✅ |
+
+## Features
+
+- Unified IR format for messages, tool calls, and content parts
+- Bidirectional conversion: requests to provider format, responses from provider format
+- Streaming support with typed stream events
+- Auto-detection of provider from request/response objects
+- Support for text, images, tool calls, and tool results
+- Zero required dependencies (only `typing_extensions`); provider SDKs are optional
+
+## Installation
+
+### Basic Installation
+
+Install the core package (requires **Python >= 3.8**):
+
+```bash
+pip install llm-rosetta
+```
+
+### Installing with Provider SDKs
+
+```bash
+# Individual providers
+pip install llm-rosetta[openai]
+pip install llm-rosetta[anthropic]
+pip install llm-rosetta[google]
+
+# All providers
+pip install llm-rosetta[openai,anthropic,google]
+```
+
+### Optional Dependencies
+
+| Extra | Packages | Description |
+|-------|----------|-------------|
+| `openai` | `openai` | OpenAI Chat Completions & Responses API |
+| `anthropic` | `anthropic` | Anthropic Messages API |
+| `google` | `google-genai` | Google GenAI API |
+
+## Quick Start
+
+```python
+from llm_rosetta import OpenAIChatConverter, AnthropicConverter
+
+# Create converters
+openai_conv = OpenAIChatConverter()
+anthropic_conv = AnthropicConverter()
+
+# Convert an OpenAI response to IR, then to Anthropic format
+ir_messages = openai_conv.response_from_provider(openai_response)
+anthropic_request = anthropic_conv.request_to_provider(ir_messages)
+```
+
+### Auto-Detection
+
+```python
+from llm_rosetta import convert, detect_provider
+
+# Automatically detect provider and convert
+provider = detect_provider(some_response)
+ir_messages = convert(some_response, direction="from_provider")
+```
+
+### Cross-Provider Conversation
+
+```python
+from llm_rosetta import OpenAIChatConverter, GoogleGenAIConverter
+from llm_rosetta.types.ir import Message, ContentPart
+
+# Shared IR message history
+ir_messages = []
+
+# Turn 1: Ask OpenAI
+ir_messages.append(Message(role="user", content=[ContentPart(type="text", text="Hello!")]))
+openai_request = openai_conv.request_to_provider({"messages": ir_messages})
+openai_response = openai_client.chat.completions.create(**openai_request)
+ir_messages.extend(openai_conv.response_from_provider(openai_response))
+
+# Turn 2: Continue with Google — full context preserved
+google_request = google_conv.request_to_provider({"messages": ir_messages})
+```
+
+## Related Projects
+
+LLM-Rosetta is part of the ToolRegistry ecosystem:
+
+- **[ToolRegistry](https://github.com/Oaklight/ToolRegistry)** — Tool registration and management for LLM function calling
+- **[ToolRegistry Hub](https://github.com/Oaklight/toolregistry-hub)** — Ready-to-use tool collection
+- **[ToolRegistry Server](https://github.com/Oaklight/toolregistry-server)** — OpenAPI and MCP server adapters
+
+## Contributing
+
+Contributions are welcome! Please visit the [GitHub repository](https://github.com/Oaklight/llmir) to get started.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

llm_rosetta-0.1.0a0/README.md

@@ -0,0 +1,134 @@
+# LLM-Rosetta
+
+[![PyPI version](https://badge.fury.io/py/llm-rosetta.svg)](https://badge.fury.io/py/llm-rosetta)
+[![GitHub version](https://badge.fury.io/gh/oaklight%2Fllmir.svg)](https://badge.fury.io/gh/oaklight%2Fllmir)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Oaklight/llmir)
+
+[English Version](README_en.md) | [中文版](README_zh.md)
+
+**Large Language Model Rosetta Stone** — A Python library for converting between different LLM provider API formats using a hub-and-spoke architecture with a central IR (Intermediate Representation).
+
+## Full Documentation
+
+Full documentation is available at:
+
+- **English**: [https://llmir.readthedocs.io/en/latest/](https://llmir.readthedocs.io/en/latest/)
+- **中文**: [https://llmir.readthedocs.io/zh-cn/latest/](https://llmir.readthedocs.io/zh-cn/latest/)
+
+## The Problem
+
+When building applications that work with multiple LLM providers, you face an N² conversion problem — every provider pair requires its own conversion logic. LLM-Rosetta solves this with a hub-and-spoke approach: each provider only needs a single converter to/from the shared IR format.
+
+```
+Provider A ──→ IR ──→ Provider B
+Provider C ──→ IR ──→ Provider D
+         ... and so on
+```
+
+## Supported Providers
+
+| Provider | API Standard | Request | Response | Streaming |
+|----------|-------------|:-------:|:--------:|:---------:|
+| OpenAI | Chat Completions | ✅ | ✅ | ✅ |
+| OpenAI | Responses API | ✅ | ✅ | ✅ |
+| Anthropic | Messages API | ✅ | ✅ | ✅ |
+| Google | GenAI API | ✅ | ✅ | ✅ |
+
+## Features
+
+- Unified IR format for messages, tool calls, and content parts
+- Bidirectional conversion: requests to provider format, responses from provider format
+- Streaming support with typed stream events
+- Auto-detection of provider from request/response objects
+- Support for text, images, tool calls, and tool results
+- Zero required dependencies (only `typing_extensions`); provider SDKs are optional
+
+## Installation
+
+### Basic Installation
+
+Install the core package (requires **Python >= 3.8**):
+
+```bash
+pip install llm-rosetta
+```
+
+### Installing with Provider SDKs
+
+```bash
+# Individual providers
+pip install llm-rosetta[openai]
+pip install llm-rosetta[anthropic]
+pip install llm-rosetta[google]
+
+# All providers
+pip install llm-rosetta[openai,anthropic,google]
+```
+
+### Optional Dependencies
+
+| Extra | Packages | Description |
+|-------|----------|-------------|
+| `openai` | `openai` | OpenAI Chat Completions & Responses API |
+| `anthropic` | `anthropic` | Anthropic Messages API |
+| `google` | `google-genai` | Google GenAI API |
+
+## Quick Start
+
+```python
+from llm_rosetta import OpenAIChatConverter, AnthropicConverter
+
+# Create converters
+openai_conv = OpenAIChatConverter()
+anthropic_conv = AnthropicConverter()
+
+# Convert an OpenAI response to IR, then to Anthropic format
+ir_messages = openai_conv.response_from_provider(openai_response)
+anthropic_request = anthropic_conv.request_to_provider(ir_messages)
+```
+
+### Auto-Detection
+
+```python
+from llm_rosetta import convert, detect_provider
+
+# Automatically detect provider and convert
+provider = detect_provider(some_response)
+ir_messages = convert(some_response, direction="from_provider")
+```
+
+### Cross-Provider Conversation
+
+```python
+from llm_rosetta import OpenAIChatConverter, GoogleGenAIConverter
+from llm_rosetta.types.ir import Message, ContentPart
+
+# Shared IR message history
+ir_messages = []
+
+# Turn 1: Ask OpenAI
+ir_messages.append(Message(role="user", content=[ContentPart(type="text", text="Hello!")]))
+openai_request = openai_conv.request_to_provider({"messages": ir_messages})
+openai_response = openai_client.chat.completions.create(**openai_request)
+ir_messages.extend(openai_conv.response_from_provider(openai_response))
+
+# Turn 2: Continue with Google — full context preserved
+google_request = google_conv.request_to_provider({"messages": ir_messages})
+```
+
+## Related Projects
+
+LLM-Rosetta is part of the ToolRegistry ecosystem:
+
+- **[ToolRegistry](https://github.com/Oaklight/ToolRegistry)** — Tool registration and management for LLM function calling
+- **[ToolRegistry Hub](https://github.com/Oaklight/toolregistry-hub)** — Ready-to-use tool collection
+- **[ToolRegistry Server](https://github.com/Oaklight/toolregistry-server)** — OpenAPI and MCP server adapters
+
+## Contributing
+
+Contributions are welcome! Please visit the [GitHub repository](https://github.com/Oaklight/llmir) to get started.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

llm_rosetta-0.1.0a0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "llm-rosetta"
+dynamic = ["version"]
+authors = [{ name = "Oaklight", email = "oaklight@gmx.com" }]
+description = "LLMIR: A library to convert between different LLM provider API standards using intermediate representation (IR)."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = ['typing_extensions>=4.0.0; python_version < "3.11"']
+
+[project.optional-dependencies]
+openai = ["openai"]
+anthropic = ["anthropic"]
+google = ["google-genai"]
+dev = [
+    "python-dotenv",
+    "pytest",
+    "pytest-cov",
+    "ty>=0.0.21",
+    "build>=1.2.2.post1",
+    "twine>=6.1.0",
+]
+
+all = ["llm-rosetta[openai,anthropic,google,dev]"]
+
+[project.urls]
+Documentation = "https://llmir.readthedocs.io"
+Repository = "https://github.com/Oaklight/llm-rosetta"
+Issues = "https://github.com/Oaklight/llm-rosetta/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"llm_rosetta" = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = { attr = "llm_rosetta.__version__" }
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[tool.ty.src]
+include = ["src", "tests"]

llm_rosetta-0.1.0a0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

llm_rosetta-0.1.0a0/src/llm_rosetta/__init__.py

@@ -0,0 +1,61 @@
+"""
+LLMIR
+
+一个用于在不同LLM provider之间转换消息格式的库
+A library for converting message formats between different LLM providers
+"""
+
+from .auto_detect import (
+    ProviderType,
+    convert,
+    detect_provider,
+    get_converter_for_provider,
+)
+from .converters import (
+    AnthropicConverter,
+    BaseConverter,
+    GoogleConverter,
+    GoogleGenAIConverter,
+    OpenAIChatConverter,
+    OpenAIResponsesConverter,
+)
+from .types.ir import (
+    ContentPart,
+    ExtensionItem,
+    IRInput,
+    IRInputSimple,
+    Message,
+    ToolChoice,
+    ToolDefinition,
+    is_extension_item,
+    is_message,
+)
+
+__version__ = "0.1.0a0"
+
+__all__ = [
+    # 核心类型 Core types
+    "IRInput",
+    "IRInputSimple",
+    "Message",
+    "ContentPart",
+    "ExtensionItem",
+    "ToolDefinition",
+    "ToolChoice",
+    "ProviderType",
+    # 类型守卫函数 Type guard functions
+    "is_message",
+    "is_extension_item",
+    "is_part_type",
+    # 转换器 Converters
+    "BaseConverter",
+    "OpenAIChatConverter",
+    "AnthropicConverter",
+    "GoogleGenAIConverter",
+    "GoogleConverter",
+    "OpenAIResponsesConverter",
+    # 自动检测和转换 Auto-detection and conversion
+    "detect_provider",
+    "get_converter_for_provider",
+    "convert",
+]