# mana-swift-llm

Swift-Package mit lokalen LLM-Backends für alle nativen
[mana e.V.](https://mana-ev.ch) iOS-/macOS-Apps.

Zwei Library-Products:

- **`ManaLLM`** — Backend-Abstraktion + High-Level-Facade.
  Backends: Apple Foundation Models, Gemma 4 E2B/E4B (via MLX-Swift),
  NoOp-Fallback. Router wählt nach Capability automatisch.

- **`ManaLLMShared`** — App-Group-Container-Helper für
  gemeinsamen HuggingFace-Cache. Apps mit dem `group.ev.mana.models`-
  Entitlement teilen heruntergeladene Modelle — **eine** App lädt,
  alle anderen lesen.

## Schnell-Start

```swift
import ManaLLM

@main
struct MeineApp: App {
    init() {
        // HF_HUB_CACHE auf den shared Container setzen.
        ManaLLM.configure()
    }

    var body: some Scene {
        // ...
    }
}

// Irgendwo später:
let summary = await ManaLLM.summarize(longText)
let story = await ManaLLM.generate(
    prompt: "Schreib eine kurze Reise-Story über Konstanz.",
    level: .creative
)
let tags = await ManaLLM.classify(text, into: ["#sport", "#kultur"])
```

## Plattform-Doku

- [`../mana/docs/MANA_LLM.md`](https://git.mana.how/mana/mana/src/branch/main/docs/MANA_LLM.md) — Architektur + Use-Case-Map
- [`../mana/docs/MANA_SWIFT.md`](https://git.mana.how/mana/mana/src/branch/main/docs/MANA_SWIFT.md) — Native-Plattform-SOT
- [`CLAUDE.md`](CLAUDE.md) — Repo-lokale Konventionen