LLM-Bridge 1.14.0__tar.gz → 1.14.0a0__tar.gz

{llm_bridge-1.14.0 → llm_bridge-1.14.0a0/LLM_Bridge.egg-info}/PKG-INFO

@@ -1,26 +1,27 @@
 Metadata-Version: 2.4
 Name: LLM-Bridge
-Version: 1.14.0
+Version: 1.14.0a0
 Summary: A Bridge for LLMs
 Author-email: windsnow1025 <windsnow1025@gmail.com>
 License-Expression: MIT
-License-File: LICENSE
-Keywords: ai,llm
+Keywords: llm,ai
 Classifier: Framework :: FastAPI
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
-Requires-Dist: anthropic==0.75.0
-Requires-Dist: docxlatex>=1.1.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: fastapi
-Requires-Dist: google-genai==1.46.0
 Requires-Dist: httpx
+Requires-Dist: tenacity
 Requires-Dist: openai==2.9.0
+Requires-Dist: tiktoken==0.11.0
+Requires-Dist: google-genai==1.46.0
+Requires-Dist: anthropic==0.75.0
+Requires-Dist: PyMuPDF
+Requires-Dist: docxlatex>=1.1.1
 Requires-Dist: openpyxl
-Requires-Dist: pymupdf
 Requires-Dist: python-pptx
-Requires-Dist: tenacity
-Requires-Dist: tiktoken==0.11.0
-Description-Content-Type: text/markdown
+Dynamic: license-file
 
 # LLM Bridge
 
@@ -76,12 +77,13 @@ pip install --upgrade llm_bridge
   uv sync
   ```
 
-### Pycharm Professional
+### Pycharm
+
+Add New Configuration >> uv run
+   - script: `./usage/main.py`
+   - Paths to ".env" files: `./usage/.env`
 
-1. Add New Interpreter >> Add Local Interpreter
-  - Environment: Select existing
-  - Type: uv
-2. Add New Configuration >> uv run >> script: `./usage/main.py`
+If uv interpreter is not found, create a new project with uv.
 
 ### Usage
 

llm_bridge-1.14.0a0/LLM_Bridge.egg-info/SOURCES.txt

@@ -0,0 +1,67 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+LLM_Bridge.egg-info/PKG-INFO
+LLM_Bridge.egg-info/SOURCES.txt
+LLM_Bridge.egg-info/dependency_links.txt
+LLM_Bridge.egg-info/requires.txt
+LLM_Bridge.egg-info/top_level.txt
+llm_bridge/__init__.py
+llm_bridge/client/__init__.py
+llm_bridge/client/chat_client.py
+llm_bridge/client/implementations/__init__.py
+llm_bridge/client/implementations/printing_status.py
+llm_bridge/client/implementations/claude/__init__.py
+llm_bridge/client/implementations/claude/claude_response_handler.py
+llm_bridge/client/implementations/claude/claude_token_counter.py
+llm_bridge/client/implementations/claude/non_stream_claude_client.py
+llm_bridge/client/implementations/claude/stream_claude_client.py
+llm_bridge/client/implementations/gemini/__init__.py
+llm_bridge/client/implementations/gemini/gemini_response_handler.py
+llm_bridge/client/implementations/gemini/gemini_token_counter.py
+llm_bridge/client/implementations/gemini/non_stream_gemini_client.py
+llm_bridge/client/implementations/gemini/stream_gemini_client.py
+llm_bridge/client/implementations/openai/__init__.py
+llm_bridge/client/implementations/openai/non_stream_openai_client.py
+llm_bridge/client/implementations/openai/non_stream_openai_responses_client.py
+llm_bridge/client/implementations/openai/openai_token_couter.py
+llm_bridge/client/implementations/openai/steam_openai_responses_client.py
+llm_bridge/client/implementations/openai/stream_openai_client.py
+llm_bridge/client/model_client/__init__.py
+llm_bridge/client/model_client/claude_client.py
+llm_bridge/client/model_client/gemini_client.py
+llm_bridge/client/model_client/openai_client.py
+llm_bridge/logic/__init__.py
+llm_bridge/logic/file_fetch.py
+llm_bridge/logic/model_prices.py
+llm_bridge/logic/chat_generate/__init__.py
+llm_bridge/logic/chat_generate/chat_client_factory.py
+llm_bridge/logic/chat_generate/chat_message_converter.py
+llm_bridge/logic/chat_generate/media_processor.py
+llm_bridge/logic/chat_generate/model_client_factory/__init__.py
+llm_bridge/logic/chat_generate/model_client_factory/claude_client_factory.py
+llm_bridge/logic/chat_generate/model_client_factory/gemini_client_factory.py
+llm_bridge/logic/chat_generate/model_client_factory/openai_client_factory.py
+llm_bridge/logic/chat_generate/model_client_factory/schema_converter.py
+llm_bridge/logic/chat_generate/model_message_converter/__init__.py
+llm_bridge/logic/chat_generate/model_message_converter/claude_message_converter.py
+llm_bridge/logic/chat_generate/model_message_converter/gemini_message_converter.py
+llm_bridge/logic/chat_generate/model_message_converter/openai_message_converter.py
+llm_bridge/logic/chat_generate/model_message_converter/openai_responses_message_converter.py
+llm_bridge/logic/message_preprocess/__init__.py
+llm_bridge/logic/message_preprocess/code_file_extensions.py
+llm_bridge/logic/message_preprocess/document_processor.py
+llm_bridge/logic/message_preprocess/file_type_checker.py
+llm_bridge/logic/message_preprocess/message_preprocessor.py
+llm_bridge/resources/__init__.py
+llm_bridge/resources/model_prices.json
+llm_bridge/type/__init__.py
+llm_bridge/type/chat_response.py
+llm_bridge/type/message.py
+llm_bridge/type/serializer.py
+llm_bridge/type/model_message/__init__.py
+llm_bridge/type/model_message/claude_message.py
+llm_bridge/type/model_message/gemini_message.py
+llm_bridge/type/model_message/openai_message.py
+llm_bridge/type/model_message/openai_responses_message.py

llm_bridge-1.14.0a0/LLM_Bridge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

llm_bridge-1.14.0a0/LLM_Bridge.egg-info/requires.txt

@@ -0,0 +1,11 @@
+fastapi
+httpx
+tenacity
+openai==2.9.0
+tiktoken==0.11.0
+google-genai==1.46.0
+anthropic==0.75.0
+PyMuPDF
+docxlatex>=1.1.1
+openpyxl
+python-pptx

llm_bridge-1.14.0a0/LLM_Bridge.egg-info/top_level.txt

@@ -0,0 +1 @@
+llm_bridge

llm_bridge-1.14.0a0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: LLM-Bridge
+Version: 1.14.0a0
+Summary: A Bridge for LLMs
+Author-email: windsnow1025 <windsnow1025@gmail.com>
+License-Expression: MIT
+Keywords: llm,ai
+Classifier: Framework :: FastAPI
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi
+Requires-Dist: httpx
+Requires-Dist: tenacity
+Requires-Dist: openai==2.9.0
+Requires-Dist: tiktoken==0.11.0
+Requires-Dist: google-genai==1.46.0
+Requires-Dist: anthropic==0.75.0
+Requires-Dist: PyMuPDF
+Requires-Dist: docxlatex>=1.1.1
+Requires-Dist: openpyxl
+Requires-Dist: python-pptx
+Dynamic: license-file
+
+# LLM Bridge
+
+LLM Bridge is a unified Python interface for interacting with LLMs, including OpenAI (Native / Azure / GitHub), Gemini (AI Studio / Vertex), Claude, and Grok.
+
+GitHub: [https://github.com/windsnow1025/LLM-Bridge](https://github.com/windsnow1025/LLM-Bridge)
+
+PyPI: [https://pypi.org/project/LLM-Bridge/](https://pypi.org/project/LLM-Bridge/)
+
+## Workflow and Features
+
+1. **Message Preprocessor**: extracts text content from documents (Word, Excel, PPT, Code files, PDFs) which are not natively supported by the target model.
+2. **Chat Client Factory**: creates a client for the specific LLM API with model parameters
+    1. **Model Message Converter**: converts general messages to model messages
+        1. **Media Processor**: converts general media (Image, Audio, Video, PDF) to model compatible formats.
+3. **Chat Client**: generate stream or non-stream responses
+    - **Model Thoughts**: captures and formats the model's thinking process
+    - **Code Execution**: auto generate and execute Python code
+    - **Web Search + Citations**: extracts and formats citations from search results
+    - **Token Counter**: tracks and reports input and output token usage
+
+### Supported Features for API Types
+
+The features listed represent the maximum capabilities of each API type supported by LLM Bridge.
+
+| API Type | Input Format                   | Capabilities                                                        | Output Format     |
+|----------|--------------------------------|---------------------------------------------------------------------|-------------------|
+| OpenAI   | Text, Image, PDF               | Thinking, Web Search, Code Execution                                | Text              |
+| Gemini   | Text, Image, Video, Audio, PDF | Thinking, Web Search + Citations, Code Execution, Structured Output | Text, Image, File |
+| Claude   | Text, Image, PDF               | Thinking, Web Search, Code Execution                                | Text              |
+| Grok     | Text, Image                    |                                                                     | Text              |
+
+#### Planned Features
+
+- Structured Output
+- More features for API Types
+- Native support for Grok
+
+## Installation
+
+```bash
+pip install --upgrade llm_bridge
+```
+
+## Development
+
+### Python uv
+
+1. Install uv: `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
+2. Install Python in uv: `uv python install 3.12`; upgrade Python in uv: `uv python install 3.12`
+3. Configure requirements:
+  ```bash
+  uv sync
+  ```
+
+### Pycharm
+
+Add New Configuration >> uv run
+   - script: `./usage/main.py`
+   - Paths to ".env" files: `./usage/.env`
+
+If uv interpreter is not found, create a new project with uv.
+
+### Usage
+
+Copy `./usage/.env.example` and rename it to `./usage/.env`, then fill in the environment variables.
+
+### Test
+
+```bash
+uv run pytest
+```
+
+### Build
+
+```bash
+uv build
+```

{llm_bridge-1.14.0 → llm_bridge-1.14.0a0}/README.md

@@ -52,12 +52,13 @@ pip install --upgrade llm_bridge
   uv sync
   ```
 
-### Pycharm Professional
+### Pycharm
 
-1. Add New Interpreter >> Add Local Interpreter
-  - Environment: Select existing
-  - Type: uv
-2. Add New Configuration >> uv run >> script: `./usage/main.py`
+Add New Configuration >> uv run
+   - script: `./usage/main.py`
+   - Paths to ".env" files: `./usage/.env`
+
+If uv interpreter is not found, create a new project with uv.
 
 ### Usage
 

{llm_bridge-1.14.0 → llm_bridge-1.14.0a0}/llm_bridge/logic/chat_generate/model_client_factory/openai_client_factory.py

@@ -65,7 +65,7 @@ async def create_openai_client(
     tools = []
     reasoning = None
 
-    if model not in ["gpt-5-pro", "gpt-5.2-pro"]:
+    if model not in ["gpt-5-chat-latest", "gpt-5-pro"]:
         if code_execution:
             tools.append(
                 CodeInterpreter(
@@ -73,15 +73,16 @@ async def create_openai_client(
                     container=CodeInterpreterContainerCodeInterpreterToolAuto(type="auto")
                 )
             )
-    tools.append(
-        WebSearchToolParam(
-            type="web_search",
-            search_context_size="high",
+    if model not in ["gpt-5-chat-latest"]:
+        tools.append(
+            WebSearchToolParam(
+                type="web_search",
+                search_context_size="high",
+            )
         )
-    )
-    if re.match(r"gpt-5.*", model):
+    if re.match(r"gpt-5.*", model) and model != "gpt-5-chat-latest":
         temperature = 1
-    if re.match(r"gpt-5.*", model):
+    if re.match(r"gpt-5.*", model) and model != "gpt-5-chat-latest":
         if thought:
             reasoning = Reasoning(
                 effort="high",

{llm_bridge-1.14.0 → llm_bridge-1.14.0a0}/llm_bridge/resources/model_prices.json

@@ -71,12 +71,6 @@
     "input": 2.5,
     "output": 15
   },
-  {
-    "apiType": "OpenAI",
-    "model": "gpt-5.2",
-    "input": 1.75,
-    "output": 14
-  },
   {
     "apiType": "OpenAI",
     "model": "gpt-5.1",
@@ -95,12 +89,6 @@
     "input": 0.25,
     "output": 2
   },
-  {
-    "apiType": "OpenAI",
-    "model": "gpt-5.2-pro",
-    "input": 21,
-    "output": 168
-  },
   {
     "apiType": "OpenAI",
     "model": "gpt-5-pro",

{llm_bridge-1.14.0 → llm_bridge-1.14.0a0}/pyproject.toml

@@ -1,10 +1,22 @@
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
 
 [project]
 name = "LLM-Bridge"
-version = "1.14.0"
+version = "1.14.0-alpha.0"
+authors = [
+    {name = "windsnow1025", email = "windsnow1025@gmail.com"}
+]
+description = "A Bridge for LLMs"
+readme = "README.md"
+requires-python = ">=3.12"
+keywords = ["llm", "ai"]
+license = "MIT"
+classifiers = [
+    "Framework :: FastAPI",
+    "Programming Language :: Python :: 3",
+]
 dependencies = [
     "fastapi",
     "httpx",
@@ -18,18 +30,6 @@ dependencies = [
     "openpyxl",
     "python-pptx", # pptx
 ]
-requires-python = ">=3.12"
-authors = [
-    {name = "windsnow1025", email = "windsnow1025@gmail.com"}
-]
-description = "A Bridge for LLMs"
-readme = "README.md"
-license = "MIT"
-keywords = ["llm", "ai"]
-classifiers = [
-    "Framework :: FastAPI",
-    "Programming Language :: Python :: 3",
-]
 
 [dependency-groups]
 dev = [
@@ -38,5 +38,9 @@ dev = [
     "python-dotenv", #dotenv
 ]
 
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["llm_bridge*"]
+
 [tool.pytest.ini_options]
-asyncio_default_fixture_loop_scope = "function"
+asyncio_default_fixture_loop_scope = "function"

llm_bridge-1.14.0a0/setup.cfg

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

llm_bridge-1.14.0/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

llm_bridge-1.14.0/.github/workflows/python-publish.yml

@@ -1,32 +0,0 @@
-name: "Publish"
-
-on:
-  push:
-    tags:
-      # Publish on any tag starting with a `v`, e.g., v0.1.0
-      - v*
-
-jobs:
-  run:
-    runs-on: ubuntu-latest
-    environment:
-      name: pypi
-    permissions:
-      id-token: write
-      contents: read
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-      - name: Install Python 3.12
-        run: uv python install 3.12
-      - name: Build
-        run: uv build
-      # Check that basic features work and we didn't miss to include crucial files
-#      - name: Smoke test (wheel)
-#        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test.py
-#      - name: Smoke test (source distribution)
-#        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test.py
-      - name: Publish
-        run: uv publish

llm_bridge-1.14.0/.gitignore

@@ -1,160 +0,0 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-.pybuilder/
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-# pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
-
-# pipenv
-#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-#   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
-#Pipfile.lock
-
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
-
-# pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#pdm.lock
-#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
-#   in version control.
-#   https://pdm.fming.dev/#use-with-ide
-.pdm.toml
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Pyre type checker
-.pyre/
-
-# pytype static type analyzer
-.pytype/
-
-# Cython debug symbols
-cython_debug/
-
-# PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-.idea/

llm_bridge-1.14.0/tests/chat_client_factory_test.py

@@ -1,20 +0,0 @@
-import pytest
-
-from llm_bridge.type.message import Message, Role, Content, ContentType
-
-
-@pytest.fixture
-def sample_messages():
-    return [
-        Message(role=Role.System, contents=[
-            Content(type=ContentType.Text, data="You are a helpful assistant.")
-        ]),
-        Message(role=Role.User, contents=[
-            Content(type=ContentType.Text, data="Hello")
-        ])
-    ]
-
-
-@pytest.mark.asyncio
-async def test_placeholder():
-    assert True

llm_bridge-1.14.0/tests/message_preprocessor_test.py

@@ -1,26 +0,0 @@
-import pytest
-
-from llm_bridge.logic.message_preprocess.message_preprocessor import extract_system_messages
-from llm_bridge.type.message import Message, Role, Content, ContentType
-
-
-@pytest.fixture
-def sample_messages():
-    return [
-        Message(role=Role.System, contents=[
-            Content(type=ContentType.Text, data="You are a helpful assistant.")
-        ]),
-        Message(role=Role.User, contents=[
-            Content(type=ContentType.Text, data="Hello")
-        ])
-    ]
-
-def test_extract_system_messages(sample_messages):
-    extracted_text = extract_system_messages(sample_messages)
-
-    assert extracted_text == "You are a helpful assistant.\n"
-
-    assert len(sample_messages) == 1
-    assert sample_messages[0].role == Role.User
-    assert sample_messages[0].contents[0].type == ContentType.Text
-    assert sample_messages[0].contents[0].data == "Hello"

llm_bridge-1.14.0/usage/.env.example

@@ -1,9 +0,0 @@
-OPENAI_API_KEY=
-GEMINI_FREE_API_KEY=
-GEMINI_PAID_API_KEY=
-GEMINI_VERTEX_API_KEY=
-ANTHROPIC_API_KEY=
-AZURE_API_KEY=
-AZURE_API_BASE=
-GITHUB_API_KEY=
-XAI_API_KEY=