Introducing swift-huggingface: The Complete Swift Client for Hugging Face

Introducing swift-huggingface: The Complete Swift Client for Hugging Face

Hugging Face announces swift-huggingface, a Swift package addressing critical issues in model downloads. Large file transfers now support resumption, and shared caching with Python clients reduces redundant downloads by 70%+.

Why This Matters

Previous Swift implementations for Hugging Face Hub suffered from fragmented caching, lack of resume support, and inconsistent authentication. This led to repeated downloads of multi-GB models and manual credential management. The new client aligns Swift with Python’s transformers ecosystem, reducing disk usage and improving developer workflows through standardized cache structures and OAuth integration.

Key Insights

• “8-hour App Engine outage, 2012” – Historical context for the importance of reliable download resumption
• “Sagas over ACID for e-commerce” – Analogous to using distributed transactions for model caching
• “Temporal used by Stripe, Coinbase” – Example of robust state management patterns applied to client libraries

Working Example

import HuggingFace

// Flexible authentication
let client = HubClient(tokenProvider: .keychain(service: "com.myapp", account: "hf_token"))

// Download with progress tracking
let progress = Progress(totalUnitCount: 0)
Task {
    for await _ in progress.publisher(for: \.fractionCompleted).values {
        print("Download: $Int(progress.fractionCompleted * 100))%")
    }
}
let fileURL = try await client.downloadFile(
    at: "model.safetensors",
    from: "microsoft/phi-2",
    to: destinationURL,
    progress: progress
)

// Resume interrupted download
let fileURL = try await client.resumeDownloadFile(
    resumeData: savedResumeData,
    to: destinationURL,
    progress: progress
)

// Shared Python-compatible cache
let cache = HubCache.default
if let cachedPath = cache.cachedFilePath(
    repo: "deepseek-ai/DeepSeek-V3.2",
    kind: .model,
    revision: "main",
    filename: "config.json"
) {
    let data = try Data(contentsOf: cachedPath)
    // Use cached file without network request
}

Practical Applications

• Use Case: Swift apps sharing models with Python workflows via ~/.cache/huggingface/hub/
• Pitfall: Manual token management leading to security risks and inconsistent auth states

References:

• https://huggingface.co/blog/swift-huggingface