vlmrun
Official Python SDK for VLM Run
Decision gist · record as of 2026-08-14
Yes, if you have a VLM Run API account and need a Python client for their platform. The SDK is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. The 15 runtime dependencies are substantial but manageable; consider using optional extras if you don't need all features. Not suitable if you need local model inference or don't have API credentials.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a valid VLM Run API key from app.vlm.run to authenticate requests.
- Low friction installation with a pure-Python wheel.
- Actively maintained with a release 7 days ago.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use without restriction, making it suitable for most production and research projects.
last release 2026-08-07 (7 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 168,232 downloads/mo, #10,451 on PyPI
Alternatives
Verify before relying
pip install vlmrun
from vlmrun.client import VLMRun
from vlmrun.common.utils import remote_image
client = VLMRun(api_key="<your-api-key>")
image = remote_image("https://example.com/image.jpg")
response = client.image.generate(images=[image], domain="document.invoice")
print(response)- Whether the 15 runtime dependencies are all required by default or if minimal installation is possible without optional extras.
- Performance characteristics and rate limits of the VLM Run API platform itself.
- Whether async support is available for all endpoints or only the agent completions endpoint.
What it is and what it does
VLM Run is the official Python SDK for interacting with the VLM Run API platform, a hosted service for vision-language models. It provides a client library to send images, documents, and text prompts to remote models and receive structured responses. The SDK wraps REST APIs for image generation (with domain-specific processing like invoice extraction), document analysis, and chat completions that are compatible with the OpenAI API format.
The package is designed for developers who want to integrate multimodal AI capabilities into Python applications without running models locally. It includes optional features for video processing, document handling, and OpenAI SDK compatibility, plus a CLI tool for interactive chat with skills (domain-specific expertise bundles). The SDK handles authentication, request formatting, and response parsing, reducing boilerplate when calling the platform's endpoints.
Use it for
- Extract structured data from invoices, receipts, or other documents by sending images to domain-specific models via the image.generate endpoint.
- Build a Python application that uses OpenAI-compatible chat completions to interact with VLM Run's Orion model asynchronously.
- Process video frames or document PDFs using the optional video and document extras for batch analysis workflows.
- Create a CLI chatbot with domain expertise by uploading skills to the VLM Run platform or passing local skill directories.
- Integrate multimodal AI into data pipelines using pandas and image libraries alongside the SDK's image processing methods.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have a VLM Run API account and need a Python client for their platform.
The SDK is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. The 15 runtime dependencies are substantial but manageable; consider using optional extras if you don't need all features. Not suitable if you need local model inference or don't have API credentials.
Install
vlmrun on PyPI
Before you install
Low friction installation with a pure-Python wheel. Actively maintained with a release 7 days ago. Supports Python 3.10–3.13. Brings 15 runtime dependencies including heavy libraries (opencv-python, pandas, Pillow); optional extras available for video, document, and OpenAI integration if you don't need the full stack.
Requires a valid VLM Run API key from app.vlm.run to authenticate requests.
License in practice
Apache-2.0 permissive license allows commercial and private use without restriction, making it suitable for most production and research projects.
Quickstart
pip install vlmrun
from vlmrun.client import VLMRun
from vlmrun.common.utils import remote_image
client = VLMRun(api_key="<your-api-key>")
image = remote_image("https://example.com/image.jpg")
response = client.image.generate(images=[image], domain="document.invoice")
print(response)Verify before relying
- Whether the 15 runtime dependencies are all required by default or if minimal installation is possible without optional extras.
- Performance characteristics and rate limits of the VLM Run API platform itself.
- Whether async support is available for all endpoints or only the agent completions endpoint.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagescachetoolsIPythonloguruopencv-pythonpandasPillowpydanticpydantic_corerequestsrichtabulatetenacitytqdmtypervlmrun-hub |
| Maintenance | Actively maintained 7 days since the last release |
| First released | |
| Downloads | 168,232 / month, #10,451 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOSOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Scientific/Engineering :: Artificial IntelligenceTopic :: Scientific/Engineering :: Image ProcessingTopic :: Software Development :: Libraries |
Evidence: vlmrun-0.7.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “image processing sdk”
- vlmrunPython SDK for the VLM Run API platform, providing access to…
- filestack-pythonOfficial Python SDK for Filestack that handles file uploads,…
- winrt-Windows.Graphics.ImagingProvides Python bindings to Windows Runtime (WinRT) graphics imaging…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also vlmrun-hub · zai-sdk · zhipuai · composio-openai · llama-index-llms-openai · llm · agent-framework-openai · notebooklm-py · mistralai · mlx-vlm