Common Installation Problems

[awni]

The docs have more information on troubleshooting installation.

Two of the more common issues are described below (as well as in the docs).

Installing from PyPI

A common problem is pip install mlx does not find a matching distribution:

ERROR: Could not find a version that satisfies the requirement mlx (from versions: none)
ERROR: No matching distribution found for mlx

If this happens you are probably using a non-native Python. The output of:

python -c "import platform; print(platform.processor())"

Should be arm not i386. You can fix this by using an environment with a native Python using Conda. Another option is to simply reinstall Conda and setup a new environment.

Installing from Source

You see the following error when you try to build:

error: unable to find utility "metal", not a developer tool or in PATH

To fix this, first make sure you have Xcode installed:

xcode-select --install

Then set the active developer directory:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

[ariaattar]

Having the same issue, platform is outputting arm is there something else I should check?

[awni]

Check your operating system: requirements here

And try pythom -m pip install mlx

[aakashvardhan]

Is this not applicable for pyenv?

[awni]

I'm not sure what you mean. You should be able to use mlx inside a pyenv.

[oldfishoh]

I resolved the issue by reinstalling conda, and successfully installed it using pip install chat-with-mlx. However, how should I run it?

[awni]

However, how should I run it?

To run chat-with-mlx I would check the docs there. That is a third party repo. If you have issues with it, I would encourage you to file an issue in that repo.