Zum Inhalt springen
labkompass

Guides · KI & Local AI

Hugging Face einfach erklärt: Modelle finden und lokal nutzen

Was Hugging Face ist und wie du dort das richtige Modell für dein Homelab findest: Model Cards und Lizenzen lesen, GGUF-Quantisierungen erkennen und Modelle direkt mit Ollama ausführen — einsteigerfreundlich erklärt.

Von Niclas Hennrich · Veröffentlicht: · 4 Min. Lesezeit


Kurz gesagt: Hugging Face ist das GitHub des offenen KI-Ökosystems — die Plattform, auf der praktisch alle offenen Sprachmodelle veröffentlicht werden. Für den Homelab-Einsatz brauchst du davon vor allem eines: den Model Hub, auf dem du die GGUF-Quantisierung eines Modells findest und sie mit ollama run hf.co/<account>/<repo> direkt startest. Der Rest dieses Guides erklärt, wie du Model Cards liest, Lizenzen einordnest und die richtige Datei aus einem Repository voller kryptischer Namen auswählst.

Wer bei Ollama bleibt und nur die dortige Library nutzt, kommt ohne Hugging Face aus — bis das gewünschte Modell dort fehlt: ein deutschsprachiges Feintuning, eine bestimmte Quantisierungsstufe, ein Nischenmodell. Dann führt der Weg hierher.

Die Plattform in drei Begriffen #

  • Models — der Kern: Hunderttausende Modell-Repositories, technisch Git-Repos mit großen Dateien. Neben Sprachmodellen auch Bild-, Audio- und Embedding-Modelle.
  • Datasets — Trainings- und Evaluationsdatensätze. Fürs reine Benutzen von Modellen brauchst du sie nicht.
  • Spaces — gehostete Demos: Viele Modelle lassen sich dort im Browser ausprobieren, bevor du Gigabytes herunterlädst.

Dahinter steht dieselbe Firma, die mit der Python-Bibliothek Transformers den De-facto-Standard fürs Arbeiten mit diesen Modellen pflegt — für den Ollama-Weg musst du damit aber nie in Berührung kommen.

Model Cards lesen: die drei entscheidenden Angaben #

Jedes Repository beginnt mit einer Model Card — der README. Bevor du irgendetwas herunterlädst, beantworte daraus drei Fragen:

  1. Wie groß ist das Modell? Die Parameterzahl steht meist im Namen (…-7B-…, …-14B-…). Ob sie zu deinem Speicher passt, klärt der Local-AI-Rechner — ein Download jenseits deines Speicherbudgets ist verschenkte Bandbreite.
  2. Instruct oder Base? Für Chat und Aufgaben willst du die Instruct-/Chat-Variante — die Base-Variante setzt nur Text fort (warum, steht im Grundlagen-Guide).
  3. Welche Lizenz? Dazu gleich ausführlicher — die Angabe steht oben in der Model Card.

Dazu liefern gute Model Cards Benchmarks, empfohlene Einstellungen (Temperatur, Chat-Template) und bekannte Schwächen. Gesunde Skepsis: Benchmark-Tabellen in Model Cards sind Herstellerangaben.

Lizenzen: von Apache bis „gated“ #

Open-Weights-Modelle sind nicht automatisch Open Source im strengen Sinn — die Lizenzen unterscheiden sich deutlich:

  • Apache 2.0 / MIT — maximale Freiheit, auch kommerziell. Viele Qwen- und Mistral-Modelle erscheinen so.
  • Community-Lizenzen (z. B. Metas Llama-Lizenz) — Nutzung erlaubt, aber mit Bedingungen; du stimmst ihnen beim Zugriff auf das Repository zu.
  • Gated Models — der Download erfordert ein (kostenloses) Hugging-Face-Konto und die bestätigte Zustimmung; manchmal mit Wartefrist für die Freigabe.
  • Research-/Nichtkommerziell-Lizenzen — fürs private Homelab meist unkritisch, für alles Geschäftliche tabu ohne genaue Lektüre.

Fürs private Experimentieren ist die praktische Konsequenz klein: Bei gated Models brauchst du ein Konto (und für CLI-Downloads ein Access-Token), sonst meist nicht einmal das.

GGUF finden: die richtige Datei im Dateiberg #

Der häufigste Anfängerfehler: das Original-Repository des Herstellers herunterladen. Dort liegen in der Regel Safetensors-Dateien — unquantisiert, auf mehrere Dateien verteilt und für Ollama/llama.cpp nicht das richtige Format (GGUF vs. Safetensors im Detail).

Was du suchst, sind die GGUF-Repositories, die die Community zu jedem relevanten Modell bereitstellt — erkennbar am Zusatz „GGUF“ im Namen. So findest du sie:

  • Auf dem Model Hub links nach Format/Library GGUF filtern — oder schlicht „<modellname> gguf“ suchen.
  • In vielen Model Cards verlinkt der Hersteller selbst auf Quantisierungen („Quantized versions“).

Im GGUF-Repository liegt dann pro Quantisierungsstufe eine Datei:

qwen2.5-7b-instruct-q4_k_m.gguf     ← der übliche Start
qwen2.5-7b-instruct-q5_k_m.gguf
qwen2.5-7b-instruct-q8_0.gguf       ← wenn der Speicher locker reicht

Welche Stufe für dich sinnvoll ist, erklärt der Quantisierungs-Guide — im Zweifel Q4_K_M.

Der direkte Weg: Hugging Face → Ollama #

Das manuelle Herunterladen kannst du dir in den meisten Fällen sparen: Ollama zieht GGUF-Repositories direkt von Hugging Face —

# Standard-Quantisierung des Repositories
ollama run hf.co/<account>/<modell>-GGUF
 
# Bestimmte Stufe wählen
ollama run hf.co/<account>/<modell>-GGUF:Q4_K_M

Das Modell landet in der normalen Ollama-Verwaltung (ollama list, ollama rm) wie jedes Library-Modell. Bei gated Models muss zuvor ein Hugging-Face-Konto verknüpft werden — die Model Card weist darauf hin.

Wer die Dateien doch selbst verwalten will (etwa für llama.cpp pur), nutzt den Download-Button im Browser oder huggingface-cli download — und importiert die GGUF-Datei per Modelfile in Ollama. Für den Einstieg ist der hf.co/…-Weg der mit den wenigsten Stolpersteinen.

Einordnung: Wie viel Hugging Face brauchst du wirklich? #

Ehrliche Antwort für den Homelab-Alltag: wenig — aber das Wenige gezielt. Die Ollama-Library deckt die großen Modellfamilien ab; Hugging Face kommt ins Spiel für alles jenseits davon — spezielle Feintunings, exotische Quantisierungen, brandneue Releases, Embedding-Modelle für RAG-Experimente. Es ist das Nachschlagewerk, nicht die tägliche Anlaufstelle. Ein Konto brauchst du erst, wenn dich ein gated Model interessiert.

Weiterlesen #

Häufige Fragen

Was ist Hugging Face?
Die zentrale Plattform des offenen KI-Ökosystems — am ehesten „GitHub für Machine-Learning-Modelle“: Hunderttausende Modelle, Datensätze und Demos, versioniert in Git-Repositories. Praktisch jedes offene Sprachmodell, das du lokal betreiben kannst, wird dort veröffentlicht. Ein Konto ist zum Herunterladen meist nicht nötig.
Welche Modell-Datei lade ich für Ollama oder llama.cpp herunter?
Die GGUF-Variante in der gewünschten Quantisierung — für den Start Q4_K_M. Die Original-Repositories der Hersteller enthalten meist nur unquantisierte Safetensors-Dateien; nach GGUF-Quantisierungen suchst du am schnellsten über den Format-Filter „GGUF“ auf dem Model Hub oder den Zusatz „GGUF“ im Suchbegriff.
Kann Ollama Modelle direkt von Hugging Face laden?
Ja: ollama run hf.co/<account>/<repository> lädt ein GGUF-Repository direkt, mit angehängtem Tag wie :Q4_K_M wählst du die Quantisierungsstufe. Damit stehen dir auch Modelle offen, die es nicht in die kuratierte Ollama-Library geschafft haben — etwa spezielle Feintunings oder deutschsprachige Varianten.
Was ist eine Model Card?
Die README eines Modell-Repositories: Sie beschreibt, wofür das Modell trainiert wurde, welche Größen und Varianten es gibt, unter welcher Lizenz es steht und welche Einschränkungen bekannt sind. Vor dem Download lohnen drei Blicke: Parameterzahl (passt sie zu deinem Speicher?), Instruct- vs. Base-Variante und die Lizenz.
Darf ich Hugging-Face-Modelle einfach benutzen?
Privat im Homelab in aller Regel ja — aber die Lizenz steht in jeder Model Card und unterscheidet sich: Apache-2.0- und MIT-Modelle (etwa viele Qwen- und Mistral-Modelle) sind sehr freizügig, Meta verlangt für Llama die Zustimmung zu einer eigenen Community-Lizenz, manche Modelle sind „gated“ und erfordern ein Konto plus Zustimmung vor dem Download. Für kommerzielle Nutzung immer die konkrete Lizenz lesen.

Weiterlesen