qBittorrent AI Agent

An AI-powered assistant for qBittorrent that allows natural language interaction with your torrent client.

Features

• Natural Language Interface: Interact with qBittorrent using natural language commands
• Search Torrents: Search for torrents directly through the AI interface
• Download Management: View active downloads and add new torrents
• Media Information: Get detailed information about movies and TV shows
• Movie Recommendations: Find movie suggestions based on your preferences
• Web Interface: Built with Gradio for easy access through your browser
• Command Line Interface: Optional CLI mode for terminal-based interactions

Requirements

• Python 3.8+
• qBittorrent with WebUI enabled
• OpenAI API key or Ollama with qwen2.5-coder model

Installation

1. Clone this repository
2. Install dependencies:

   pip install -r requirements.txt
   

3. Create a .env file with your configuration:

   # qBittorrent API Configuration
   QBIT_HOST=http://localhost:8080
   QBIT_USERNAME=admin
   QBIT_PASSWORD=password
   
   # OpenAI API Key
   OPENAI_API_KEY=your_openai_api_key
   
   # DuckDuckGo Search Configuration
   DUCKDUCKGO_ENABLED=true
   DUCKDUCKGO_MAX_RESULTS=5
   
   # Optional: OMDB API key for movie information
   OMDB_API_KEY=your_omdb_api_key
   

Usage

Run the web interface:

python main.py

Or use the CLI interface by uncommenting the cli_main() line in main.py.

Example Commands

• "Find me sci-fi movies from 2023"
• "Show my current downloads"
• "Search for Game of Thrones season 1"
• "Tell me about the movie Interstellar"
• "What are some movies similar to The Matrix?"
• "Download the latest Ubuntu ISO"

Tools

The agent uses specialized tools organized into separate files for better modularity:

qBittorrent Tools (tools/qbit.py)

• get_downloads_list: Get information about current downloads
• qbittorrent_search: Search for torrents using qBittorrent's search functionality
• download_torrent: Add a torrent to the download queue

Search Tools (tools/search.py)

• duckduckgo_search: Search the web using DuckDuckGo for movie and TV show information
• movies_advice_search: Get recommendations and movie suggestions from multiple trusted sources

How It Works

The agent uses LangChain to connect to either OpenAI or Ollama models. It maintains conversation memory to provide context-aware responses. The agent intelligently decides which tool to use based on user queries and formats the responses in a user-friendly way.

License

MIT