Giter Site home page Giter Site logo

donnycrane / book-searcher Goto Github PK

View Code? Open in Web Editor NEW

This project forked from zu1k/bs-core

0.0 0.0 0.0 1.31 MB

Easy and blazing-fast book searcher, create and search your private library. Index metadata for over 10 million books in one minute, and search in 30µs.

Home Page: https://github.com/book-searcher-org/book-searcher

License: BSD 3-Clause "New" or "Revised" License

Shell 2.88% Rust 32.02% TypeScript 63.97% CSS 0.05% Makefile 0.32% HTML 0.39% Dockerfile 0.36%

book-searcher's Introduction

Book Searcher

GitHub stars GitHub forks Release GitHub issues GitHub license

Easy and blazing-fast book searcher, create and search your private library.

Book Searcher can index metadata for over 10 million books in one minute, and search in 30µs.

Usage

We currently offer both Desktop and Command-line versions. For individual users we recommend using the desktop version.

Desktop

1. Download the pre-compiled desktop installer from Release

Or you can compile by yourself. Refer to Build from source section for instructions.

  • Windows: Book-Searcher-desktop_version_x64.msi
  • macOS: Book-Searcher-desktop_version_x64.dmg
  • Linux:
    • Deb: Book-Searcher-desktop_version_amd64.deb
    • AppImage: Book-Searcher-desktop_version_amd64.AppImage

2. Prepare the index

Refer to Prepare the index section for instructions.

3. Run book-searcher-desktop

Specify the index folder path in the settings menu.

Cli

1. Download the pre-compiled binary from Release

Or you can compile by yourself. Refer to Build from source section for instructions.

2. Prepare the index

Refer to Prepare the index section for instructions.

3. Run book-searcher run

It will listen to 127.0.0.1:7070.

Access http://127.0.0.1:7070/ to use webui, or you can use the original search api.

Deploy with Docker

mkdir book-searcher && cd book-searcher
wget https://raw.githubusercontent.com/book-searcher-org/book-searcher/master/docker-compose.yml
# Prepare the index: put csv files in the directory, and run the following command to create index
docker-compose run --rm -v "$PWD:$PWD" -w "$PWD" book-searcher /book-searcher index -f *.csv
# start book-searcher
docker-compose up -d

Now book-searcher it will listen to 0.0.0.0:7070.

Deploy with Vercel / Netlify

Deploying the frontend to Vercel / Netlify to speed up loading of static resources and provide a reverse proxy to the image service.

Deploy with Vercel

Deploy to Netlify

Original Search Api

You can search by the following fields:

  • title
  • author
  • publisher
  • extension
  • language
  • isbn
  • id

Examples:

  • /search?limit=30&offset=0&title=TITLE
  • /search?limit=30&offset=0&title=TITLE&author=AUTHOR
  • /search?limit=30&offset=0&isbn=ISBN
  • /search?limit=30&offset=0&query=title:TITLE extension:epub publisher:PUBLISHER

We now have two search modes, /search?limit=30&offset=0&mode=explore&title=TITLE&author=AUTHOR

  • filter: the results need to meet all restrictions, default mode
  • explore: the results only need to meet certain restrictions

Build from source

Build Cli version

1. Build frontend

make frontend_preinstall frontend

2. Build book-searcher

TARGET=release make

# move the compiled binary to the project root directory
mv target/release/book-searcher .

Build Desktop version

1. Install frontend dependencies

make frontend_preinstall

2. Build book-searcher-desktop

cargo tauri build

Prepare the index

1. Prepare the raw data

Prepare the raw books metadata and save the csv files to the project root directory.

The raw data is used to generate the index, see Raw data section for details.

2. Create index

You may need to rm -rf index first.

book-searcher index -f *.csv

The finally folder structure should look like this:

book_searcher_dir
├── index
│   ├── some index files...
│   └── meta.json
└── book-searcher

Raw data

This raw data is used to generate index, should be a csv file with the following fields:

id, title, author, publisher, extension, filesize, language, year, pages, isbn, ipfs_cid, cover_url, md5

You will need to export and maintain your own meta information for the books you have purchased, as this project only provides fast searching.

License

book-searcher © The Book Searcher Authors, Released under the BSD-3-Clause License.

book-searcher's People

Contributors

zu1k avatar wybxc avatar yihong0618 avatar abisuq avatar xxchan avatar mtfcd avatar davorg avatar lufsx avatar mscaruf avatar n0vad3v avatar dp0d avatar sylvestre avatar missuo avatar datebro avatar hezhizhen avatar bhedouin avatar bolshoytoster avatar cheng-dai avatar xincmm avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.