lupier/scalable-wealth
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update entrypoint.sh to improve script execution logic and README.md for clarity; add mcp and httpx to requirements

Browse Source
This commit is contained in:
Lukas Pierchalla
2026-09-20 12:07:52 +02:00
parent e7ecdfcd36
commit 9b4e351f79
4 changed files with 220 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+129 -37
View File
@@ -1,12 +1,13 @@
# scalable-sync
Synchronisiert Scalable Capital Broker-Transaktionen nach Wealthfolio.
Synchronisiert Scalable Capital Broker-Transaktionen nach Wealthfolio via MCP.
## Voraussetzungen
- Docker + Docker Compose
- Wealthfolio mit MCP aktiviert (`WF_MCP_ENABLED=true`)
- Scalable Capital: Agentic Investing aktiviert (Profil → Sicherheit)
- `sc`-CLI auf dem Host installiert (siehe unten)
## Dateien
@@ -14,44 +15,83 @@ Synchronisiert Scalable Capital Broker-Transaktionen nach Wealthfolio.
|---|---|
| `Dockerfile` | Container-Image |
| `compose.yaml` | Docker Compose Config |
| `.env` | Alle Einstellungen |
| `example.env` | Vorlage für `.env` |
| `scalable_sync.py` | Sync-Adapter |
| `requirements.txt` | Python-Abhängigkeiten |
## Setup
```bash
# Dateien in ein Verzeichnis deiner Wahl kopieren, z. B.:
# /opt/scalable-sync/ oder ~/docker/scalable-sync/
### 1. Scalable CLI auf dem Host installieren
**Linux / WSL:**
```bash
curl -fsSL -o /tmp/sc.tar.gz \
"[https://github.com/ScalableCapital/scalable-cli/releases/download/v1.0.0/sc-v1.0.0-linux-x86_64-gnu.tar.gz](https://github.com/ScalableCapital/scalable-cli/releases/download/v1.0.0/sc-v1.0.0-linux-x86_64-gnu.tar.gz)"
curl -fsSL -o /tmp/SHA256SUMS \
"[https://github.com/ScalableCapital/scalable-cli/releases/download/v1.0.0/sc-v1.0.0-SHA256SUMS](https://github.com/ScalableCapital/scalable-cli/releases/download/v1.0.0/sc-v1.0.0-SHA256SUMS)"
cd /tmp && grep "linux-x86_64-gnu.tar.gz" SHA256SUMS | awk '{print $1 " sc.tar.gz"}' | sha256sum -c -
tar -xzf sc.tar.gz
sudo mv sc-v1.0.0-linux-x86_64-gnu/sc /usr/local/bin/sc
sudo chmod +x /usr/local/bin/sc
sc --version
```
### 2. Login auf dem Host (einmalig)
WSL/Linux hat keinen Keyring — daher `session_backend = "file"` setzen:
```bash
mkdir -p ~/.config/scalable-cli
cat > ~/.config/scalable-cli/config.toml <<'EOF'
[auth]
session_backend = "file"
signing_key_backend = "file"
EOF
sc login --local-read-only
```
### 3. .env anlegen
```bash
cp example.env .env
# WF_MCP_URL, WF_MCP_TOKEN, WF_ACCOUNT_ID, ASSET_MAP, PUID, PGID anpassen
```
### 4. Bind-Mount in compose.yaml anpassen
```yaml
volumes:
- scalable-sync-data:/app/data
- /home/<dein-user>/.config/scalable-cli:/tmp/sc-config:ro
```
### 5. Testen und starten
```bash
docker compose build
# 1. Einmalig einloggen (Session wird im Volume gespeichert)
docker compose run --rm -it scalable-sync sc login --local-read-only
# 2. Test
# Session testen
docker compose run --rm scalable-sync sc whoami
docker compose run --rm scalable-sync sc broker holdings --json | jq .
docker compose run --rm scalable-sync sc broker holdings
# 3. Dry-Run
# Dry-Run
docker compose run --rm scalable-sync python /app/scalable_sync.py --once --dry-run
# 4. Start
# Start
docker compose up -d
```
## .env
## .env Referenz
```bash
# Wealthfolio
WF_MCP_URL=http://wealthfolio:8088/mcp
WF_MCP_TOKEN=wf_mcp_dein_token_hier
WF_ACCOUNT_ID=dein-konto-uuid
# Optional: Scalable Portfolio-ID (bei mehreren Portfolios)
SC_PORTFOLIO_ID=
# Sync
SYNC_INTERVAL_HOURS=6
SC_OVERLAP_DAYS=14
SC_SETTLED_ONLY=true
@@ -59,36 +99,34 @@ SC_SETTLED_ONLY=true
# ISIN → Wealthfolio-Symbol
ASSET_MAP={"IE00B4L5Y983":"EUNL.DE","IE00B3RBWM25":"VWCE.DE"}
# Container-User
PUID=1000
PGID=1000
```
### WF_ACCOUNT_ID finden
Wealthfolio → Accounts → Konto anklicken → ID aus der URL kopieren (`/accounts/abc123-def456/...`).
Wealthfolio → Accounts → Konto anklicken → ID aus der URL kopieren.
### ASSET_MAP
JSON-Objekt: `"ISIN": "SYMBOL"`. Wealthfolio-Symbol unter Assets suchen.
JSON-Objekt `"ISIN": "Symbol"`. ISINs ermitteln mit:
```bash
sc broker holdings
```
### SC_PORTFOLIO_ID
Nur bei mehreren Scalable-Portfolios nötig. Ermitteln mit:
Nur bei mehreren Scalable-Portfolios. Ermitteln mit:
```bash
docker compose run --rm scalable-sync sc broker context show --json
docker compose run --rm scalable-sync sc broker context show
```
## Volumes
## Session erneuern
Docker legt diese Volumes automatisch an — kein manuelles `mkdir` nötig.
| Volume | Inhalt | Zweck |
|---|---|---|
| `scalable-sync-data` | state.db, audit.jsonl, dead-letter.jsonl | Sync-Status und Logs |
| `scalable-sync-config` | config.toml, session.json | Scalable CLI Session |
**Wichtig:** Ohne `scalable-sync-config` geht die Session bei `docker compose down` verloren.
```bash
sc login --local-read-only
docker compose restart scalable-sync
```
## Befehle
@@ -97,15 +135,69 @@ Docker legt diese Volumes automatisch an — kein manuelles `mkdir` nötig.
| `docker compose run --rm scalable-sync python /app/scalable_sync.py --once --dry-run` | Testlauf ohne Schreiben |
| `docker compose run --rm scalable-sync python /app/scalable_sync.py --once` | Einmaliger Sync |
| `docker compose logs -f` | Logs anzeigen |
| `docker compose down && docker compose up -d` | Neustart (Session bleibt erhalten) |
| `docker compose down && docker compose up -d` | Neustart |
## Volumes
| Volume | Inhalt | Zweck |
|---|---|---|
| `scalable-sync-data` | state.db, audit.jsonl, dead-letter.jsonl | Sync-Status und Logs |
Die Session liegt auf dem Host unter `~/.config/scalable-cli/` und wird als read-only Bind-Mount eingehängt.
## Troubleshooting
| Problem | Lösung |
|---|---|
| "Not logged in" | `docker compose run --rm -it scalable-sync sc login --local-read-only` |
| `sc whoami` schlägt fehl | Session abgelaufen — `sc login --local-read-only` wiederholen, dann `docker compose restart` |
| Keine Transaktionen | `SC_SETTLED_ONLY` und `SC_OVERLAP_DAYS` prüfen |
| Unmapped ISIN | ISIN in `ASSET_MAP` ergänzen |
| Mehrere Portfolios | `SC_PORTFOLIO_ID` setzen |
| Doppelte Activities | Prüfen ob `WF_ACCOUNT_ID` korrekt ist |
| Session nach Neustart weg | `scalable-sync-config` Volume in compose.yaml prüfen |
| Mehrere Portfolios | `SC_PORTFOLIO_ID` in `.env` setzen |
| Doppelte Activities | `WF_ACCOUNT_ID` prüfen |
## Wealthfolio-Vorbereitung
### 1. MCP aktivieren
In der Wealthfolio `compose.yaml`:
```yaml
environment:
WF_MCP_ENABLED: "true"
WF_MCP_TOKEN: "wf_mcp_dein_geheimer_token"
```
Danach Wealthfolio neu starten.
### 2. Account anlegen
Wealthfolio → **Accounts** → **Add Account**:
| Feld | Wert |
|---|---|
| Name | `Scalable Capital` (frei wählbar) |
| Type | `Brokerage` |
| Currency | `EUR` |
**WF_ACCOUNT_ID ermitteln:** Account anklicken → ID aus der URL kopieren:
````
/accounts/550e8400-e29b-41d4-a716-446655440000/ → diese UUID ist deine WF_ACCOUNT_ID
````
### 3. Assets anlegen
Jedes ETF muss in Wealthfolio als Asset existieren. Wealthfolio → **Assets** → Asset suchen oder neu anlegen.
ISINs deiner gehaltenen ETFs ermitteln:
```bash
sc broker holdings
```
Das **Symbol** in Wealthfolio (z. B. `EUNL.DE`) exakt in `ASSET_MAP` übernehmen:
```bash
ASSET_MAP={"IE00B4L5Y983":"EUNL.DE","IE00B3RBWM25":"VWCE.DE","DE0002635307":"EXSA.DE"}
```
> **Wichtig:** Symbol muss exakt übereinstimmen — am besten aus Wealthfolio kopieren, nicht raten.