Move germ's default port 8765 → 5178 (collision with oída)

germ and oída both defaulted to 8765, so the two servers could never run
together — silently breaking the oída→germ handoff. germ now defaults to
GERM_PORT=5178 (matching oída's OIDA_GERM_URL default and the SFL port
registry); oída keeps 8765. Dashboard JS is same-origin and unaffected.
Docs, client spec, python client, and launchers updated. 105 tests pass.

Author: emeisazam

README.md

@@ -87,7 +87,7 @@ Double-click in Finder or run:
 The dashboard opens at:
 
 ```text
-http://127.0.0.1:8765/dashboard
+http://127.0.0.1:5178/dashboard
 ```
 
 Server-only launch:
@@ -102,7 +102,7 @@ Tailscale launch for another device in the same tailnet:
 ./scripts/run_tailscale.sh
 ```
 
-Open the printed `http://<tailscale-ip>:8765/dashboard` URL from the other device.
+Open the printed `http://<tailscale-ip>:5178/dashboard` URL from the other device.
 The script binds to the detected Tailscale IP by default and allowlists localhost,
 the detected Tailscale IP, the local host name, and Tailscale MagicDNS host names
 in `GERM_ALLOWED_HOSTS`.
@@ -113,7 +113,7 @@ detected, instead of binding to all interfaces.
 Health check:
 
 ```bash
-curl http://127.0.0.1:8765/health
+curl http://127.0.0.1:5178/health
 ```
 
 ## Python And MLX Runtimes
@@ -137,7 +137,7 @@ Useful environment variables:
 
 ```text
 GERM_HOST=127.0.0.1
-GERM_PORT=8765
+GERM_PORT=5178
 GERM_ACTIVE_PROVIDER=mock
 GERM_OUTPUT_DIR=output
 GERM_ALLOWED_INPUT_ROOTS=output
@@ -167,7 +167,7 @@ the model terms and log in when needed:
 
 ```bash
 uv run hf auth login
-curl "http://127.0.0.1:8765/huggingface/status?check_models=true"
+curl "http://127.0.0.1:5178/huggingface/status?check_models=true"
 ```
 
 Cancellation note: queued jobs can always be cancelled. MLX jobs terminate the
@@ -310,7 +310,7 @@ POST /files/reveal
 Example germination request:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/generate \
+curl -X POST http://127.0.0.1:5178/generate \
   -H "content-type: application/json" \
   -d '{
     "provider": "mock",

clients/germinator_client_spec.md

@@ -3,7 +3,7 @@
 Base URL:
 
 ```text
-http://127.0.0.1:8765
+http://127.0.0.1:5178
 ```
 
 The FastAPI server is the stable integration layer. Germinator, plugins, Max patches,
@@ -64,25 +64,25 @@ complete route list lives in `docs/api_reference.md`.
 Health:
 
 ```bash
-curl http://127.0.0.1:8765/health
+curl http://127.0.0.1:5178/health
 ```
 
 Models:
 
 ```bash
-curl http://127.0.0.1:8765/models
+curl http://127.0.0.1:5178/models
 ```
 
 Hugging Face access check for Python-provider weights:
 
 ```bash
-curl "http://127.0.0.1:8765/huggingface/status?check_models=true"
+curl "http://127.0.0.1:5178/huggingface/status?check_models=true"
 ```
 
 Generate a new layer:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/generate \
+curl -X POST http://127.0.0.1:5178/generate \
   -H "content-type: application/json" \
   -d '{
     "provider": "mock",
@@ -100,7 +100,7 @@ curl -X POST http://127.0.0.1:8765/generate \
 Morph selected audio:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/audio-to-audio \
+curl -X POST http://127.0.0.1:5178/audio-to-audio \
   -H "content-type: application/json" \
   -d '{
     "provider": "stable_audio_python",
@@ -117,7 +117,7 @@ curl -X POST http://127.0.0.1:8765/audio-to-audio \
 Inpaint selected regions:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/inpaint \
+curl -X POST http://127.0.0.1:5178/inpaint \
   -H "content-type: application/json" \
   -d '{
     "provider": "stable_audio_python",
@@ -134,7 +134,7 @@ curl -X POST http://127.0.0.1:8765/inpaint \
 Continue a clip:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/continue \
+curl -X POST http://127.0.0.1:5178/continue \
   -H "content-type: application/json" \
   -d '{
     "provider": "stable_audio_python",
@@ -151,7 +151,7 @@ curl -X POST http://127.0.0.1:8765/continue \
 Submit an async render job:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/jobs/submit \
+curl -X POST http://127.0.0.1:5178/jobs/submit \
   -H "content-type: application/json" \
   -d '{
     "mode": "text-to-audio",
@@ -168,14 +168,14 @@ curl -X POST http://127.0.0.1:8765/jobs/submit \
 Load and control LoRA:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/lora/load \
+curl -X POST http://127.0.0.1:5178/lora/load \
   -H "content-type: application/json" \
   -d '{
     "provider": "stable_audio_python",
     "paths": ["/path/to/your_style.safetensors"]
   }'
 
-curl -X POST http://127.0.0.1:8765/lora/strength \
+curl -X POST http://127.0.0.1:5178/lora/strength \
   -H "content-type: application/json" \
   -d '{
     "provider": "stable_audio_python",
@@ -187,25 +187,25 @@ curl -X POST http://127.0.0.1:8765/lora/strength \
 Job lookup:
 
 ```bash
-curl http://127.0.0.1:8765/jobs/JOB_ID
+curl http://127.0.0.1:5178/jobs/JOB_ID
 ```
 
 Job event stream:
 
 ```text
-ws://127.0.0.1:8765/jobs/JOB_ID/events
+ws://127.0.0.1:5178/jobs/JOB_ID/events
 ```
 
 Generated library:
 
 ```bash
-curl http://127.0.0.1:8765/library
+curl http://127.0.0.1:5178/library
 ```
 
 Reveal a generated file in Finder on macOS:
 
 ```bash
-curl -X POST http://127.0.0.1:8765/files/reveal \
+curl -X POST http://127.0.0.1:5178/files/reveal \
   -H "content-type: application/json" \
   -d '{"path":"output/audio/ceramic_impact.wav"}'
 ```

clients/python_client.py

@@ -6,7 +6,7 @@
 import httpx
 
 
-DEFAULT_BASE_URL = "http://127.0.0.1:8765"
+DEFAULT_BASE_URL = "http://127.0.0.1:5178"
 
 
 class GerminatorClient:

docs/api_reference.md

@@ -3,7 +3,7 @@
 Default base URL:
 
 ```text
-http://127.0.0.1:8765
+http://127.0.0.1:5178
 ```
 
 ## GET /health
@@ -85,7 +85,7 @@ Use `check_models=true` to run dry-run download checks for Small SFX, Small Musi
 and Medium:
 
 ```bash
-curl "http://127.0.0.1:8765/huggingface/status?check_models=true"
+curl "http://127.0.0.1:5178/huggingface/status?check_models=true"
 ```
 
 Response includes `auth.logged_in`, per-model `status`, and `next_steps`. The route

docs/local_setup.md

@@ -17,7 +17,7 @@ Run the server:
 Check:
 
 ```bash
-curl http://127.0.0.1:8765/health
+curl http://127.0.0.1:5178/health
 ```
 
 ## Mock Mode
@@ -26,7 +26,7 @@ Mock mode is the default. It writes placeholder WAV files and metadata so germ a
 the dashboard can be tested before model downloads.
 
 ```bash
-curl -X POST http://127.0.0.1:8765/generate \
+curl -X POST http://127.0.0.1:5178/generate \
   -H "content-type: application/json" \
   -d '{"provider":"mock","model":"mock-sine","prompt":"dry wood impact","duration":2}'
 ```
@@ -79,7 +79,7 @@ in or have not accepted the Stability AI model terms.
 
    ```bash
    ./launch_germ.command
-   curl "http://127.0.0.1:8765/huggingface/status?check_models=true"
+   curl "http://127.0.0.1:5178/huggingface/status?check_models=true"
    ```
 
 You can run the same check from the dashboard Status section with `HF Check`.
@@ -122,7 +122,7 @@ The optimized dashboard is served by the FastAPI sidecar:
 Open:
 
 ```text
-http://127.0.0.1:8765/dashboard
+http://127.0.0.1:5178/dashboard
 ```
 
 This dashboard is plain HTML/CSS/JavaScript, not Gradio. Gradio is only used for the
@@ -133,7 +133,7 @@ optional official Stability demo through `scripts/run_official_gradio.sh`.
 Open:
 
 ```text
-http://127.0.0.1:8765/dashboard
+http://127.0.0.1:5178/dashboard
 ```
 
 In the `Status` tab:

launch_germinator.command

@@ -5,7 +5,7 @@ PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 cd "$PROJECT_ROOT"
 
 export GERM_HOST="${GERM_HOST:-${GERMINATOR_HOST:-127.0.0.1}}"
-export GERM_PORT="${GERM_PORT:-${GERMINATOR_PORT:-8765}}"
+export GERM_PORT="${GERM_PORT:-${GERMINATOR_PORT:-5178}}"
 
 API_URL="http://${GERM_HOST}:${GERM_PORT}"
 DASHBOARD_URL="${API_URL}/dashboard"

server/config.py

@@ -56,7 +56,7 @@ class Settings:
     def __init__(self) -> None:
         self.project_root = PROJECT_ROOT
         self.host = _env("GERM_HOST", "127.0.0.1", legacy="GERMINATOR_HOST") or "127.0.0.1"
-        self.port = int(_env("GERM_PORT", "8765", legacy="GERMINATOR_PORT") or "8765")
+        self.port = int(_env("GERM_PORT", "5178", legacy="GERMINATOR_PORT") or "5178")
         self.active_provider = _env(
             "GERM_ACTIVE_PROVIDER",
             "mock",