# 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 agent includes several tools: - `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 - `ForcedDuckDuckGoSearch`: Search for information about media content ## License MIT