Pynchy Ops

Pynchy Ops

The live Pynchy host and checkout path are deployment-specific. Public repo instructions must not assume a private hostname or home-directory layout. Set PYNCHY_HOST and PYNCHY_REMOTE_ROOT from local memory, environment, or the operator before running remote commands.

Deployment Mode Gate

Identify the live deployment before running an operational command. A pynchy Kubernetes namespace means the Kubernetes path applies:

PYNCHY_HOST="${PYNCHY_HOST:?set the live host}"
ssh "$PYNCHY_HOST" 'sudo k3s kubectl get namespace pynchy'

For Kubernetes deployments:

• Read Kubernetes installation and operations.
• Treat SCHEDULER__AUTO_DEPLOY=false as authoritative. A Git pull updates the persistent checkout but does not replace the running image.
• Use sudo k3s kubectl -n pynchy; do not use pynchy deploy, LaunchAgent commands, standalone systemd commands, or direct container deletion.
• A successful push to main publishes immutable images. The namespace-scoped pynchy-release-monitor CronJob preflights and releases them.
• Do not manually patch the Deployment or delete a Pod for a normal release. Observe the monitor Job, rollout, exact release annotation, and application status.
• Apply Kubernetes manifest, storage, Secret, RBAC, Pocket TTS, and private MCP image changes manually after review; the application release monitor does not apply infrastructure.
• Keep unrelated Docker Compose and Dockge services outside Kubernetes.

The standalone sections below apply only when the live host has no Kubernetes Pynchy Deployment.

Standalone Auto-deploy: Never Restart Manually

Pynchy self-manages. Two mechanisms trigger automatic restarts:

1. Git changes on main — the polling mechanism detects new commits, pulls, and restarts (with container rebuild if source files changed).
2. Config file changes — editing config.toml, litellm_config.yaml, or other settings files triggers an automatic deploy on the next host git-sync poll. The default interval is 300 seconds; check [scheduler].git_sync_interval_seconds before deciding it was missed.