Skip to main content
QuanuX supports three installation paths depending on your workflow. Conda is the recommended approach for most users — it handles Python dependencies, manages your environment alongside data science tools, and installs from the official QuanuX channel with no manual dependency resolution. If you’re already working in a pip-based environment or want to contribute to the codebase, the venv and source build paths are fully supported.

​
Prerequisites

Before installing, confirm you have the following available on your system:
Linux is the primary target platform for execution nodes. The server and CLI run on Linux and macOS. The Tauri desktop cockpit runs on Linux, macOS, and Windows. If you’re setting up a production execution node, use a Linux server.
QuanuX is the first quantitative trading platform to offer an official Conda channel. Installing through Conda places QuanuX in a managed environment alongside your Python data science stack — pandas, polars, numpy, DuckDB, and more — and lets you launch QuanuX directly from Anaconda Navigator.
1

Add the QuanuX and conda-forge channels

2

Install QuanuX

This creates the quanux environment with Python 3.11 and all required server-side dependencies.
3

Activate the environment

Once the QuanuX channel is added, you can manage upgrades with conda update quanux. The Conda environment also gives you direct access to ML tools like PyTorch without isolation conflicts.

​
Option 2: pip with a virtual environment

Use this path if you’re integrating QuanuX into an existing pip-managed project or prefer not to use Conda.
1

Create and activate a virtual environment

2

Install Python dependencies

This installs the full server dependency set, including FastAPI, uvicorn, keyring, the Rithmic async client, NATS, MCP, and AI provider SDKs (OpenAI, Google Generative AI).
3

Install Node.js dependencies

The requirements.txt is the pip fallback. Conda is preferred because it manages native binary dependencies (DuckDB, numpy, polars) more reliably. If you encounter compilation errors with pip, switch to the Conda path.

​
Option 3: Source build

Use the source build path if you want to contribute to QuanuX, access unreleased features, or build the Tauri desktop app from source.
1

Clone the repository

2

Set up the Python environment

3

Install Node.js dependencies

4

Build the Tauri desktop app (optional)

To run the desktop cockpit in development mode, you need Rust and Cargo installed. Then:
To produce a production desktop build:

​
Platform notes

Linux is the primary target for execution nodes. All bare-metal execution features — including Solarflare EF_VI kernel bypass, CPU core pinning, and quanuxctl nest deployments — require Linux. Production execution nodes must be compiled natively; cross-compilation and Docker are not supported for execution nodes. macOS is fully supported for running the server, cockpit, and CLI locally. It is the recommended development environment on Apple hardware. Windows is supported for the Tauri desktop cockpit only. Server and CLI functionality on Windows is not officially supported.

​
Verify your installation

After installing, confirm the server starts correctly:
You should see uvicorn report that it’s listening on 0.0.0.0:8080. If you see import errors, check that your Python environment is activated and all dependencies from requirements.txt or environment.yml are installed.

​
Next steps

Once QuanuX is installed, follow the Quickstart to configure your secrets, launch the cockpit, and run your first backtest.