MacOS python 3.10 required but not found

[stibinator]

When I try to run smart segments on MacOS I get this error:

Smart Segments setup failed. Python 3.10 is required but not found
To fix this issue:
1. Download Python 3.10 from https://python.org
2. During installation, check 'Add Python to PATH'
3. Complete the installation
4. Restart Krita
5. Try Smart Segments again

Alternative: Install Python 3.10 from Microsoft Store
Failed to create virtual environment.

Please ensure Python 3.10 is installed on your system:
• On Windows: Install Python 3.10 from python.org
• Make sure 'py' launcher is available (installed by default)
• Or install Python 3.10 via Microsoft Store

After installing Python 3.10, restart Krita and try again.

The system version of python on this mac is 3.9.6. In the Krita application bundle there's python 3.10 in Krita.app/Contents/Frameworks/Python.framework/Versions/3.10/

My installation of Krita is not in the default MacOS /Applications directory (don't have admin access to install it), but in ~/Library/Applications/, if that makes a difference …

[stibinator]

Oh, BTW I love the example images in the user manual ;)

[stibinator]

Here's more info from running krita in the command line.
026-02-25 18:02:16,646 - smart_segments_plugin - INFO - Starting minimal setup process...
2026-02-25 18:02:16,653 - smart_segments_plugin - INFO - Creating MinimalBootstrap with project_root: /Users/sdixon/Library/Application Support/krita
2026-02-25 18:02:16,654 - smart_segments_plugin - INFO - MinimalBootstrap created: <smart_segments.minimal_bootstrap.MinimalBootstrap object at 0x12bfcb3a0>
2026-02-25 18:02:16,654 - smart_segments_plugin - INFO - Bootstrap type: <class 'smart_segments.minimal_bootstrap.MinimalBootstrap'>
2026-02-25 18:02:16,772 - smart_segments_plugin - INFO - System check results: {'platform': 'Darwin', 'python_version': '3.10.7', 'python_executable': '/Users/sdixon/Library/Applications/krita.app/Contents/MacOS/krita', 'architecture': 'arm64', 'has_internet': True, 'disk_space_gb': 630.7898406982422, 'can_create_venv': False, 'has_cuda': False}
2026-02-25 18:02:16,812 - smart_segments_plugin - ERROR - Setup failed: Failed to create virtual environment.

[a904guy]

The bundled version isn't apart of your PATH environment or the plugin would find it and use it.

The python version it found is bundled with your krita executable and cannot be used to create venv which it needs. You can see that relevant information here:

2026-02-25 18:02:16,772 - smart_segments_plugin - INFO - System check results: {'platform': 'Darwin', 'python_version': '3.10.7', 'python_executable': '/Users/sdixon/Library/Applications/krita.app/Contents/MacOS/krita', 'architecture': 'arm64', 'has_internet': True, 'disk_space_gb': 630.7898406982422, 'can_create_venv': False, 'has_cuda': False}

I don't have a mac to test against but the easiest solution is to install python 3.10 and ensure it has venv capabilities, other versions have compatibility issues with the libraries that SAM 2 relies on.

[a904guy]

Let me know if that solves your dilemma or if you require further assistance.

[stibinator]

Thanks. I don't have admin access on this machine, so I don't think I can install the python version it needs.

[a904guy]

You can try adding your directory here and reporting back your findings, if it works, I'll update the codebase.

Here:

Smart_Segments/smart_segments/utils/platform_utils.py

Lines 292 to 302 in 47d6696

	elif self.platform == PlatformType.MACOS:
	# macOS Python locations
	paths.extend([
	Path("/usr/bin"),
	Path("/usr/local/bin"),
	Path("/opt/homebrew/bin"),
	Path("/System/Library/Frameworks/Python.framework/Versions"),
	Path("/Library/Frameworks/Python.framework/Versions"),
	self.path_handler.get_home_directory() / ".pyenv/versions",
	Path("/opt/local/bin"), # MacPorts
	])

Add paths:

Path("/Applications/Krita.app/Contents/Frameworks/Python.framework/Versions/3.10/"),
self.path_handler.get_home_directory()."/Applications/Krita.app/Contents/Frameworks/Python.framework/Versions/3.10/"

See if that solves your bundle problem.

[a904guy]

Didn't mean to close issue. Can you validate the fix for me?