dewey-oracle

Audiobookshelf Recommendation System

A web application that tracks your Audiobookshelf listening history and provides AI-powered book recommendations.

Features

• Syncs with Audiobookshelf server to track reading progress
• AI-powered book recommendations based on your listening history
• Web interface to view history and recommendations
• REST API for programmatic access

Setup

1. Install dependencies:

   pip install -r requirements.txt
   

2. Configure environment variables:

   cp .env.example .env
   # Edit .env with your Audiobookshelf URL, API token, and AI API key
   

3. Run the application:

   python main.py
   

4. Access the web interface at http://localhost:8000

API Endpoints

• GET / - Web interface
• GET /api/sync - Sync with Audiobookshelf
• GET /api/recommendations - Get book recommendations
• GET /api/history - View listening history

Configuration

See .env.example for all configuration options.