lucad87/smartarr repository overview

⁠SmartArr: Radarr AI Companion & Torznab Proxy

SmartArr is an intelligent Torznab proxy designed to enhance Radarr with the decision-making power of Large Language Models (LLM), specifically DeepSeek.

Instead of relying on simple regex or static quality scores, SmartArr intercepts Radarr's search queries, analyzes the releases using AI, and returns the perfect match based on your personal preferences (video quality, audio codecs, release groups, etc.).

⁠🚀 Key Features

• LLM-Powered Logic: Uses DeepSeek LLM to process release titles and select the one that best fits your criteria.
• Native Torznab Proxy: Integrates seamlessly into Radarr as a standard "Custom Torznab" Indexer.
• Zero-Replacement Companion: It doesn't replace Radarr; it works alongside it. Radarr manages the library and downloads, while SmartArr handles the "brain" work.
• Resilient Fallback: If the AI is unavailable, SmartArr automatically falls back to traditional logic (seeders/size) to ensure service continuity.
• Total Customization: Highly configurable via a simple YAML file (languages, preferred codecs, minimum seeders, etc.).

⁠🛠️ Quick Start (Docker Compose)

services:
  smartarr:
    image: lucad87/smartarr:latest
    container_name: smartarr
    ports:
      - "7879:8000"
    environment:
      - DEEPSEEK_API_KEY=your_api_key_here
      - PROWLARR_API_KEY=your_prowlarr_api_key_here
      - PROWLARR_BASE_URL=http://192.168.1.7:9696
    volumes:
      - ./config:/app/config
      - ./smartarr.db:/app/smartarr.db
    restart: unless-stopped

⁠⚙️ Radarr Configuration

Once the container is running, add SmartArr in Radarr under Settings > Indexers > Add > Torznab (Custom):

Name: SmartArr AI Proxy
URL: http://<YOUR_SERVER_IP>:7879
API Path: /api/v1/torznab/api
API Key: smartarr (or any string)
Categories: Movies, TV-Shows, etc..

⁠📂 Volumes & Persistence

• /app/config: Contains smartarr_config.yml. Edit this file to change AI priorities—changes take effect immediately without a container restart.
• /app/smartarr.db: A SQLite database that maintains a history of decisions and prevents redundant AI analysis.