Skip to content

MK15MK/bookaxis

Repository files navigation

bookaxis

A desktop tool that matches book/course titles against ISBN, Google Books, CrossRef, OpenLibrary, and (optionally) Perplexity to find university course adoptions.

This is a desktop GUI app (PyQt5) — there's no browser demo. See the screenshot/GIF below for a look at it running.

_add a screenshot or short screen-recording GIF of metadata_gui.py here_

Two entry points

  • metadata_gui.py — full "triple layer" mode: CrossRef + Google Books + OpenLibrary + Wikidata + Perplexity, with authenticity scoring. Requires a Perplexity API key for the Perplexity-backed lookups (everything else works without one).
  • meta.py — open-source-APIs-only fallback mode (CrossRef, Google Books, OpenLibrary, DuckDuckGo Lite). No Perplexity, no paid APIs required.

Both are GUI apps — run them and use the file-picker to load a master.xlsx/CSV of titles.

Setup

pip install -r requirements.txt
cp config.example.json config.json
python metadata_gui.py   # or: python meta.py

Fill in your own keys in config.json, or set them as environment variables instead (these take precedence, so you never need to put real keys in a file that could get committed):

PERPLEXITY_API_KEY=your-key
GOOGLE_BOOKS_KEY=your-key

sample.csv here is a small excerpt for trying the tool out; the original dataset used during development was much larger and isn't included.

Security notes

  • The original config.json and network_test.py had live API keys committed directly in the source — those have been removed and replaced with config.example.json (blank placeholders) plus environment-variable support.

License

MIT — see LICENSE.

About

Desktop tool (PyQt5) that matches book/course titles against ISBN, Google Books, CrossRef, OpenLibrary, and Perplexity to find university course adoptions

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages