pagepiper/.env.example
pyr0ball 76aaabd857 feat: rename CF_ORCH_URL to GPU_SERVER_URL for self-hoster clarity
CF_ORCH_URL makes sense internally but isn't self-explanatory for a
local-first user setting up their own GPU rig. Follows the GPU_SERVER_URL
convention Kiwi already established (app/core/config.py there).

- app/config.py: resolves GPU_SERVER_URL -> CF_ORCH_URL (back-compat
  alias) -> https://orch.circuitforge.tech default when CF_LICENSE_KEY
  is present (Paid+ tiers). Written back to os.environ["CF_ORCH_URL"]
  so existing callers (get_llm_config, app/api/chat.py) needed zero
  changes.
- .env.example / .env.cloud.example: document GPU_SERVER_URL as the
  primary name, CF_ORCH_URL noted as a still-honoured legacy alias.
- compose.cloud.yml: the hardcoded coordinator URL now sets
  GPU_SERVER_URL instead of CF_ORCH_URL directly (relies on the same
  config.py normalization).
- docs/reference/environment-variables.md updated.
- 6 new tests covering the resolution priority chain and the
  write-back behavior legacy callers depend on.

Closes: #10
2026-07-10 17:23:27 -07:00

26 lines
1.1 KiB
Text

# Copy to .env and fill in your values. .env is gitignored.
# Path to your PDF library on the host machine
PAGEPIPER_BOOKS_DIR=/path/to/your/pdfs
# Data directory (SQLite + vector DB stored here)
PAGEPIPER_DATA_DIR=data
# Ollama URL — set this to unlock semantic search and RAG chat (BYOK)
# PAGEPIPER_OLLAMA_URL=http://localhost:11434
# PAGEPIPER_CHAT_MODEL=mistral:7b
# PAGEPIPER_EMBED_MODEL=nomic-embed-text
# Self-hosted GPU rig URL — set this instead of PAGEPIPER_OLLAMA_URL if you're
# running a cf-orch coordinator (e.g. a home GPU rack). The coordinator resolves
# the actual service URL at allocation time. (CF_ORCH_URL is still honoured as
# a legacy alias if you already have it set.)
# GPU_SERVER_URL=http://localhost:7700
# Forgejo API token — enables the in-app feedback button (files Forgejo issues)
# Create a token at https://git.opensourcesolarpunk.com/user/settings/applications
# FORGEJO_API_TOKEN=
# Enable thumbs up/down on chat answers (stores retrieval quality signals locally)
# Off by default — opt in when you want to collect correction data
# PAGEPIPER_CHAT_FEEDBACK=true