پرش به محتویات

Welcome to python-v2ray

A powerful, high-level Python wrapper for managing and testing V2Ray/Xray-core and Hysteria clients.

This library abstracts away the complexities of binary management, multi-format config parsing, and concurrent connection testing, providing a clean, streamlined, and "Pythonic" API for developers. It's designed to be both powerful for advanced users and simple for those just getting started.

  • High-Speed Concurrent Testing

    Test dozens of proxies in seconds with a high-performance Go-based test engine.

  • Automated Binary Management

    Automatically downloads and manages the correct Xray and Hysteria binaries for your OS.

  • Unified Config Parser

    Seamlessly parse vless,Mvless, vmess, trojan, ss, and hysteria2 links into a standard object.

  • Fluent & Powerful API

    Programmatically build configs, run processes, and fetch live traffic stats with a clean API.

Get Started in 5 Minutes View on GitHub