Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucko515/search-book-by-cover-server
This is the main repository for the Book Search project. This engine allows you to search database of books by simply uploading an image of a cover.
https://github.com/lucko515/search-book-by-cover-server
content-based-image-retrieval deep-learning end-to-end-machine-learning flask machine-learning tensorflow
Last synced: about 2 months ago
JSON representation
This is the main repository for the Book Search project. This engine allows you to search database of books by simply uploading an image of a cover.
- Host: GitHub
- URL: https://github.com/lucko515/search-book-by-cover-server
- Owner: lucko515
- License: mit
- Created: 2020-01-08T15:15:28.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-02T06:16:52.000Z (almost 2 years ago)
- Last Synced: 2024-11-01T06:51:36.456Z (about 2 months ago)
- Topics: content-based-image-retrieval, deep-learning, end-to-end-machine-learning, flask, machine-learning, tensorflow
- Language: Python
- Size: 8.6 MB
- Stars: 20
- Watchers: 4
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
Book Search Engine (Server)
An application that allows user to search for their favorite book just by taking a picture of it.
Explore the docs »
## Table of Contents
* [About the Project](#about-the-project)
* [Built With](#built-with)
* [Getting Started](#getting-started)
* [Prerequisites](#prerequisites)
* [Installation](#installation)
* [Usage](#usage)
* [Contributing](#contributing)
* [License](#license)
* [Contact](#contact)
* [Acknowledgements](#acknowledgements)
## About The Project
There are many ways to search for a book that you are interested in - searching it by name, author, ISBN, and any other relevant features. That is all great, but the process is becoming very long as we introduce more and more features in the search system. And what if we want to find the cheapest place to buy the book? We would need to go to multiple websites and type the same query all over again!
This open-source project tries to solve that problem by leveraging the power of Deep Learning and creating an engine that allows an end-user to take a picture of books' cover and find places where they can buy the book.
This Book Search Engine is an open-source project that demonstrates a way of using Deep Learning in a real-world setting.
It is opened for contributions. :-)
### Built With
* [Tensorflow](https://www.tensorflow.org/)
* [Flask](https://www.palletsprojects.com/p/flask/)
* [OpenCV](https://opencv.org/)
## Getting Started
To get a local copy up and running follow these simple example steps.
### Prerequisites
To run this project you'll need **Python 3.5 or later** and all dependencies listed in the **requirements.txt**.
To install all dependencies listend in the requirements file:
```sh
pip install -r requirements.txt
```
### Installation
1. Clone the repo
```sh
git clone https://github.com/lucko515/search-book-by-cover-server.git
```
2. Create the **dataset** folder in the dataset_builder_module folder
```sh
mkdir dataset_builder_module/dataset
```
3. Download the books covers dataset from the Kaggle and unpack the dataset into the **dataset** folder
Link to the dataset: https://www.kaggle.com/lukaanicin/book-covers-dataset
4. Run the script **dataset_features_generator.py**
```sh
python(3) dataset_features_generator.py
```
5. Start the Flaks server with the **server.py**
```sh
python(3) server.py
```
## Usage examples
## Contributing
Let's improve this project together! :-)
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature_name/NewFeature`)
3. Commit your Changes (`git commit -m 'Explain your commit'`)
4. Push to the Branch (`git push origin feature_name/NewFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Contact
Luka Anicin - [@luka_anicin_fn](https://twitter.com/luka_anicin_fn) - [email protected]
Server of the project repo: [https://github.com/lucko515/search-book-by-cover-server](https://github.com/lucko515/search-book-by-cover-server)
Android application front-end repo: [https://github.com/lucko515/search-book-by-cover-android-app](https://github.com/lucko515/search-book-by-cover-android-app)
## Acknowledgements
* [Img Shields](https://shields.io)
* [DEep Local Features (DELF) paper](https://arxiv.org/pdf/1612.06321.pdf)
* [DELF Reference implementation](https://www.dlology.com/blog/easy-landmark-image-recognition-with-tensorflow-hub-delf-module/)
* [Readme Templates](https://github.com/othneildrew)
[forks-shield]: https://img.shields.io/github/forks/lucko515/search-book-by-cover-server.svg?style=flat-square
[forks-url]: https://github.com/othneildrew/search-book-by-cover-server/network/members
[stars-shield]: https://img.shields.io/github/stars/lucko515/search-book-by-cover-server.svg?style=flat-square
[stars-url]: https://github.com/othneildrew/search-book-by-cover-server/stargazers
[license-shield]: https://img.shields.io/github/license/lucko515/search-book-by-cover-server.svg?style=flat-square
[license-url]: https://github.com/lucko515/search-book-by-cover-server/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
[linkedin-url]: https://www.linkedin.com/in/luka-anicin/