Skip to main content

A library that wraps multiple LLM providers into a consistent API while using each provider's native SDK internally, supporting multimodal I/O, file processing, and stream output.

Project description

LLM Bridge

LLM Bridge is a Python library that wraps multiple LLM providers into a consistent API while using each provider's native SDK internally, supporting multimodal I/O, file processing, and stream output.

GitHub: https://github.com/windsnow1025/LLM-Bridge

PyPI: 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 the model's thinking process
    • Code Execution: generates and executes Python code
    • Web Search: generates response 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 Completion API Text, Image, PDF Thinking, Structured Output Text
OpenAI Responses API Text, Image, PDF Thinking, Web Search, Code Execution, Structured Output Text, Image
Google GenAI Text, Image, PDF, Audio, Video Thinking, Web Search, Code Execution, Structured Output Text, Image, File
Anthropic Text, Image, PDF Thinking, Web Search, Code Execution, Structured Output Text, File
xAI Text, Image, PDF, Audio, Video, docx, xlsx, pptx Thinking, Web Search, Code Execution, Structured Output Text

Planned Features

  • More features for API Types
  • Native support for Grok

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 upgrade 3.12
  3. Configure requirements:
uv sync --refresh

PyCharm

Add New Interpreter >> Add Local Interpreter

  • Environment: Select existing
  • Type: uv

Usage

Copy ./usage/.env.example and rename it to ./usage/.env, then fill in the environment variables.

Build

uv build

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llm_bridge-2.0.0.tar.gz (131.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llm_bridge-2.0.0-py3-none-any.whl (49.3 kB view details)

Uploaded Python 3

File details

Details for the file llm_bridge-2.0.0.tar.gz.

File metadata

  • Download URL: llm_bridge-2.0.0.tar.gz
  • Upload date:
  • Size: 131.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for llm_bridge-2.0.0.tar.gz
Algorithm Hash digest
SHA256 d8379557b7411664ac209e4401cfa8143a78cdfdf80b7b55dbee3afaa0c05e9b
MD5 645805dd559b5831559cdff68fcd585b
BLAKE2b-256 c6ef59913d41a22a36e8aa660e237f8b3911fc113e270405c0bd95ab820eee0f

See more details on using hashes here.

File details

Details for the file llm_bridge-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: llm_bridge-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 49.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for llm_bridge-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e1b134f54f8c7ce1bd63dbce25514ad914750599d1a8f0fcb9a25b92a11f2729
MD5 32e693ed84a45b592fe8915259a16c0e
BLAKE2b-256 7f3b54a0b5179ea10671e4464cc57db7f9129b1516a9a9e723b34e30768d93a3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page