# 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 - **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 ## Installation 1. Clone this repository 2. Install dependencies: ``` pip install -r requirements.txt ``` 3. Create a `.env` file with your configuration: ``` OPENAI_API_KEY=your_openai_api_key QBIT_HOST=http://localhost:8080 QBIT_USERNAME=admin QBIT_PASSWORD=adminadmin ``` ## Usage Run the web interface: ``` python main.py ``` Or use the CLI interface by uncommenting the `cli_main()` line in `main.py`. ## Tools The tools are 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 - `media_info_search`: Find detailed information about movies, TV shows, or other media content - `movies_advice_search`: Get recommendations or advice about movies ## License MIT