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
- Message Preprocessor: extracts text content from documents (Word, Excel, PPT, Code files, PDFs) which are not natively supported by the target model.
- Chat Client Factory: creates a client for the specific LLM API with model parameters
- Model Message Converter: converts general messages to model messages
- Media Processor: converts general media (Image, Audio, Video, PDF) to model compatible formats.
- Model Message Converter: converts general messages to model messages
- 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
- Install uv:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - Install Python in uv:
uv python install 3.12; upgrade Python in uv:uv python upgrade 3.12 - 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
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file llm_bridge-2.0.0a1.tar.gz.
File metadata
- Download URL: llm_bridge-2.0.0a1.tar.gz
- Upload date:
- Size: 131.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9106f499a7a10f5bcb861e4501c4b77b600daafdb06bf17f1746050116abafd
|
|
| MD5 |
9b9ba17b49b74ccfdd580340d2a48a45
|
|
| BLAKE2b-256 |
8e3df9301f57f64abeff0c8f51aa59b5400d3bce37b23aaf07631982e96da707
|
File details
Details for the file llm_bridge-2.0.0a1-py3-none-any.whl.
File metadata
- Download URL: llm_bridge-2.0.0a1-py3-none-any.whl
- Upload date:
- Size: 49.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b17e0c9112385632783f6c3ab9c9116c9792527ab340bc2e8bbf8823ad29930a
|
|
| MD5 |
1a67f60bc4261272e0335b453642484c
|
|
| BLAKE2b-256 |
300cfd8ba89b8b38247067e54d1ef4ecafee6f8b64d6132a379d8453fd224cb1
|
