mlxsmith 0.1.0__py3-none-any.whl

mlxsmith-0.1.0.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: mlxsmith
+Version: 0.1.0
+Summary: Apple Silicon MLX fine-tuning and OpenAI-compatible serving (SFT stable; preference/RL experimental).
+Author-email: Shannon Labs <hmbown@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Hmbown/MLXSmith
+Project-URL: Repository, https://github.com/Hmbown/MLXSmith
+Project-URL: Issues, https://github.com/Hmbown/MLXSmith/issues
+Keywords: mlx,apple-silicon,llm,fine-tuning,lora,openai-compatible
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: MacOS :: MacOS X
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pydantic-settings>=2.2.1
+Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Requires-Dist: huggingface_hub>=1.3.4
+Requires-Dist: jsonschema>=4.21.0
+Provides-Extra: mlx
+Requires-Dist: mlx>=0.30.4; extra == "mlx"
+Provides-Extra: llm
+Requires-Dist: mlx-lm>=0.30.5; extra == "llm"
+Requires-Dist: transformers>=5.0.0; extra == "llm"
+Requires-Dist: datasets>=3.0.0; extra == "llm"
+Provides-Extra: serve
+Requires-Dist: fastapi>=0.128.0; extra == "serve"
+Requires-Dist: uvicorn>=0.40.0; extra == "serve"
+Requires-Dist: httpx>=0.28.0; extra == "serve"
+Provides-Extra: zmlx
+Requires-Dist: zmlx; extra == "zmlx"
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.0; extra == "dev"
+Requires-Dist: ruff>=0.14.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: mlx>=0.30.4; extra == "all"
+Requires-Dist: mlx-lm>=0.30.5; extra == "all"
+Requires-Dist: transformers>=5.0.0; extra == "all"
+Requires-Dist: datasets>=3.0.0; extra == "all"
+Requires-Dist: fastapi>=0.128.0; extra == "all"
+Requires-Dist: uvicorn>=0.40.0; extra == "all"
+Requires-Dist: httpx>=0.28.0; extra == "all"
+Dynamic: license-file
+
+# mlxsmith
+
+Apple Silicon MLX fine-tuning and OpenAI-compatible serving.
+SFT + serving are stable. Preference/RL/RLM features are experimental.
+
+Status: alpha (2026-02-02).
+
+## Stable features
+- Project init, config, data tools, HF auth, model pull/convert.
+- SFT (LoRA/QLoRA) training with run tracking and adapters.
+- Inference and OpenAI-compatible /v1/chat/completions serving.
+- Basic eval/bench and verifier plumbing (regex/jsonschema/pytest).
+
+## Experimental features
+- Preference tuning (DPO/ORPO).
+- GRPO-style RFT.
+- RLM self-play loop (research).
+- Distill/OPD and orchestrated RLM.
+
+## Install
+
+MLX is only available on Apple Silicon. Other platforms can still use data tools
+and mock backends, but MLX training and serving require macOS on Apple Silicon.
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -U pip
+
+# Core CLI
+pip install mlxsmith
+
+# Apple Silicon training + serving
+pip install "mlxsmith[mlx,llm,serve]"
+```
+
+## Quickstart
+
+```bash
+mlxsmith init myproj
+cd myproj
+mlxsmith doctor
+```
+
+## HF auth (optional)
+
+```bash
+mlxsmith auth login --token "$HF_TOKEN"
+mlxsmith auth status
+mlxsmith auth logout
+```
+
+## Pull + convert a model (HF -> MLX)
+
+```bash
+mlxsmith pull Qwen/Qwen3-4B-Instruct-2507
+# outputs to cache/mlx/Qwen__Qwen3-4B-Instruct-2507
+```
+
+Optional quantization:
+
+```bash
+mlxsmith pull Qwen/Qwen3-4B-Instruct-2507 --quantize --q-bits 4
+```
+
+## SFT (LoRA/QLoRA)
+
+```bash
+mlxsmith sft --model cache/mlx/Qwen__Qwen3-4B-Instruct-2507 --data data/sft
+```
+
+## Serve (OpenAI-compatible)
+
+```bash
+mlxsmith serve --model runs/sft_0001/adapter --port 8080
+```
+
+Sample request:
+
+```bash
+curl http://localhost:8080/v1/chat/completions \
+  -H 'Content-Type: application/json' \
+  -d '{"messages":[{"role":"user","content":"Hello"}],"max_tokens":64}'
+```
+
+To enable the optional UI/monitor dashboard, set `serve.ui: true` in `mlxsmith.yaml`.
+
+## Experimental commands
+
+- `mlxsmith pref` (DPO/ORPO)
+- `mlxsmith rft` (GRPO-style)
+- `mlxsmith rlm` / `mlxsmith pipeline` (self-play loop)
+- `mlxsmith distill` (offline/OPD)
+- `mlxsmith eval` / `mlxsmith bench`
+
+## Docs
+
+- `docs/PROJECT_FORMAT.md` for project layout and artifacts.
+- `docs/VERIFIERS.md` for verifier API and sandbox behavior.
+- `docs/COMPATIBILITY.md` for tested versions and model families.
+- `docs/ENVIRONMENTS.md` for the environment plugin system.
+- `docs/ROADMAP.md` for product direction and milestones.
+- `docs/README.md` for the full docs index.
+
+## License
+
+MIT

mlxsmith-0.1.0.dist-info/RECORD

@@ -0,0 +1,69 @@
+mlxsmith/__init__.py,sha256=CJZKl9Hp16DYlQR7yqstir-cL4n7GCw90d-meXliCHk,48
+mlxsmith/adapters.py,sha256=wkQ2q_ugaxCviNARSmxehwBcc2_NKVJ7mOofT-y30TY,1318
+mlxsmith/auth.py,sha256=_j_gx5ccZfpHs0_Xmpcgh_ELhX3ZBJLg2YYpjA-aPRI,2195
+mlxsmith/bench.py,sha256=VBgY9uOGm3xhmL3UrNNOnUoa3P0yaVQQ7wxykIEmDEw,3778
+mlxsmith/cli.py,sha256=YHjrPti1OCe0m2gpEwygiJ6_x-xeycKHRDYCksdcOuM,35750
+mlxsmith/config.py,sha256=iFDhO7KcAtq1KySGD7TfNMYqbQcec0Tc0-VJdr5Gwo4,16385
+mlxsmith/config_models.py,sha256=pMsLGyC9J9T9jqs5ipYFUuEkfir7iiDA4EZdcb65k5g,8407
+mlxsmith/data.py,sha256=3ZlNS8bnD7LlWACEmULbf8RGQzCuf0QulFpI1PWvNuI,16160
+mlxsmith/eval.py,sha256=nSARSEKKwZM8Ot5rUDDpGikaClGNxvg0ifgGkTA6mM0,3792
+mlxsmith/infer.py,sha256=ekpHhTird0dnTJzFOc-O98rjwkEKgAr9AFicKlaB3MA,4610
+mlxsmith/models.py,sha256=BRaPTxzqy-5KEKdccveMgjpbRP0ZmbRnA_su8rz2P4k,8033
+mlxsmith/runs.py,sha256=2voYBryGGMlAKskHJ7TDiIPQL2_fFxSQ8RgtfGZ7ccg,1409
+mlxsmith/server.py,sha256=CBxmV9WwpyivsHytVALgT4DOGh1vqjwm4W_iHBH79rg,10821
+mlxsmith/util.py,sha256=8fagFtMP2YS1qlWkCt8bPWAz2jAgfvAf1ipNGJZAgIk,4544
+mlxsmith/accel/__init__.py,sha256=Mv2mj-2bLqUILhMUCjMLu7JORcu0-cGBOri32j7O5Xo,291
+mlxsmith/accel/base.py,sha256=o0kmxV68KbxOmucC3eDjKbFA8dfTT2ETqN0XD_l3mM0,435
+mlxsmith/accel/none.py,sha256=WhxECIBv-pE63Vh1Iv86ObgT9JHOi4hA4BUyJc__sKU,362
+mlxsmith/accel/zmlx_backend.py,sha256=JfzQ44v9hrCJgcqU018ZD7qLNlubIe09CwYRpKyfwR8,1529
+mlxsmith/api/__init__.py,sha256=IrpIXDkUJm4BZqahYOK_0BkxvomlscEvCoLCm4GDxo8,998
+mlxsmith/api/handlers.py,sha256=5YKQfHLG2mWjCugOkG1L3veiPMz_Qg_s4h12xx6eibs,47068
+mlxsmith/api/schemas.py,sha256=Q18kF9FKtvT1vdnXy6feSNTtCV2FiRWDzfdsPzc0te8,19316
+mlxsmith/envs/__init__.py,sha256=t7QiEHtfyP1dUCj-4TJUN0hd9lRqBKYd5Ek7dgEwus4,671
+mlxsmith/envs/system.py,sha256=2bChkOxm2S7d0WCrweHGhoI6-xOYDxlC0YbHH6Ibjq4,12782
+mlxsmith/envs/token_env.py,sha256=rhv2o3eI1GyTtfAXG72z-31amNGaLv0KW56mEsWkXlY,6709
+mlxsmith/llm/__init__.py,sha256=jWEkXGdvwZ8tUYHVqWW3SYHXG-LSWaGbdwOR0mF_4Zw,396
+mlxsmith/llm/backend.py,sha256=_xGfdJ30_6Nq8zIqMjTemCZWV-vUi9qV0djfwxny5SM,4335
+mlxsmith/llm/interface.py,sha256=zmqJuyiEQqjEpDjZwooS1hp1GfTPCTiWYJ5nPw8xSqg,6633
+mlxsmith/llm/mlx_lm_backend.py,sha256=OitqY_6LqnfqbN7GZz39Ma3cItjjNqHXF3SV3AZsHxk,18284
+mlxsmith/llm/mock_backend.py,sha256=DXXnMlXZGCtf0datgjFc5z_X8JMEKaYDRPXKU1erGdQ,7449
+mlxsmith/llm/registry.py,sha256=ZmYE-WclyMo6z0HwUufqt3tKT4E84xZ6I-PFu1Z5nws,309
+mlxsmith/orchestrator/__init__.py,sha256=oc4qIkISZMGMvYeOqU8lDDmFL3uxDYJHsv_rra9DH-E,792
+mlxsmith/orchestrator/daemon.py,sha256=MRQf84sCjeShBFcOcF7yfP6HhHl7IHrnmw0nV50mJrI,16360
+mlxsmith/orchestrator/inference_worker.py,sha256=4AI_j7qnrnwXObBxSa7YHlZHnGfqou-W1fpqHYt8jpQ,17981
+mlxsmith/orchestrator/queue.py,sha256=8c1n-fiW3ITcLbwOeFlH_AEZdJYvZumy8EczJ0lh4NA,11301
+mlxsmith/orchestrator/trainer_worker.py,sha256=uvJQesXjfdsiNRsO2FVHhUk0WmMB_PQNSPff5U9Swp4,16061
+mlxsmith/rlm/__init__.py,sha256=Q09oRONXWTFXuWwMJOpGWg0I-UDkuib0OA1O_cNFp2U,236
+mlxsmith/rlm/corpus.py,sha256=-p12H650_ybe2kXC219M4wXYpD08QHUpY92ErVjSfX8,2112
+mlxsmith/rlm/gating.py,sha256=L18niYKEezphASdsgzW6pz3PN7ylA-L5Wu4_GLLVfHw,2455
+mlxsmith/rlm/generate.py,sha256=q1v_TP8sqVj05omhoF60Ns1iX6yClgc7lP6njz4lK18,7601
+mlxsmith/rlm/history.py,sha256=Vm4JtWqsZnqB-fuo3zWfweeogmmLTL3VHaYZ45vrkz8,299
+mlxsmith/rlm/inference.py,sha256=ntCEKxD1KrkIXgZNQbD4jhS5rJPtwcVYc8qLc5E5cnc,5297
+mlxsmith/rlm/loop.py,sha256=WLRP1PI5PX7OjSEZsurrCwSTVVPNVIx4-7td1ihSMY0,49955
+mlxsmith/rlm/mutate.py,sha256=_NUNMpVCRaEDgtzI8J2NOTcj5NnycZnP_UoUpFacjTs,2553
+mlxsmith/rlm/trainer.py,sha256=RRXPlJy4SySpLZGge0ORMYs7HeiWgfGQNeMBOBfG4Ys,3014
+mlxsmith/rlm/weights.py,sha256=NO7wjl2T0eXTVFoYrzPT_IUmaLvD2z-zSSyKpcX93kY,8463
+mlxsmith/sdk/__init__.py,sha256=42WpTgC309sYKp8SArULBWz0trVN51THcjvPdVh-thc,10777
+mlxsmith/sdk/future.py,sha256=mleqPgJ997hSuZuQegvS2GoOxqo_gd4pfh37gv70APc,16873
+mlxsmith/sdk/losses.py,sha256=lJi3R7Red_QO3IatbhKi_GBI7kM0yu-kS14xN2kX_04,7532
+mlxsmith/sdk/sampling_client.py,sha256=AkjJHEZ8OLU8SZoALk7ds3NHMquiqk9GGZHqni5vB2g,24942
+mlxsmith/sdk/training_client.py,sha256=4GXcswTJypkymPO3E5DREUesGzlumbmUrTnt0T80wEI,24380
+mlxsmith/train/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mlxsmith/train/distill.py,sha256=9Xbzn6zt8uqYOwg_pJB2rZJj8y-nESP1OB8DLxnJ0jM,10378
+mlxsmith/train/lora.py,sha256=E8ymi1wUVsGp5-0DldvkSWDHNh_5Fhr6AelJOR5YoPw,8859
+mlxsmith/train/pref.py,sha256=-z7mj-MQu6dPb8y0U6sRFbqKU0nNQ3YRpC3CcmS3l5k,6987
+mlxsmith/train/rft.py,sha256=bf6z-h6VQKvMDZ0XN_ayZV44YsIvuwSzP1YRYrwSQ2M,18956
+mlxsmith/train/sft.py,sha256=w3QmLLoscNQzz-xbtmrCw46PbYIApvgeQi0XjxCop90,5590
+mlxsmith/verifiers/__init__.py,sha256=HXS9XWsPUYZ9WJaxVIPa1TWzwx948uymj23YIu4EW6Q,60
+mlxsmith/verifiers/compose.py,sha256=jQlsBByNvniEsOVh8Ulvjb7L-VcPrxqjld5b1sjBc8c,3374
+mlxsmith/verifiers/docker_verifier.py,sha256=BIqu2VVLsC8owNpiNbOZNmTirfpvuWNJS4F6UZYni1s,2925
+mlxsmith/verifiers/jsonschema.py,sha256=hG_8c07Hwv-tpN2g0oxELwmLRxS8QGzRFwabmo4yY8Y,1324
+mlxsmith/verifiers/pytest_verifier.py,sha256=ARNajzxUPNwtzSow6I2d0mLopZyvY29_d3F1sYVwEUY,2514
+mlxsmith/verifiers/regex.py,sha256=N7z3koE8Iy-a4DBs4404iQCNX2WGxequm5g4umric2Y,524
+mlxsmith/verifiers/types.py,sha256=FytBxB1OnNX1EcqZXSSs3WvL0GRv7byW4mfBMf6xP68,240
+mlxsmith-0.1.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+mlxsmith-0.1.0.dist-info/METADATA,sha256=yRnNRKdCFPZQRgAN7qtxCDBrUJxplOqK3mTV_Uoh2jA,4812
+mlxsmith-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mlxsmith-0.1.0.dist-info/entry_points.txt,sha256=ys7GcKEjhzhkkTMBmmaNavTgsjqOuFnCKIG2w8Wcn6w,46
+mlxsmith-0.1.0.dist-info/top_level.txt,sha256=hKBwc8bn7uoI-_5Yhcq1T3IuChFhUFdzItIkZK1up6A,9
+mlxsmith-0.1.0.dist-info/RECORD,,

mlxsmith-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mlxsmith-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mlxsmith = mlxsmith.cli:app

mlxsmith-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mlxsmith-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mlxsmith