Skip to main content

Free Image Library — Free CC Images & Audio MCP 🖼️

CI License: MIT PyPI

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_note stating the actual obligation — CC BY-NC rows are loudly flagged non-commercial-only before your client ships them into a paid campaign.
  • Serendipity: image_roulette picks 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

free_image_library-0.1.0.tar.gz (25.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

free_image_library-0.1.0-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

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

Hashes for free_image_library-0.1.0.tar.gz
Algorithm Hash digest
SHA256 04d81ed1d54fb265bf3565ca169c1dc90b2fc7fa89daba3ff19ae41890604b97
MD5 f027adafd7c3803dd5aa6e292eb1837c
BLAKE2b-256 dc5cd2a424e9c9603c51e20b76e683fe049a9a05869fcf8818507a431f3038c4

See more details on using hashes here.

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

Hashes for free_image_library-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 158aec8f273939bcbf07ccf4dd16817d72d844d042a295b20da350919c8788f9
MD5 48f5504dfb83187cb35e961658cd2903
BLAKE2b-256 371337a775b9fc1e52ee818a0f195517c2d359f2a9db177332c64c5c53559543

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page