Orange Data Mining
Orange is a data mining and visualization toolbox for novice and expert alike. To explore data with Orange, one requires no programming or in-depth mathematical knowledge. We believe that workflow-based data science tools democratize data science by hiding complex underlying mechanics and exposing intuitive concepts. Anyone who owns data, or is motivated to peek into data, should have the means to do so.
Installing
On Windows and macOS, download the latest installer. To install an add-on, head to Options -> Add-ons... in the menu bar.
On Linux (or for development), install using conda, pip or uv.
Installing with Conda
First, install Miniconda for your OS.
Then, create a new conda environment, and install orange3:
# Add conda-forge to your channels for access to the latest release
conda config --add channels conda-forge
# Perhaps enforce strict conda-forge priority
conda config --set channel_priority strict
# Create and activate an environment for Orange
conda create python=3.12 --yes --name orange3
conda activate orange3
# Install Orange
conda install orange3
Run Orange from the correct environment.
conda activate orange3
python -m Orange.canvas
Note that the first launch may take some time.
For installation of an add-on, use:
conda install orange3-<addon name>
See specific add-on repositories for details.
Installing with pip
We recommend using our standalone installer or conda. Installation with pip might require a C/C++ compiler (on Windows we suggest using Microsoft Visual Studio Build Tools). To install Orange, create and activate a virtual environment, then run:
pip install PyQt6 PyQt6-WebEngine orange3
Run Orange by activating the environment and then executing python -m Orange.canvas. Note that the first launch may take some time.
Installing with uv
Install with
uv tool install -p 3.12 -w PyQt6,PyQt6-WebEngine orange3
add uv tools to the path (see instructions printed by uv) and then run orange with orange-canvas. The first launch may take some time.
Installing with winget (Windows only)
To install Orange with winget, run:
winget install --id UniversityofLjubljana.Orange
Developing
Want to write a widget? Use the Orange3 example add-on template.
Want to get involved? Join us on Discord, introduce yourself in #general!
Take a look at our contributing guide and style guidelines.
Check out our widget development docs for a comprehensive guide on writing Orange widgets.
The Orange ecosystem
The development of core Orange is primarily split into three repositories:
biolab/orange-canvas-core implements the canvas,
biolab/orange-widget-base is a handy widget GUI library,
biolab/orange3 brings it all together and implements the base data mining toolbox.
Additionally, add-ons implement additional widgets for more specific use cases. Anyone can write an add-on. Some of our first-party add-ons:
Setting up for core Orange development
First, fork the repository by pressing the fork button in the top-right corner of this page.
Set your GitHub username,
export MY_GITHUB_USERNAME=replaceme
create a conda environment, clone your fork, and install it:
conda create python=3.12 --yes --name orange3
conda activate orange3
git clone ssh://[email protected]/$MY_GITHUB_USERNAME/orange3
# Install PyQt. This will install PyQt6; you can also use PyQt5
pip install -r orange3/requirements-pyqt.txt
pip install -e orange3
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
