Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/happer64bit/imagespuller
ImagesPuller is a tool for downloading images from the internet. It scrapes web data from various sources to gather image URLs and allows you to download them to your local machine.
https://github.com/happer64bit/imagespuller
contributions-welcome data-analytics images ml python
Last synced: about 1 month ago
JSON representation
ImagesPuller is a tool for downloading images from the internet. It scrapes web data from various sources to gather image URLs and allows you to download them to your local machine.
- Host: GitHub
- URL: https://github.com/happer64bit/imagespuller
- Owner: happer64bit
- Created: 2024-03-29T14:37:03.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-31T04:25:30.000Z (10 months ago)
- Last Synced: 2024-03-31T05:27:28.176Z (10 months ago)
- Topics: contributions-welcome, data-analytics, images, ml, python
- Language: Python
- Homepage:
- Size: 8.79 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ImagesPuller
ImagesPuller is a tool for downloading images from the internet. It scrapes web data from various sources to gather image URLs and allows you to download them to your local machine.
`imagespuller` is a tool designed to fetch images from various sources across the internet, allowing you to create your own datasets for various purposes, such as machine learning, data analysis, or simply gathering reference images.
## Features
- Supports scraping image URLs from multiple search engines.
- Easy-to-use interface.
- Ability to specify the search query and number of pages to scrape.
- Flexible output directory configuration.
## Installation
You can install `imagespuller` using pip:
```bash
pip install imagespuller
```
## Cli
```
Usage: python -m imagespuller [OPTIONS]
Options:
-q, --query TEXT Query for image on search engine
-s, --search-engine TEXT Search Engine to find (default: google)
-d, --dist TEXT Destination folder to save images (default:
downloaded_images)
-v, --verbose Enable verbose logging
--help Show this message and exit.
```
```
imagespuller -q Cat
```
## Usage
```python
from imagespuller import ImageSearch
searcher = ImageSearch()
image_urls = searcher.search_images("cat", provider="google", max_pages=1)
searcher.save_images(image_urls, query="cats", dist_folder="downloaded_images")
```
## Supported Providers
- Google
- Yandex
You can specify the provider when searching for images. By default, Google is used.
## Copyright Risks
Downloading and using images from the internet may pose copyright risks. Users of ImagesPuller are responsible for ensuring that they have the appropriate rights or permissions to use the downloaded images for their intended purposes. It is recommended to review the terms of use and licensing agreements of the sources from which images are downloaded to avoid copyright infringement.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.