Mitwirken

OpenModels ist ein quelloffenes, von der Community gepflegtes Register. Jedes Modell, jeder Anbieter, Skill und MCP-Server wird als kleine YAML-Datei gespeichert und gegen ein JSON-Schema validiert. Beiträge sind willkommen — so fügen Sie Ihren hinzu.

Was Sie beitragen können

So funktioniert es

  1. 1

    Fork erstellen und klonen

    Erstellen Sie auf GitHub einen Fork des Repositorys und klonen Sie ihn lokal. Legen Sie für Ihre Änderung einen neuen Branch an.

  2. 2

    YAML-Datei hinzufügen

    Erstellen Sie die Datei im passenden Verzeichnis. Der Dateiname muss dem enthaltenen id-Feld im kebab-case entsprechen.

  3. 3

    Lokal validieren

    Führen Sie das Validierungsskript des geänderten Registers aus, um Schema- und Referenzfehler frühzeitig zu erkennen.

  4. 4

    Pull Request öffnen

    Pushen Sie Ihren Branch und öffnen Sie einen Pull Request. Die CI validiert die Änderung automatisch, anschließend prüft sie ein Maintainer.

Vor dem Push validieren

Jedes Register enthält einen Python-Validator, der YAML-Syntax, Schemakonformität, doppelte IDs und referenzielle Integrität prüft.

# Registry (models, providers, mappings)
cd openmodels && pip install -r requirements.txt && python validate_registry.py

# Skills
cd skills && pip install -r requirements.txt && python validate.py

# MCP servers
cd mcp && pip install -r requirements.txt && python validate.py

Konventionen

  • • IDs verwenden kebab-case: Kleinbuchstaben und Ziffern mit Bindestrichen (^[a-z0-9]+(-[a-z0-9]+)*$).
  • • Dateinamen müssen dem Feld id in der Datei entsprechen.
  • • Zeitstempel verwenden ISO 8601 (YYYY-MM-DDTHH:MM:SS.sssZ).
  • • Ländercodes verwenden ISO 3166-1 Alpha-2 in Kleinbuchstaben, zum Beispiel us, cn, uz.