Flickr scraper is a Python tool designed to help you gather images from Flickr to create datasets for YOLO training. Given your search criteria, this tool simplifies the process of collecting relevant images for various computer vision tasks.
- Search image on Flickr using keywords.
- Download images directly for dataset assembly.
- Streamline the process of collecting training data for YOLO models.
Ensure you have Python 3.7 or later installed. The required dependencies can be installed using:
pip install -U -r requirements.txt
Key packages include:
flickrapi
To set up the Flickr scraper, follow these steps:
git clone https://github.com/ultralytics/flickr_scraper
cd flickr_scraper
pip install -U -r requirements.txt
Before you begin:
-
Obtain a Flickr API key here.
-
Insert your API key and secret into
flickr_scraper.py
:
# Replace with your Flickr API key and secret
key = "YOUR_API_KEY"
secret = "YOUR_API_SECRET"
- Execute the script with your search criteria. Specify the number of images to fetch (
--n
) and use--download
to save the images locally. Downloaded images are saved toflickr_scraper/images
. Keep in mind Flickr's rate limits and terms of use. Learn more from the Flickr API documentation.
Example command:
python3 flickr_scraper.py --search 'honeybees on flowers' --n 10 --download
You will see output similar to:
0/10 https://live.staticflickr.com/21/38596887_40df118fd9_o.jpg
...
9/10 https://live.staticflickr.com/1770/43276172331_e779b8c161_o.jpg
Done. (4.1s)
All images saved to /Users/glennjocher/PycharmProjects/flickr_scraper/images/honeybees_on_flowers/
Images are then available in the specified folder, ready for further processing or training.
If our project assists in your research or work, please consider citing it:
We welcome contributions from the community! Whether you're fixing bugs, adding new features, or improving documentation, your input is invaluable. Take a look at our Contributing Guide to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our Survey. A huge ๐ and thank you to all of our contributors!
![Ultralytics open-source contributors](https://github.com/ultralytics/assets/raw/main/im/image-contributors.png)
Ultralytics is excited to offer two different licensing options to meet your needs:
- AGPL-3.0 License: Perfect for students and hobbyists, this OSI-approved open-source license encourages collaborative learning and knowledge sharing. Please refer to the LICENSE file for detailed terms.
- Enterprise License: Ideal for commercial use, this license allows for the integration of Ultralytics software and AI models into commercial products without the open-source requirements of AGPL-3.0. For use cases that involve commercial applications, please contact us via Ultralytics Licensing.
For bug reports, feature requests, and contributions, head to GitHub Issues. For questions and discussions about this project and other Ultralytics endeavors, join us on Discord!