sissiwup/monica-api-proxy repository overview

⁠Python Proxy für Monica.im API (OpenAI-Kompatibilität)

Dieser leichte, mit Python erstellte Proxy dient als Kompatibilitäts-Brücke für die Monica.im API (openapi.monica.im).

⁠Zweck

Viele Client-Anwendungen, die für OpenAI-kompatible APIs entwickelt wurden (z. B. n8n, Xcode-Integrationen), setzen einen /v1/models-Endpunkt voraus, um die verfügbaren Modelle abzurufen. Dieser Endpunkt fehlt in der offiziellen openapi.monica.im-Implementierung.

Dieser Proxy löst genau dieses Problem, indem er:

1. Den fehlenden /v1/models-Endpunkt bereitstellt.
2. Alle anderen Anfragen transparent und unverändert an die Monica.im API weiterleitet.

Es findet keine Authentifizierung oder Modifikation von Headern im Proxy statt. Der Authorization-Header, den der Client sendet, wird direkt an die Monica.im API durchgereicht.

⁠Quellcode

Das vollständige Projekt finden Sie im zugehörigen GitHub-Repository:

sissiwup/monica-api-proxy⁠

⁠Schnellstart

1. Image pullen:

   docker pull sissiwup/monica-api-proxy:latest
   

   Copy

2. Container starten (einfach): Dieser Befehl startet den Proxy auf Port 5001.

   docker run -d \
     -p 5001:5001 \
     --name monica-proxy-python \
     sissiwup/monica-api-proxy:latest
   

   Copy

3. Container starten (mit eigener Modell-Liste): Sie können die Liste der Modelle, die über /v1/models zurückgegeben wird, anpassen, indem Sie eine eigene models.json-Datei in den Container mounten.

   docker run -d \
     -p 5001:5001 \
     -v /ihr/lokaler/pfad/zur/models.json:/app/models.json \
     --name monica-proxy-python \
     sissiwup/monica-api-proxy:latest
   

   Copy

   Wenn die Datei nicht bereitgestellt wird, verwendet der Proxy eine interne Standardliste.

⁠Anwendungsbeispiele

• Modell-Liste abrufen (die neue Funktion):

  curl http://localhost:5001/v1/models
  

  Copy

• Chat-Anfrage durchleiten (transparenter Proxy): Ersetzen Sie IHR-MONICA.IM-API-TOKEN durch Ihren echten API-Schlüssel.

  curl -X POST "http://localhost:5001/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer IHR-MONICA.IM-API-TOKEN" \
    -d '{
          "model": "gpt-4o",
          "messages": [{"role": "user", "content": "Hallo Welt!"}]
       }'
  

  Copy

Der Proxy leitet diese Anfrage 1:1 an https://openapi.monica.im/v1/chat/completions weiter.