BotBuster-Ollama

Movie recommender using TMDB metadata + Ollama. It selects candidates via TF-IDF and asks the local LLM to rank and explain the top picks.

Setup

Prerequisites

1. Install Ollama:

• Download: OllamaSetup.exe

2. Pull a model:

ollama pull llama3.2:latest

Installation

git clone https://github.com/n0sync/BotBuster-Ollama
cd BotBuster-Ollama

python -m venv .venv
.\.venv\Scripts\Activate.ps1

pip install -r requirements.txt

Configuration

Create a .env file in the project root:

TMDB_API_KEY=your_api_key_here
OLLAMA_MODEL=llama3.2:latest

Get your TMDB API key at: https://www.themoviedb.org/settings/api

Usage

1. Add movies to watchlist.txt (one per line)
2. Run the recommender:

python main.py

Requirements

• Python 3.8+
• Ollama running locally
• TMDB API key

License

Apache License 2.0