Free Image Library — Free CC Images & Audio MCP 🖼️
Free images for any project: millions of openly-licensed, royalty-free Creative Commons images and audio (Flickr, Wikimedia, museums) — every result with ready-to-paste attribution. Zero API keys, zero configuration.
The visual sibling of the Free Music Library for the same content-creator audience: the agent finds the image AND the credit line in one call, so the attribution never gets lost between copy and paste.
Why this exists
- Models suggest random stock images (license unknown, credit never written). This returns license-safe images with the credit the user MUST paste — built into the same result.
- License intelligence, not just labels: every row carries a
credit_notestating the actual obligation — CC BY-NC rows are loudly flagged non-commercial-only before your client ships them into a paid campaign. - Serendipity:
image_roulettepicks from deep in the result set, not the first hit everyone has seen. - Built on Openverse — keyless (anonymous limits:
20 requests/min, 200/day, verified; a free registered key raises them via
OPENVERSE_API_KEY). A 5-minute TTL cache makes repeat searches free.
Tools
| Tool | What it does |
|---|---|
find_images |
Free CC image search with filters (license, aspect_ratio, size, extension) + attribution on every row |
image_roulette |
One random license-safe pick, honest about how it was chosen |
find_audio |
Free CC music / sound effects / field recordings from Openverse's audio index |
skills_list / skill_read |
Updatable playbooks: CC license briefs in plain language, error recovery |
Plus prompts: hero-image, license-safe-images.
Quickstart
# 1-Line Universal Installer (auto-configures Claude Desktop, Cursor, Claude Code, VS Code, ...)
curl -fsSL "https://free-image-library.builditwithai.xyz/install" | bash
# Or run directly via your preferred runtime:
uvx free-image-library
npx -y free-image-library
Example
User: I need a hero image for my climate blog post
find_images(query="melting glacier", aspect_ratio="wide", count=3,
intent="hero image for a climate blog post")
→ images: [{
title: "Glacier calving", creator: "…", license: "CC BY 2.0",
image_url: "https://…", width: 2048, height: 1152,
attribution: "\"Glacier calving\" image by … (flickr), licensed CC BY 2.0 (…)",
credit_note: "Credit REQUIRED — paste the attribution verbatim." }]
Telemetry & privacy
Anonymous usage telemetry (no PII, no queries, no paths) via the fleet
standard (schema v2, dual-endpoint fallback). Opt out any time:
FREE_IMAGE_LIBRARY_TELEMETRY=false or DO_NOT_TRACK=1.
Development
uv venv && uv pip install -e ".[dev]"
DO_NOT_TRACK=1 .venv/bin/python -m pytest tests/ -q # unit + live + e2e
Live tests hit the real Openverse API; they skip themselves when offline or rate-limited.
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file free_image_library-0.1.0.tar.gz.
File metadata
- Download URL: free_image_library-0.1.0.tar.gz
- Upload date:
- Size: 25.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04d81ed1d54fb265bf3565ca169c1dc90b2fc7fa89daba3ff19ae41890604b97
|
|
| MD5 |
f027adafd7c3803dd5aa6e292eb1837c
|
|
| BLAKE2b-256 |
dc5cd2a424e9c9603c51e20b76e683fe049a9a05869fcf8818507a431f3038c4
|
File details
Details for the file free_image_library-0.1.0-py3-none-any.whl.
File metadata
- Download URL: free_image_library-0.1.0-py3-none-any.whl
- Upload date:
- Size: 23.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
158aec8f273939bcbf07ccf4dd16817d72d844d042a295b20da350919c8788f9
|
|
| MD5 |
48f5504dfb83187cb35e961658cd2903
|
|
| BLAKE2b-256 |
371337a775b9fc1e52ee818a0f195517c2d359f2a9db177332c64c5c53559543
|