DA3 package is not installing due to python version.

[danrossi]

UV is the only solution working to partially install the git of DA3 without error. And it installs the cuda Torch automatically which is good. However the DA3 package is badly configured it seems.

A manual install shows the error better why it is not installing.

I am testing Ubuntu for now which would be the target. python version 3.13.11 by default.

It's suggesting here because of the messy setup it requires max 3.12 as no 3.13 wheel. more info

https://pypi.org/project/open3d/#files

I don't know what they use it for but it's not compiled for GPU and needs to be compiled for Python 3.13.

https://www.open3d.org/docs/release/compilation.html#compilation

ByteDance-Seed/Depth-Anything-3#206

uv pip install git+https://github.com/ByteDance-Seed/Depth-Anything-3.git
warning: The `tool.uv.dev-dependencies` field (used in `pyproject.toml`) is deprecated and will be removed in a future release; use `dependency-groups.dev` instead
  × No solution found when resolving dependencies:
  ╰─▶ Because all versions of open3d have no wheels with a matching Python ABI tag (e.g., `cp313`) and depth-anything-3==0.0.0 depends on open3d, we can conclude
      that depth-anything-3==0.0.0 cannot be used.
      And because only depth-anything-3==0.0.0 is available and you require depth-anything-3, we can conclude that your requirements are unsatisfiable.

      hint: You require CPython 3.13 (`cp313`), but we only found wheels for `open3d` (v0.19.0) with the following Python ABI tags: `cp38`, `cp39`, `cp310`,
      `cp311`, `cp312`

Dev wheels can be installed for open3d. It may have cuda support built in to the dev wheels. https://www.open3d.org/docs/latest/getting_started.html#development-version-pip

[Tok]

Hi @danrossi! Thanks for reporting this issue and providing the detailed error information. 👍

Fix Implemented

I've addressed this in v0.9.1 with a two-part solution:

Part 1: Python Version Guard (Recommended for Most Users)

Commit: 47a5ca8

The package now explicitly blocks installation on Python 3.13+ with a clear error message explaining the open3d limitation:

Changes:

• ✅ Added requires-python = ">=3.9,<3.13" in pyproject.toml
• ✅ Added runtime version check with helpful error message linking to this issue
• ✅ Updated all documentation to clarify Python 3.9-3.12 support
• ✅ Added comprehensive unit tests for version checking

User Experience:

Depth Surge 3D requires Python 3.9-3.12, but you are using Python 3.13.
Python 3.13+ is not yet supported due to dependency limitations (specifically 'open3d' in Depth-Anything V3).
Please use Python 3.12 or earlier. See https://github.com/Tok/depth-surge-3d/issues/11 for updates.

Part 2: Advanced Compilation Guide (For Power Users)

Commit: abd999d

For advanced users who want Python 3.13 support NOW, I've added a comprehensive guide in docs/INSTALLATION.md explaining how to compile open3d from source.

The latest Open3D development version DOES support Python 3.13 when compiled from source, so this is a viable workaround for users comfortable with:

• CMake and C++ build tools
• 10-30 minute compilation time
• Debugging potential build issues

---

Why This Limitation Exists

As you correctly identified, open3d (a dependency of Depth-Anything V3) lacks pre-built wheels for Python 3.13. The upstream team is actively working on this:

• Tracking: Open3D Issue #7284
• Request: Open3D Issue #7318
• Status: Python 3.13 support exists in development branch, but no official wheels yet

---

Recommended Actions

For most users: Use Python 3.9-3.12 (we support all four versions)

• Python 3.12 is the latest fully supported version
• All features work perfectly on 3.9-3.12

For advanced users: Follow the compilation guide if you need Python 3.13

For the future: Once Open3D releases Python 3.13 wheels, I'll update Depth Surge 3D immediately to support 3.13+ (just a version constraint change)

---

Testing & Verification

I've added 3 new unit tests to ensure proper version checking:

• ✅ Python 3.13+ correctly rejected with helpful error
• ✅ Python 3.8 and below correctly rejected
• ✅ Python 3.9-3.12 work as expected

All tests passing, coverage maintained at >85%.

---

Your Note About uv

You mentioned that uv partially works and handles CUDA Torch dependencies automatically. That's great feedback! The uv package manager is indeed excellent for dependency resolution. However, it can't work around the missing open3d wheels for Python 3.13, so the version guard will still apply.

---

Thanks again for reporting this! The fix is now in the dev branch and will be included in the next release. Feel free to try the compilation route if you need Python 3.13 immediately, or let me know if you encounter any issues with Python 3.9-3.12.

I'll keep this issue open to track upstream Python 3.13 wheel availability. Once Open3D releases official wheels, I'll update and close this issue.

🚀

[danrossi]

I will test if installing the dev wheel works without compiling. They build with cuda for linux and have a separate cpu only version. I am not sure what it's used for in their project. I'm using uv for now it seems good but I think the pipenv issue is because of the python version issue. I have to work with Python 13 on windows for another project but I will try Python 12 in Ubuntu also.

[danrossi]

This theoretically should work but the wheel is missing so had to report that. Very complicated install process. It's almost working. I found the argument to run the v3 model also.

uv pip install -U -f https://www.open3d.org/docs/latest/getting_started.html --only-binary open3d open3d

[danrossi]

3.13 pThe missing wheel is because there is no linux build on github. This will force Python 3.12. It will help having multiple python versions. This project may require Pythin 3.12 also just because of that one package.

uv python pin 3.12

Windows support is becoming harder but this will work for Ubuntu

sudo apt update && sudo apt upgrade -y
sudo apt install software-properties-common -y
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install python3.12 python3.12-venv -y

3.12 pip does not install.

[danrossi]

A manual install was required after pinning 3.12. uv isn't installing the git url from requirements. pip is not installable with 3.12 only with the 3.13 package. And therefore only uv is working on Ubuntu now. Because of one package missing wheels.

uv pip install git+https://github.com/ByteDance-Seed/Depth-Anything-3.git

[danrossi]

uv venv --python 3.12

May also work. or else require to run the script like

 uv run python depth_surge_3d.py --depth-model-version v3 video.mp4

uv seems slow to run on WSL due to filesystem mount issues. Why I was trying in powershell on Windows. Will try Windows next.

[Tok]

Thanks for the contribution! Your PR #13 has been merged, which adds the depth-anything-3 package with the correct git source configuration. I've also pinned Python to 3.12 as you suggested for consistency.

The DA3 package should now install properly with uv. Thanks again for identifying and fixing this issue!

[Tok]

Leaving this issue open as it tracks the Python 3.13 compatibility limitation. While PR #13 improves installation for Python 3.9-3.12, the core issue requires open3d to release wheels for Python 3.13. This will be resolved when the upstream dependency is updated.

[danrossi]

Windows uv is a mess sadly. It won't install the GPU Torch. And this solution is broken with nvidia out of the box with no information on a fix. Linux automatically detects with the normal uv not the experimental on.

uv is needed on Windows to install python 3.12 and pin it like this. It might be needed on Linux also.

uv python install 3.12
uv python pin 3.12
uv sync

https://astral.sh/blog/wheel-variants

The Linux WSL process crashed in the end and can't use Powershell.