Skip to main content

VLM-RECog

A Python library for zero-shot object detection and segmentation using Vision-Language Models (VLMs), built on Google's Gemini 2.5 Flash model.

Installation

pip install vlm-recog
export GEMINI_API_KEY=<your_api_key>

Requirements

  • Python 3.11+
  • Google Gemini API key (set as GEMINI_API_KEY environment variable)

Quick Start

from PIL import Image
from vlm_recog.detection import detect
from vlm_recog.visualization import draw_detections

# Load an image
image = Image.open("path/to/image.jpg")

# Detect objects by text labels
result = detect(image, ["dog", "bicycle", "person"])

# Visualize results
output_image = draw_detections(image, result)
output_image.show()

Demo

output

Metadata

Release files for vlm-recog 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vlm-recog 0.2.2
File Size Uploaded Provenance
vlm_recog-0.2.2.tar.gz 943.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for vlm-recog 0.2.2
File Interpreter ABI Platform
vlm_recog-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 951.7 kB

Release files / vlm_recog-0.2.2.tar.gz

Download URL vlm_recog-0.2.2.tar.gz
Size 943.5 kB
Tags Source
SHA-256 checksum
How to use checksums
0256e7f6dcdb9bf9dc916bbc132c2ad821e4745e99a1240880b018d9991af7d5
BLAKE2b-256 checksum
How to use checksums
15f9ddce1c3968ef00d0bf37f8aff8ce2b384dec1a0b3b337a0434c01cc6479d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.15

Release files / vlm_recog-0.2.2-py3-none-any.whl

Download URL vlm_recog-0.2.2-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b64373268fd1f136962380c01c881a967932027c26cb1ec7043d4bcf1a2f6d8a
BLAKE2b-256 checksum
How to use checksums
268e1f894d4fc911aba1f3e11841a6f460bede4e527de12c99fa3a793b613dec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.15

Security for vlm-recog 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page