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.0a2.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.0a2-py3-none-any.whl (49.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: llm_bridge-2.0.0a2.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.0a2.tar.gz
Algorithm Hash digest
SHA256 202d60bb1a3196abf58a00737b0cc4bf5d7740235757f2b8f4cd09a2878da2f1
MD5 54e50ae0a41c125286e96768c079ddba
BLAKE2b-256 026d36cae3027f91bcc0ff3117f816b57b8274bde1d564f9547c60aa6feb2e44

See more details on using hashes here.

File details

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

File metadata

  • Download URL: llm_bridge-2.0.0a2-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.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 436bc488793c32a354a21365782a7de37e91bc3fbb3b05dd0b74294e0cb38aeb
MD5 8406d8df8e7037b8d67e76803824e831
BLAKE2b-256 ffecaf0a7ae9ee0b83e16ad55f6711f2a21243e0b520f3bbbe1b5e5d34df7c78

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