loadimg

library0.5.0pypypiunverified

loadimg is a Python package for loading images from various sources (local files, URLs, base64 strings) and converting to multiple output types (PIL, numpy, base64, ASCII art, URL). Current version 0.5.0, released 2025-03-18. Active development.

data ai-ml

pip install loadimg

github ↗package ↗

INSTALL

IMPORT

SIG · LOADIMG

loadimg

datapythonv0.5.0

Install

1.7s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.5.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.000s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

load_img

✓ from loadimg import load_img

✗ from loadimg.utils import load_img

Load an image from URL as PIL Image.

from loadimg.utils import load_img img = load_img('https://example.com/image.jpg', output_type='pil') print(type(img))

Debug

Known issues

breakingIn v0.4.0, import paths changed from `loadimg` to `loadimg.utils`. Code using `from loadimg import load_img` will break.

fix

Use `from loadimg.utils import load_img`.

affects: >=0.4.0

breakingIn v0.3.0, the `output_type` parameter was introduced. Old code without `output_type` may return bytes instead of PIL Image.

fix

Explicitly specify `output_type='pil'` to get PIL Image.

affects: >=0.3.0

gotchaThe `load_img` function does not automatically detect input type; you must specify `input_type` for non-URL sources (e.g., base64).

fix

Use `input_type='base64'` when passing a base64 string.

affects: all

deprecatedThe `load_imgs` function (plural) was added in v0.5.0 but may change signature in future releases.

fix

Check release notes for updates.

affects: 0.5.0

Upgrade

Version history

0.5.0latest on PyPI · released Jul 22, 2025

Audit

Dependencies

Pillowrequiredrequired for PIL and numpy output

numpyoptionalrequired for numpy output

requestsrequiredrequired for loading from URLs

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/not-lain/loadimg ↗

packagehttps://pypi.org/project/loadimg/ ↗