Apppublic

ZashLiu/parallel-reality-api

sourceHugging Faceupdated 4h agoView on Hugging Face

0likes

App README

Parallel Reality API

FastAPI backend for the Parallel Reality RPG app.

Required Space Secrets

Set these in Space Settings → Variables and secrets:

Name	Type	Value
`HF_TOKEN`	Secret	A write-access token from huggingface.co/settings/tokens
`HF_BACKUP_DATASET`	Variable	`<your-username>/parallel-reality-backup` (the private dataset you created for backups)
`SLEEP_GUARD_RECOVERY_KEY`	Secret	Stable secret used to encrypt supervisor recovery codes at rest

Without these, the app still runs but data won't survive container rebuilds.

SLEEP_GUARD_RECOVERY_KEY should remain unchanged after deployment. Existing recovery handoffs cannot be decrypted if this secret is rotated or removed.

睡眠守护支持两种监督者交接方式：绑定账号的链接，以及无需账号但“拿到链接即可查看一次”的低安全性链接。两种链接默认 72 小时过期，查看一次后失效。

Backup behavior

—On boot: restores sql_app.db and static/music/ from the configured HF Dataset (no-op on first run).
—Every 30 minutes: uploads a snapshot to the dataset.