Upload README.md with huggingface_hub

README.md

@@ -11,6 +11,51 @@ tags:
 library_name: coreml
 ---
 
+## Use it from Swift
+
+<!-- swift-usage-begin -->
+### Add the package
+
+`Package.swift`:
+
+```swift
+.package(url: "https://github.com/john-rocky/CoreML-LLM", branch: "main"),
+
+// In your target:
+.product(name: "CoreMLLLM", package: "CoreML-LLM"),
+```
+
+Platforms: iOS 18+ / macOS 15+.
+
+### Download + call
+
+```swift
+import CoreMLLLM
+
+let modelsDir = try FileManager.default.url(
+    for: .applicationSupportDirectory, in: .userDomainMask,
+    appropriateFor: nil, create: true)
+
+// Pulls the bundle from this repo on first call, then loads.
+let fg = try await FunctionGemma.downloadAndLoad(modelsDir: modelsDir)
+
+// Plain chat-templated generation
+let stream = try await fg.generate("How do I list files in Swift?")
+for await chunk in stream { print(chunk, terminator: "") }
+
+// Function-call generation (returns a single JSON object)
+let json = try await fg.generateFunctionCall(
+    tools: tools,                  // your [String: Any] schema
+    userMessage: "Get me weather for Tokyo")
+print(json)
+```
+
+See [`Gemma3FunctionGemma.swift`](https://github.com/john-rocky/CoreML-LLM/blob/main/Sources/CoreMLLLM/Gemma3FunctionGemma.swift)
+for the full API.
+<!-- swift-usage-end -->
+
+
+
 # FunctionGemma-270M for Apple CoreML (ANE-optimized)
 
 CoreML conversion of `google/functiongemma-270m-it` produced with the