// Create or update the pymllm/lib symlink to point to a C++ build directory's bin/ folder. Required after editable installs with C++ builds so that Python can find the compiled .so libraries. Use when the user asks to link, fix, or set up pymllm native libraries.
Install the pymllm Python package. Asks the user whether to do a full build (with CMake C++ compilation) or a fast install (Python-only, skip CMake). Use when the user asks to install, set up, or reinstall pymllm.
Guide for implementing CUDA or CPU JIT kernels in mllm-kernel. Use when the user asks to create, add, or implement a new kernel in mllm-kernel.
Updates CODEOWNERS entries safely with consistent path and owner formatting. Use when the user asks to add, remove, or modify CODEOWNERS rules, ownership mappings, reviewers, or module maintainers.
| name | link-pymllm-lib |
| description | Create or update the pymllm/lib symlink to point to a C++ build directory's bin/ folder. Required after editable installs with C++ builds so that Python can find the compiled .so libraries. Use when the user asks to link, fix, or set up pymllm native libraries. |
Create a symlink at pymllm/lib pointing to the correct build output directory so that an editable-installed pymllm can load the compiled C++ shared libraries (MllmFFIExtension.so, libMllmRT.so, etc.).
When pymllm is installed in editable mode (pip install -e .), Python imports from the source tree directly. The C++ libraries are compiled into <build-dir>/bin/ by CMake, but pymllm looks for them at pymllm/lib/. A symlink bridges this gap:
pymllm/lib -> <project-root>/<build-dir>/bin
Scan the project root for directories matching the pattern build*/bin/ that contain MllmFFIExtension.so (or .dylib on macOS). List all valid candidates.
Common build directories and their corresponding platforms:
| Build directory | Platform / Config | Typical build command |
|---|---|---|
build/bin | X86 CPU only | python task.py tasks/build_x86.yaml |
build-x86-cuda/bin | X86 + CUDA | python task.py tasks/build_x86_cuda.yaml |
build-qnn-aot/bin | X86 + QNN AOT | python task.py tasks/build_x86_qnn_aot.yaml |
build-android-arm64-v8a-qnn/bin | Android ARM + QNN | python task.py tasks/build_android_qnn.yaml |
Use AskUserQuestion to let the user pick from the detected build directories. Show each option with its path and the platform it corresponds to.
If no build directories with .so files are found, inform the user they need to build first:
pip install -r requirements.txt
python task.py tasks/build_x86.yaml # or another build task
Before creating a new symlink, check if pymllm/lib already exists:
ln -sfn <project-root>/<build-dir>/bin <project-root>/pymllm/lib
Use ln -sfn to atomically replace any existing symlink.
After creating the symlink, verify by checking that the target .so file is accessible:
ls -la pymllm/lib/MllmFFIExtension.so
Then run a quick Python check:
python -c "import pymllm; print('mobile available:', pymllm.is_mobile_available())"
If is_mobile_available() returns True, the link is correct.
.dylib instead of .so.build-android-arm64-v8a-qnn/bin) contain ARM binaries that cannot run on x86 hosts. Warn the user if they select one of these on a non-ARM machine.