Update README with LLM configuration and Onboarding workaround instructions
This commit is contained in:
1 parent
c1ebd84e11
commit
dbeea97898
1 file changed
+19
@@ -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!
|
||||
Reference in new issue
Block a user