{"id":41162462,"url":"https://github.com/vlm-run/vlmrun-python-sdk","last_synced_at":"2026-01-22T19:25:10.768Z","repository":{"id":277580297,"uuid":"905442853","full_name":"vlm-run/vlmrun-python-sdk","owner":"vlm-run","description":"Official Python SDK for VLM Run","archived":false,"fork":false,"pushed_at":"2026-01-17T00:11:14.000Z","size":1419,"stargazers_count":12,"open_issues_count":7,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-17T12:50:06.274Z","etag":null,"topics":["computer-vision","genai","llm","ocr","python","vlm"],"latest_commit_sha":null,"homepage":"https://docs.vlm.run/sdk-reference/getting-started","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vlm-run.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-18T20:50:46.000Z","updated_at":"2026-01-17T00:11:18.000Z","dependencies_parsed_at":"2025-03-27T02:21:39.465Z","dependency_job_id":"516fced3-f738-421e-8994-0fb6eafc545c","html_url":"https://github.com/vlm-run/vlmrun-python-sdk","commit_stats":null,"previous_names":["vlm-run/vlmrun-python-sdk"],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/vlm-run/vlmrun-python-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlm-run%2Fvlmrun-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlm-run%2Fvlmrun-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlm-run%2Fvlmrun-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlm-run%2Fvlmrun-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vlm-run","download_url":"https://codeload.github.com/vlm-run/vlmrun-python-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlm-run%2Fvlmrun-python-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28669092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T17:07:18.858Z","status":"ssl_error","status_checked_at":"2026-01-22T17:05:02.040Z","response_time":144,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","genai","llm","ocr","python","vlm"],"created_at":"2026-01-22T19:25:10.038Z","updated_at":"2026-01-22T19:25:10.763Z","avatar_url":"https://github.com/vlm-run.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cp align=\"center\" style=\"width: 100%;\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/vlm-run/.github/refs/heads/main/profile/assets/vlm-black.svg\" alt=\"VLM Run Logo\" width=\"80\" style=\"margin-bottom: -5px; color: #2e3138; vertical-align: middle; padding-right: 5px;\"\u003e\u003cbr\u003e\n\u003c/p\u003e\n\u003ch2\u003eVLM Run Python SDK\u003c/h2\u003e\n\u003cp align=\"center\"\u003e\u003ca href=\"https://docs.vlm.run\"\u003e\u003cb\u003eWebsite\u003c/b\u003e\u003c/a\u003e | \u003ca href=\"https://app.vlm.run/\"\u003e\u003cb\u003ePlatform\u003c/b\u003e\u003c/a\u003e | \u003ca href=\"https://docs.vlm.run/\"\u003e\u003cb\u003eDocs\u003c/b\u003e\u003c/a\u003e | \u003ca href=\"https://docs.vlm.run/blog\"\u003e\u003cb\u003eBlog\u003c/b\u003e\u003c/a\u003e | \u003ca href=\"https://discord.gg/AMApC2UzVY\"\u003e\u003cb\u003eDiscord\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://pypi.org/project/vlmrun/\"\u003e\u003cimg alt=\"PyPI Version\" src=\"https://badge.fury.io/py/vlmrun.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/vlmrun/\"\u003e\u003cimg alt=\"PyPI Version\" src=\"https://img.shields.io/pypi/pyversions/vlmrun\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.pepy.tech/projects/vlmrun\"\u003e\u003cimg alt=\"PyPI Downloads\" src=\"https://img.shields.io/pypi/dm/vlmrun\"\u003e\u003c/a\u003e\u003cbr\u003e\n\u003ca href=\"https://github.com/vlm-run/vlmrun-python-sdk/blob/main/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/vlm-run/vlmrun-python-sdk.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/AMApC2UzVY\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/badge/discord-chat-purple?color=%235765F2\u0026label=discord\u0026logo=discord\"\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/vlmrun\"\u003e\u003cimg alt=\"Twitter Follow\" src=\"https://img.shields.io/twitter/follow/vlmrun.svg?style=social\u0026logo=twitter\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\nThe [VLM Run Python SDK](https://pypi.org/project/vlmrun/) is the official Python SDK for [VLM Run API platform](https://docs.vlm.run), providing a convenient way to interact with our REST APIs.\n\n\n## 🚀 Getting Started\n\n### Installation\n\n```bash\npip install vlmrun\n```\n\n### Installation with Optional Features\n\nThe package provides optional features that can be installed based on your needs:\n\n- Chat with Orion via the CLI (see `vlmrun chat`)\n  ```bash\n  pip install \"vlmrun[cli]\"\n  ```\n\n- Video processing features (numpy, opencv-python):\n  ```bash\n  pip install \"vlmrun[video]\"\n  ```\n\n- Document processing features (pypdfium2):\n  ```bash\n  pip install \"vlmrun[doc]\"\n  ```\n\n- OpenAI SDK integration (for chat completions API):\n  ```bash\n  pip install \"vlmrun[openai]\"\n  ```\n\n- All optional features:\n  ```bash\n  pip install \"vlmrun[all]\"\n  ```\n\n### Basic Usage\n\n```python\nfrom PIL import Image\nfrom vlmrun.client import VLMRun\nfrom vlmrun.common.utils import remote_image\n\n# Initialize the client\nclient = VLMRun(api_key=\"\u003cyour-api-key\u003e\")\n\n# Process an image using local file or remote URL\nimage: Image.Image = remote_image(\"https://storage.googleapis.com/vlm-data-public-prod/hub/examples/document.invoice/invoice_1.jpg\")\nresponse = client.image.generate(\n    images=[image],\n    domain=\"document.invoice\"\n)\nprint(response)\n\n# Or process an image directly from URL\nresponse = client.image.generate(\n    urls=[\"https://storage.googleapis.com/vlm-data-public-prod/hub/examples/document.invoice/invoice_1.jpg\"],\n    domain=\"document.invoice\"\n)\nprint(response)\n```\n\n### OpenAI-Compatible Chat Completions\n\nThe VLM Run SDK provides OpenAI-compatible chat completions through the agent endpoint. This allows you to use the familiar OpenAI API with VLM Run's powerful vision-language models.\n\n```python\nfrom vlmrun.client import VLMRun\n\nclient = VLMRun(\n    api_key=\"your-key\",\n    base_url=\"https://agent.vlm.run/v1\"\n)\n\nresponse = client.agent.completions.create(\n    model=\"vlmrun-orion-1\",\n    messages=[\n        {\"role\": \"user\", \"content\": \"Hello!\"}\n    ]\n)\nprint(response.choices[0].message.content)\n```\n\nFor async support:\n\n```python\nimport asyncio\nfrom vlmrun.client import VLMRun\n\nclient = VLMRun(api_key=\"your-key\", base_url=\"https://agent.vlm.run/v1\")\n\nasync def main():\n    response = await client.agent.async_completions.create(\n        model=\"vlmrun-orion-1\",\n        messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n    )\n    print(response.choices[0].message.content)\n\nasyncio.run(main())\n```\n\n**Installation**: Install with OpenAI support using `pip install vlmrun[openai]`\n\n## 🔗 Quick Links\n\n* 💬 Need help? Email us at [support@vlm.run](mailto:support@vlm.run) or join our [Discord](https://discord.gg/AMApC2UzVY)\n* 📚 Check out our [Documentation](https://docs.vlm.run/)\n* 📣 Follow us on [Twitter](https://x.com/vlmrun) and [LinkedIn](https://www.linkedin.com/company/vlm-run)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlm-run%2Fvlmrun-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvlm-run%2Fvlmrun-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlm-run%2Fvlmrun-python-sdk/lists"}