Install From PyPI

This topic is only recommended for experienced users

If installed via pip, Furious will run on native Python. Requires Python 3.8 and above.

Core Building Tools

Note: These steps are the same in Xray-core-python or hysteria2-python Core Building Tools steps.

Note: Please pay extra attention that upstream projects are dropping build support on go 1.20.x

To install Furious via pip you must have tools ready for building these bindings for your current platform first. Core building requires:

go in your PATH. go 1.20.0 and above is recommended. To check go is ready, type go version. Also, if google service is blocked in your region(such as Mainland China), you have to configure your GOPROXY to be able to pull go packages. For Chinese users, refer to goproxy.cn for more information.
cmake in your PATH. To check cmake is ready, type cmake --version.
A working GNU C++ compiler(i.e. GNU C++ toolchains). To check GNU C++ compiler is ready, type g++ --version. These tools should have been installed in Linux or macOS by default. If you don't have GNU C++ toolchains(especially for Windows users) anyway:
- For Linux users: type sudo apt update && sudo apt install g++ and that should work out fine.
- For Windows users: install MinGW-w64 or Cygwin and make sure you have add them to PATH.

Note: Install Furious in a Python virtual environment(i.e. venv) is recommended.

Note: Furious supports minimum PySide6 version 6.1.0 since version 0.2.11.

Install depending on your go version:

pip install Furious-GUI will install necessary project dependencies, including PySide6, etc.
pip install "Furious-GUI[go1.20]" will install extra: 'Xray-core < 1.8.5', 'hysteria > 1.3.5', 'hysteria2 == 2.0.0.1'
pip install "Furious-GUI[go1.21]" will install extra: 'Xray-core > 1.8.5', 'hysteria2 > 2.0.4'

You can also choose to install requirements seperately.

Furious