Practicus AI Studio

You can install Practicus AI Studio using a standalone package or from the command line using uv or pip.

1. Standalone App Installers (macOS & Windows) 📦

This is the easiest way to get started and does not require a separate Python installation. You can download the latest installer packages from the Assets section of this release.

• macOS:

  • practicus-studio-arm.pkg: For Apple Silicon macOS.
  • practicus-studio.pkg: For Intel or Universal macOS.
  • Our packages are signed and notarized by Apple.

• Windows:

  • We recommend installing from the Microsoft Store to get automatic updates.
  • For offline installation, use the practicus-studio.msix package from the Assets section.
  • Our package is digitally signed for Microsoft.

2. Command-Line Install (All Platforms) 🐍

For users who prefer a command-line setup, we recommend using uv, a next-generation Python package manager that is extremely fast and reliable.

Using uv (Recommended)

Windows

:: 1. Install uv and restart terminal
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

:: 2. Create environment and install practicus
uv venv %UserProfile%\practicus\venv --python 3.10
call %UserProfile%\practicus\venv\Scripts\activate.bat
uv pip install --upgrade practicus

:: 3. Run
call %UserProfile%\practicus\venv\Scripts\activate.bat
practicus

macOS & Linux

# 1. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Create environment and install practicus
uv venv ~/practicus/venv --python 3.10
source ~/practicus/venv/bin/activate
uv pip install --upgrade practicus

# 3. Run
source ~/practicus/venv/bin/activate
practicus

Using pip with Python 3.10 (Alternative)

If you prefer to use pip with Python 3.10, you can follow these instructions. We strongly recommend using a virtual environment to avoid conflicts with other packages.

Windows

:: Create and activate a virtual environment
python -m venv %UserProfile%\practicus\venv
%UserProfile%\practicus\venv\Scripts\activate

:: Install or upgrade practicus
pip install --upgrade practicus

:: Run the app
practicus

macOS & Linux

# Create and activate a virtual environment
python3 -m venv ~/practicus/venv
source ~/practicus/venv/bin/activate

# Install or upgrade practicus
pip install --upgrade practicus

# Run the app
practicus

Linux Gnome user?

# Since Practicus AI is a QT C++ application,
# if you get qt.qpa.plugin error please run:
sudo apt-get install \
  '^libxcb.*-dev' libx11-xcb-dev \
  libglu1-mesa-dev libxrender-dev \
  libxi-dev libxkbcommon-dev \
  libxkbcommon-x11-dev

Enjoy!