You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Matteo Benedetto 88c8bb39f8 first commit 12 months ago
.env-example first commit 12 months ago
.gitignore first commit 12 months ago
LICENSE.md first commit 12 months ago
README.md first commit 12 months ago
main.py first commit 12 months ago
requirements.txt first commit 12 months ago
tools.py first commit 12 months ago

README.md

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