Update README with LLM configuration and Onboarding workaround instructions

This commit is contained in:
Jannik committed 2026-10-01 19:05:50 +02:00
1 parent c1ebd84e11
commit dbeea97898
1 file changed
+19
+19
View File
@@ -40,3 +40,22 @@ Sobald du Änderungen an deiner lokalen `.env` machst, musst du diese neu versch
```bash
age -r <DEIN_AGE_PUBLIC_KEY> -o services/paperclip/.env.age services/paperclip/.env
```
## LLM Konfiguration & Onboarding Workaround
Paperclip ist in seiner Benutzeroberfläche bei der Erstinstallation stark auf offizielle **OpenAI**- oder **Anthropic (Claude)**-Accounts fokussiert. Wenn du stattdessen alternative Provider wie **OpenRouter** oder **Mistral** nutzen möchtest, greift ein Workaround im Deployment-Prozess:
1. **API Keys in der `.env` hinterlegen:**
Trage deine gewünschten API-Keys in die `services/paperclip/.env` ein (z. B. `OPENROUTER_API_KEY=sk-or-v1-...`).
2. **Automatischer Patch durch das Deploy-Skript:**
Das `deploy_script.sh` erkennt automatisch, wenn ein `OPENROUTER_API_KEY` (oder `MISTRAL_API_KEY`) vorhanden ist, aber kein nativer OpenAI/Claude-Key. Es führt dann folgende Schritte aus:
* Setzt `OPENAI_API_KEY` auf deinen OpenRouter/Mistral-Key.
* Setzt `OPENAI_BASE_URL` auf die entsprechende API-URL (z. B. `https://openrouter.ai/api/v1`).
* **WICHTIG:** Das Skript patcht den Paperclip-Container (die Datei `ai-connections.js`) direkt nach dem Start. Dadurch wird sichergestellt, dass die strenge UI-Validierung beim Onboarding deine alternative URL (`OPENAI_BASE_URL`) verwendet und nicht hartcodiert bei OpenAI anfragt.
3. **Das Onboarding in der UI abschließen:**
* Sobald du deinen CEO-Account über den Invite-Link erstellst, landest du im Schritt "Connect a model".
* Klicke hier auf die Schaltfläche **OpenAI (API)**.
* Füge exakt deinen **OpenRouter-** oder **Mistral-Key** in das Textfeld ein und klicke auf "Connect".
* Paperclip testet den Key nun erfolgreich gegen deinen Provider und lässt dich ins Dashboard!