add widget examples to HF model card, add Python upload script

Author: phanii9

docs/model_card.md

@@ -10,6 +10,17 @@ tags:
 language:
   - en
 pipeline_tag: text-generation
+widget:
+  - text: "hi miso"
+    example_title: greeting
+  - text: "are you hungry"
+    example_title: hunger
+  - text: "what do you see out the window"
+    example_title: windows
+  - text: "the vacuum is coming out"
+    example_title: vacuum
+  - text: "what do you think of the economy"
+    example_title: hard negative
 ---
 
 # MeowLLM — Miso

scripts/upload_to_hf.py

@@ -0,0 +1,108 @@
+"""Upload MeowLLM artifacts to Hugging Face.
+
+Usage:
+    export HF_TOKEN=your_token_here
+    python3 scripts/upload_to_hf.py --username hunt3rx99
+"""
+
+import argparse
+import os
+import shutil
+import sys
+from pathlib import Path
+
+def main():
+    ap = argparse.ArgumentParser(description="Upload MeowLLM to Hugging Face")
+    ap.add_argument("--username", default=os.environ.get("HF_USERNAME"),
+                    help="HF username (or set HF_USERNAME env var)")
+    ap.add_argument("--token", default=os.environ.get("HF_TOKEN"),
+                    help="HF write token (or set HF_TOKEN env var)")
+    args = ap.parse_args()
+
+    if not args.username:
+        sys.exit("ERROR: pass --username or set HF_USERNAME")
+    if not args.token:
+        sys.exit("ERROR: pass --token or set HF_TOKEN")
+
+    # Check required files
+    required = [
+        "checkpoints/best.pt", "data/tokenizer.json",
+        "data/train.jsonl", "data/val.jsonl",
+        "docs/model_card.md", "docs/dataset_card.md",
+    ]
+    for f in required:
+        if not Path(f).exists():
+            sys.exit(f"ERROR: missing required file: {f}")
+
+    from huggingface_hub import HfApi, login
+
+    model_repo = f"{args.username}/meowllm"
+    dataset_repo = f"{args.username}/meowllm-miso"
+
+    print("=" * 42)
+    print("MeowLLM Hugging Face Upload")
+    print("=" * 42)
+    print(f"model repo:   {model_repo}")
+    print(f"dataset repo: {dataset_repo}")
+    print()
+
+    # Login
+    print("[1/4] Logging in to HF...")
+    login(token=args.token)
+    api = HfApi()
+
+    # Create model repo
+    print("\n[2/4] Creating model repo (if needed)...")
+    try:
+        api.create_repo(model_repo, repo_type="model", exist_ok=True)
+        print(f"  repo ready: {model_repo}")
+    except Exception as e:
+        print(f"  note: {e}")
+
+    # Upload model artifacts
+    print("\n[3/4] Uploading model artifacts...")
+    api.upload_file(path_or_fileobj="checkpoints/best.pt",
+                    path_in_repo="best.pt", repo_id=model_repo)
+    print("  uploaded best.pt")
+
+    api.upload_file(path_or_fileobj="data/tokenizer.json",
+                    path_in_repo="tokenizer.json", repo_id=model_repo)
+    print("  uploaded tokenizer.json")
+
+    api.upload_file(path_or_fileobj="docs/model_card.md",
+                    path_in_repo="README.md", repo_id=model_repo)
+    print("  uploaded README.md (model card)")
+
+    # Create dataset repo
+    print("\n[4/4] Creating and uploading dataset...")
+    try:
+        api.create_repo(dataset_repo, repo_type="dataset", exist_ok=True)
+        print(f"  repo ready: {dataset_repo}")
+    except Exception as e:
+        print(f"  note: {e}")
+
+    api.upload_file(path_or_fileobj="data/train.jsonl",
+                    path_in_repo="train.jsonl",
+                    repo_id=dataset_repo, repo_type="dataset")
+    print("  uploaded train.jsonl")
+
+    api.upload_file(path_or_fileobj="data/val.jsonl",
+                    path_in_repo="val.jsonl",
+                    repo_id=dataset_repo, repo_type="dataset")
+    print("  uploaded val.jsonl")
+
+    api.upload_file(path_or_fileobj="docs/dataset_card.md",
+                    path_in_repo="README.md",
+                    repo_id=dataset_repo, repo_type="dataset")
+    print("  uploaded README.md (dataset card)")
+
+    print()
+    print("=" * 42)
+    print("done. check:")
+    print(f"  https://huggingface.co/{model_repo}")
+    print(f"  https://huggingface.co/datasets/{dataset_repo}")
+    print("=" * 42)
+
+
+if __name__ == "__main__":
+    main()