---
id: loadimg
version: "0.5.0"
license: Apache 2.0 License
license_treatment: permissive
maintenance: active
---

# loadimg — a python package for loading images

License: permissive · Maintenance: active · Downloads: 82.8K/mo

## What it is and what it does

loadimg is a lightweight image-loading utility that abstracts away format conversion boilerplate. It takes an image in any of several input forms—a file path, a URL, a numpy array, a PIL Image, or a base64 string—and converts it to your chosen output format with a single function call. The package includes automatic format detection, so you can pass `input_type="auto"` and let it figure out what you've given it.

The main use case is simplifying image handling in workflows that mix different libraries or APIs. For example, if you're building a chatbot that sends images to Hugging Face or OpenAI, you can load a remote image and immediately convert it to base64 without writing format-detection or encoding logic yourself. It has no external dependencies beyond what Python provides, making it quick to install and integrate.

Use it for:

- Convert images to base64 for API calls to Hugging Face, OpenAI, or FAL without manual encoding.
- Load images from URLs or local paths and convert to numpy arrays for ML model input.
- Normalize image input in a library or CLI tool that accepts multiple image sources.
- Switch between PIL and numpy representations without writing format-specific code.
- Build image preprocessing pipelines that accept flexible input types.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Loads and converts images between multiple formats—numpy arrays, PIL objects, file paths, URLs, and base64 strings—with automatic format detection.

Yes. The package is actively maintained, has no dependencies, installs instantly, and solves a real friction point in image-handling code. It's especially useful if you work with multiple image APIs or mix PIL and numpy in the same project. The permissive license and low install friction make it a low-risk addition.

## Install

pip install loadimg
uv add loadimg
poetry add loadimg

## Installing loadimg

Before you install: Low friction: pure Python wheel with no runtime dependencies. Actively maintained with recent commits and regular releases since March 2024.

License in practice: Apache 2.0 is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install loadimg

from loadimg import load_img

# Load from URL, convert to base64
img_b64 = load_img("https://example.com/image.jpg", output_type="base64")

# Load from file, convert to numpy
img_array = load_img("/path/to/image.png", output_type="numpy")

Verify before relying:

- Whether the package handles all common image formats (JPEG, PNG, GIF, WebP, etc.) or only a subset.
- Performance characteristics when loading large images or many images in sequence.
- Whether URL loading respects timeouts and handles redirects or authentication.
- Exact Python version compatibility (requires_python is unspecified in metadata).

## Package facts

- License: Apache 2.0 License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 82.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

image format conversion, load image from url, numpy to pil conversion, base64 image encoding, auto-detect image format, image-conversion, format-agnostic

[View on SkillFed](https://skillfed.io/packages/loadimg) · [View on PyPI](https://pypi.org/project/loadimg/)