Upload README.md with huggingface_hub

README.md

@@ -14,6 +14,48 @@ library_name: coreml
 pipeline_tag: text-generation
 ---
 
+## 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 + chat (one call)
+
+```swift
+import CoreMLLLM
+
+// First call pulls the bundle from this repo to Documents/Models/.
+// Subsequent calls reuse the on-disk copy.
+let llm = try await CoreMLLLM.load(repo: "mlboydaisuke/lfm2.5-350m-coreml")
+
+let stream = try await llm.generate(
+    [CoreMLLLM.Message(role: .user, content: "Hello!")],
+    maxTokens: 256
+)
+for await chunk in stream {
+    print(chunk, terminator: "")
+}
+```
+
+Multi-turn: keep an `[CoreMLLLM.Message]` array, append the
+user/assistant turns, and pass the whole history to
+`generate(_:)` again.  Call `llm.reset()` to start a new
+conversation (clears the KV cache).
+<!-- swift-usage-end -->
+
+
+
 # LFM2.5 350M — CoreML build for Apple Neural Engine
 
 CoreML port of [LiquidAI/LFM2.5-350M](https://huggingface.co/LiquidAI/LFM2.5-350M)