Zum Hauptinhalt springen

Modell-Registry

AISCouncil verwendet eine community-gepflegte Modell-Registry, um ihre Liste verfügbarer Modelle aktuell zu halten. Die Registry ist eine JSON-Datei, die auf GitHub Pages gehostet wird und die die App abruft und cacht.

Wie es funktioniert​

Die Registry-Datei (registry/models.json) enthält eine strukturierte Liste von Anbietern, ihren Modellen und Preisstufen. Beim Laden der Seite ruft das AISCouncil.Registry-Modul die neuesten Registry-Daten mit einem 24-Stunden-Cache ab. Wenn der Fetch fehlschlägt, wird auf eine lokal gebündelte Kopie zurückgegriffen.

Registry-Format​

Die Registry definiert Anbieter und Modelle mit Metadaten:

{
  "providers": [
    {
      "id": "anthropic",
      "name": "Anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "tier": "standard"
        }
      ]
    }
  ]
}

Modelle beitragen​

Um Modelle zur Registry hinzuzufügen oder zu aktualisieren:

  1. Forken Sie das Repository
  2. Bearbeiten Sie registry/models.json mit Ihren Änderungen
  3. Führen Sie das Validierungsskript aus: python registry/validate.py
  4. Reichen Sie einen Pull Request ein

Das Validierungsskript prüft:

  • Gültige JSON-Struktur
  • Erforderliche Felder (id, name, provider)
  • Keine doppelten Modell-IDs
  • Korrekte Tier-Werte

Auto-Refresh​

Die Registry wird automatisch aktualisiert, wenn die Seite lädt. Der 24-Stunden-Cache verhindert übermäßige Anfragen. Sie können ein Refresh erzwingen, indem Sie die gecachten Daten der App in Einstellungen > Datenschutz löschen.

GitHub Pages Hosting​

Die Registry wird von GitHub Pages als statische JSON-Datei bereitgestellt. Das bedeutet:

  • Keine serverseitige Logik erforderlich
  • Änderungen gehen live, sobald der PR gemergt ist und Pages neu baut
  • Die Datei ist CDN-gecacht für schnellen globalen Zugriff
  • Die App greift graceful zurück, wenn GitHub nicht erreichbar ist