Skip to content
dMLX

Build from source

Terminal window
# engine (Python 3.13, uv)
cd engine && uv sync --extra local-llm && uv run pytest


# app (Swift 6 toolchain / Xcode 16+)
cd app && swift test
tools/dev/run_app.sh            # runs the app; the engine starts from ../engine via uv


# release bundle (relocatable Python and engine inside the .app, ad-hoc signed), as a .dmg and a .zip
tools/bundle_app.sh --dmg --zip

To score the agent with the routing eval and placeholder images, run this command:

Terminal window
cd engine && uv run --extra local-llm python -m dmlx.prompting.agent_eval --model qwen3-vl-8b-instruct-4bit

Project layout

Section titled “Project layout”
engine/   Python engine (FastAPI + MLX via mflux), the planning agent, evals, tests
app/      SwiftUI app (DMLXKit library + app target), tests
tools/    bundle_app.sh (release), dev/ helpers (run_app.sh, the scripted dev harness)
docs/     release notes, known issues, benchmarks, screenshots
tasks/    open and finished agent tasks, with their results

License

Section titled “License”

All code in this repository uses the Apache-2.0 license. Model weights have their own licenses. The default models use Apache-2.0. The optional Qwen Image 2.1 uses the Qwen Research License (non-commercial).