Skip to content

feat(providers): add Free Nature Stock photo provider - #15

Merged
gitadityakumar merged 3 commits into
mainfrom
feat/freenaturestock-provider
Sep 1, 2026
Merged

gitadityakumar merged 3 commits into
mainfrom
feat/freenaturestock-provider

Conversation

@gitadityakumar

Copy link
Copy Markdown
Owner

Description

Adds Free Nature Stock as a supported asset provider in ast. Free Nature Stock is a curated collection of free CC0 nature, wildlife, and landscape photography created by Adrian Pelletier.

Features

  • Search: Queries https://freenaturestock.com/?s={query} and performs case-insensitive keyword and token matching on image alt titles and asset filenames.
  • Direct Master Photo Downloads: Constructs direct Cloudflare CDN URLs (https://cdn.freenaturestock.com/photos/{filename}.jpg) to download full-resolution camera master JPEGs (up to 20+ MB).
  • Metadata: Retains clean image IDs (freenaturestock-{id}), descriptive prompt titles, author credit (Adrian Pelletier), and source page URLs.
  • Integration: Fully wired into registry, CLI search commands (ast s freenaturestock ...), and interactive mode.

Verification

  • Tested via ast s freenaturestock "autumn" --limit 2 --json
  • Verified direct download via ast s freenaturestock "autumn" --first --download -o /tmp/downloads-test (downloaded 13 MB master JPEG @ 5472x3648)
  • Verified all unit and integration tests pass with zig build && zig build test.

@gitadityakumar
gitadityakumar merged commit 5214c10 into main Sep 1, 2026
1 check passed
@gitadityakumar
gitadityakumar deleted the feat/freenaturestock-provider branch September 2, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant