Skip to content

Install From PyPI

Loren Eteval edited this page Feb 23, 2025 · 4 revisions

Warning

This topic is only recommended for experienced users


Note

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

Install

You have to install GUI and core seperatedly from PyPI.

Install GUI

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.

pip install Furious-GUI

Install Core

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

Supported cores(shipped as Python binding):

  • Xray-core
  • hysteria(go1.20 only)
  • hysteria2
  • tun2socks

e.g.

pip install Xray-core

Launch GUI

Furious
Clone this wiki locally