Skip to content

chore: rename on-disk paths and env to vocagateway - #4

Merged
jatinkrmalik merged 4 commits into
mainfrom
chore/vocagateway-xdg-paths
Aug 9, 2026
Merged

chore: rename on-disk paths and env to vocagateway#4
jatinkrmalik merged 4 commits into
mainfrom
chore/vocagateway-xdg-paths

Conversation

@jatinkrmalik

@jatinkrmalik jatinkrmalik commented Aug 9, 2026

Copy link
Copy Markdown
Member

Summary

  • Default data/config dirs are now ~/.local/share/vocagateway and ~/.config/vocagateway
  • Env vars are VOCAGATEWAY_* only (no VOCAPHONE_* / Local Flow fallbacks)
  • Model markers write/read .vocagateway-model.json
  • WebUI localStorage keys moved to vocagateway.*

Stacked on #3. Intentional break while this is still pre-release.

Note for other developers

cc: @sesav @Mr-Sunglasses

If you already ran a gateway locally under the old names, move or recreate:

# Config + bootstrap token
mkdir -p ~/.config/vocagateway
mv ~/.config/vocaphone/token ~/.config/vocagateway/token 2>/dev/null || true
mv ~/.config/vocaphone/config.json ~/.config/vocagateway/config.json 2>/dev/null || true

# Data + downloaded models
mv ~/.local/share/vocaphone ~/.local/share/vocagateway 2>/dev/null || true

# Marker files inside models (otherwise installs look missing)
find ~/.local/share/vocagateway/models -name '.vocaphone-model.json' \
  -execdir mv {} .vocagateway-model.json \; 2>/dev/null || true

Also rename any VOCAPHONE_* env vars in your shell/systemd/compose to VOCAGATEWAY_*, and re-paste the token in the WebUI once (localStorage key changed).

CLI entry points (vocaphone-server, etc.) and the PyPI/extra name are unchanged in this PR.

Test plan

  • Fresh start mints ~/.config/vocagateway/token and uses ~/.local/share/vocagateway
  • VOCAGATEWAY_DATA_DIR / VOCAGATEWAY_MODELS_DIR overrides work
  • Download a model; marker is .vocagateway-model.json
  • Pairing / WebUI still auth with the new token path
  • CI quality green

Drop the vocaphone/localflow path and env aliases. Defaults are now
~/.config/vocagateway and ~/.local/share/vocagateway with a matching
VOCAGATEWAY_* env namespace. No migration shims — this tree is still
pre-release.
@jatinkrmalik
jatinkrmalik force-pushed the chore/vocagateway-xdg-paths branch from 87abc16 to 5ec6c51 Compare August 9, 2026 05:02
@jatinkrmalik
jatinkrmalik changed the base branch from style/align-webui-vocahq-paper to main August 9, 2026 05:02
@jatinkrmalik
jatinkrmalik merged commit 5807da5 into main Aug 9, 2026
2 checks passed
@Mr-Sunglasses
Mr-Sunglasses deleted the chore/vocagateway-xdg-paths branch September 3, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant