troy-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{troy_cli-0.2.0 → troy_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: troy-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Fine-tune LLMs on your MacBook with one YAML file. Built for Apple Silicon.
 Author: Troy
 License: Apache-2.0
@@ -46,8 +46,10 @@ troy doctor            # check your Mac: chip, memory, MLX, what you can train
 troy init              # create troy.yaml + sample data
 troy train             # fine-tune (LoRA/QLoRA via MLX)
 troy chat              # talk to the result
+troy eval              # did it work? base-vs-tuned loss + samples
 troy serve             # OpenAI-compatible API at localhost:8080/v1
 troy export -f gguf    # ship it to llama.cpp / Ollama / LM Studio
+troy push you/model    # upload to the Hugging Face Hub
 ```
 
 ## The config is the interface
@@ -75,7 +77,7 @@ output: ./output
 
 | Command | Purpose |
 |---|---|
-| `troy init` | Create a config from a template (`chat`, `dpo`) |
+| `troy init` | Create a config from a template (`chat`, `dpo`, `orpo`) |
 | `troy doctor` | Hardware + dependency check, with model-size guidance |
 | `troy train` | LoRA fine-tuning: SFT, DPO, or ORPO |
 | `troy chat` | Interactive REPL (or `-p` for one-shot) with your adapter |

{troy_cli-0.2.0 → troy_cli-0.2.2}/README.md

@@ -31,8 +31,10 @@ troy doctor            # check your Mac: chip, memory, MLX, what you can train
 troy init              # create troy.yaml + sample data
 troy train             # fine-tune (LoRA/QLoRA via MLX)
 troy chat              # talk to the result
+troy eval              # did it work? base-vs-tuned loss + samples
 troy serve             # OpenAI-compatible API at localhost:8080/v1
 troy export -f gguf    # ship it to llama.cpp / Ollama / LM Studio
+troy push you/model    # upload to the Hugging Face Hub
 ```
 
 ## The config is the interface
@@ -60,7 +62,7 @@ output: ./output
 
 | Command | Purpose |
 |---|---|
-| `troy init` | Create a config from a template (`chat`, `dpo`) |
+| `troy init` | Create a config from a template (`chat`, `dpo`, `orpo`) |
 | `troy doctor` | Hardware + dependency check, with model-size guidance |
 | `troy train` | LoRA fine-tuning: SFT, DPO, or ORPO |
 | `troy chat` | Interactive REPL (or `-p` for one-shot) with your adapter |

{troy_cli-0.2.0 → troy_cli-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "troy-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "Fine-tune LLMs on your MacBook with one YAML file. Built for Apple Silicon."
 readme = "README.md"
 requires-python = ">=3.10"

{troy_cli-0.2.0 → troy_cli-0.2.2}/src/troy/__init__.py

@@ -1,3 +1,3 @@
 """Troy: fine-tune LLMs on your MacBook with one YAML file."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{troy_cli-0.2.0 → troy_cli-0.2.2}/src/troy/cli.py

@@ -51,7 +51,7 @@ def _main(
 @app.command()
 def init(
     template: str = typer.Option(
-        "chat", help="Template: chat (SFT) or dpo (preference tuning)."
+        "chat", help="Template: chat (SFT), dpo, or orpo (preference tuning)."
     ),
     path: Path = typer.Option(Path("troy.yaml"), help="Where to write the config."),
     force: bool = typer.Option(False, "--force", help="Overwrite an existing config."),
@@ -120,7 +120,12 @@ def doctor() -> None:
     except ImportError:
         table.add_row("mlx-lm", f"{fail} (not installed)")
 
-    table.add_row("Fine-tunable models", model_guidance(hw.memory_gb))
+    table.add_row("Comfortable size", model_guidance(hw.memory_gb))
+    table.add_row(
+        "Supported models",
+        "any mlx-lm architecture (Llama, Qwen, Gemma, Phi, Mistral, ...)\n"
+        "thousands of ready conversions: hf.co/mlx-community",
+    )
     console.print(table)
 
     if not hw.is_apple_silicon:

{troy_cli-0.2.0 → troy_cli-0.2.2}/src/troy/hardware.py

@@ -42,7 +42,8 @@ def detect() -> Hardware:
     )
 
 
-# (min unified memory GB, guidance) — QLoRA 4-bit fine-tuning headroom.
+# (min unified memory GB, guidance) — QLoRA 4-bit sizing EXAMPLES, not a
+# whitelist: any mlx-lm-supported architecture trains.
 MODEL_GUIDANCE = [
     (128, "up to ~70B (4-bit QLoRA), e.g. Llama-3.3-70B, Qwen2.5-72B"),
     (64, "up to ~32B (4-bit QLoRA), e.g. Qwen2.5-32B, Gemma-2-27B"),

{troy_cli-0.2.0 → troy_cli-0.2.2}/src/troy/templates.py

@@ -50,6 +50,32 @@ training:
 output: ./output
 """
 
+ORPO_TEMPLATE = """\
+# Troy config — preference tuning (ORPO: no reference model, ~2x DPO speed)
+# Run with: troy train
+
+base: mlx-community/Qwen3-0.6B-4bit
+task: orpo
+
+data:
+  train: ./data/preferences.jsonl   # {"prompt": ..., "chosen": ..., "rejected": ...}
+  format: preference
+  val_split: 0.05
+
+training:
+  epochs: 1
+  lr: 2e-5
+  batch_size: auto
+  seq_len: 2048
+  lora:
+    r: 8
+    alpha: 16
+  orpo:
+    lambda: 0.2
+
+output: ./output
+"""
+
 SAMPLE_SFT_DATA = [
     {
         "instruction": "What is the capital of France?",
@@ -81,4 +107,5 @@ SAMPLE_DPO_DATA = [
 TEMPLATES = {
     "chat": (CHAT_TEMPLATE, "train.jsonl", SAMPLE_SFT_DATA),
     "dpo": (DPO_TEMPLATE, "preferences.jsonl", SAMPLE_DPO_DATA),
+    "orpo": (ORPO_TEMPLATE, "preferences.jsonl", SAMPLE_DPO_DATA),
 }