Overhaul README: step-by-step self-hosting guide#7
Merged
Conversation
added 7 commits
June 7, 2026 21:05
- Remove fragile Path 1 (direct whisper, no gateway) — replaced with the correct gateway+whisper compose that actually works end-to-end - All compose snippets now include volume mounts, depends_on, platform, and restart policies — no more model re-downloading on every container restart - Add Step 1–6 structure: Docker install, compose file, start stack, test with curl, find IP, connect the app - Add troubleshooting tables for startup errors and test failures - Add Reach From Anywhere section (Tailscale, Cloudflare Tunnel, ngrok) - Fix Parakeet link: parakeet-tdt-0.6b-v2 → parakeet-tdt-0.6b-v3 - Fix /v1/models description: response has both data[] (OpenAI) and providers[] (iOS legacy), not just OpenAI format - Remove fake Codecov badge (no codecov is set up in this repo) - AI Cleanup section restructured with Option A (cloud) and Option B (Ollama), test commands, and prompt file mounting example - GPU section split into Option A (Parakeet) and Option B (large-v3-turbo) with full compose snippets for each - Update app connection steps to reflect current Preferences → Mode UI
- Tailscale: restore "Install the Tailscale app on iPhone, sign in." - Parakeet: restore "For languages outside this list, use Option B." - large-v3-turbo: restore first-boot download / instant-start note - OpenAI compat: restore auth note (pass any non-empty string as API key)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary