Installation#

Pre-built Binaries#

The easiest way to install ACloudViewer is using pre-built packages.

Python Installation#

Download wheel files from GitHub Releases.

Note

Current version: 3.9.4

Download from the Releases page.

Linux (Ubuntu 22.04, Python 3.13, CUDA)

wget https://github.com/Asher-1/ACloudViewer/releases/download/v3.9.4/cloudviewer-3.9.4-cp313-cp313-manylinux_2_35_x86_64.whl
pip install cloudviewer-3.9.4-cp313-cp313-manylinux_2_35_x86_64.whl

Linux (Ubuntu 22.04, Python 3.13, CPU-only)

wget https://github.com/Asher-1/ACloudViewer/releases/download/v3.9.4/cloudviewer_cpu-3.9.4-cp313-cp313-manylinux_2_35_x86_64.whl
pip install cloudviewer_cpu-3.9.4-cp313-cp313-manylinux_2_35_x86_64.whl

macOS (ARM64, Python 3.12)

wget https://github.com/Asher-1/ACloudViewer/releases/download/v3.9.4/cloudViewer-3.9.4-cp312-cp312-macosx_11_0_arm64.whl
pip install cloudViewer-3.9.4-cp312-cp312-macosx_11_0_arm64.whl

Windows (Python 3.12, CUDA)

# Download from GitHub Releases
pip install cloudViewer-3.9.4-cp312-cp312-win_amd64.whl

Tip

Adjust cp312 or cp313 for your Python version (cp310 for 3.10, cp311 for 3.11, cp312 for 3.12, cp313 for 3.13).

Desktop Application#

Download installers for your platform from GitHub Releases.

Linux (Ubuntu 22.04+)

# Download the .run installer
wget https://github.com/Asher-1/ACloudViewer/releases/download/v3.9.4/ACloudViewer-3.9.4-ubuntu22.04-cuda-amd64.run
chmod +x ACloudViewer-3.9.4-ubuntu22.04-cuda-amd64.run
./ACloudViewer-3.9.4-ubuntu22.04-cuda-amd64.run

macOS (11.0+)

# Download and open DMG file
open ACloudViewer-3.9.4-mac-cpu-ARM64.dmg

Or drag and drop the application to Applications folder.

Windows (10+)

Download the .exe installer from the releases page and run it. Follow the installation wizard.

Docker Installation#

Docker images are available for easy deployment.

docker pull ghcr.io/asher-1/acloudviewer:latest
docker run -it --gpus all ghcr.io/asher-1/acloudviewer:latest

See Docker Development for more information.

Verify Installation#

Python#

import cloudViewer as cv3d
print(cv3d.__version__)

# Test basic functionality
pcd = cv3d.geometry.ccPointCloud()
print("Installation successful!")

C++#

#include <cloudViewer/CloudViewer.h>
#include <iostream>

int main() {
    std::cout << "CloudViewer version: "
              << cv::utility::GetVersion() << std::endl;
    return 0;
}

Troubleshooting#

CUDA Issues#

If you encounter CUDA-related errors:

  1. Check CUDA installation:

nvidia-smi
nvcc --version

  1. Ensure CUDA version matches (11.8 or 12.x)

  2. Install CPU-only version if GPU is not required

Import Errors (Python)#

If you get ImportError:

  1. Check Python version (3.8-3.12 supported)

  2. Ensure correct wheel file for your system

  3. Install in a clean virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install cloudviewer-*.whl

Library Not Found (Linux)#

If you get library not found errors:

export LD_LIBRARY_PATH=/path/to/cloudviewer/lib:$LD_LIBRARY_PATH

Next Steps#