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 8 months ago
.env-example first commit 8 months ago
.gitignore first commit 8 months ago
LICENSE.md first commit 8 months ago
README.md first commit 8 months ago
main.py first commit 8 months ago
requirements.txt first commit 8 months ago
tools.py first commit 8 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