Skip to content

Commit baf3bbb

Browse files
committed
Drop Xserver domain-bridge flow; document direct streamlit.app publishing
The intended publishing path is just the *.streamlit.app URL with Sharing = "Anyone with the link can view" -- no rental host required. - README: replace the Xserver / .htaccess section with a single step ("flip Sharing to Anyone with the link") and keep HF Spaces / Fly / Render / Cloud Run as self-host alternatives. - Delete the now-unreferenced deploy/xserver-htaccess.example. Made-with: Cursor
1 parent e29fc00 commit baf3bbb

2 files changed

Lines changed: 31 additions & 75 deletions

File tree

README.md

Lines changed: 31 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -153,27 +153,39 @@ uv run python scripts/check_streamlit_deploy.py
153153
154154
## Deploy to the public web (free)
155155

156-
The dashboard can be published for free via **Streamlit Community Cloud**
157-
(or Hugging Face Spaces) and bridged from any domain you already own
158-
(Xserver / お名前ドットコム / Cloudflare / …).
156+
The dashboard is published for free via **Streamlit Community Cloud** at
157+
<https://parallelquasiquantum4co.streamlit.app/> — no custom domain, no
158+
paid hosting, nothing else to wire up. The same repository can also be
159+
dropped onto Hugging Face Spaces, Fly.io, Render, or Google Cloud Run
160+
unchanged.
159161

160-
### 1. Deploy to Streamlit Community Cloud
162+
### 1. Streamlit Community Cloud (the live URL)
161163

162-
The repository already ships the two files needed by Community Cloud:
164+
The repository already ships everything Community Cloud needs:
163165

164166
- [`requirements.txt`](requirements.txt) — CPU-only PyTorch pin plus the
165167
minimal runtime. Installs this repo as the `qqa` package via the
166168
trailing `.`.
167-
- [`.streamlit/config.toml`](.streamlit/config.toml) — on-brand dark
168-
theme and telemetry off.
169+
- [`runtime.txt`](runtime.txt) — pins the Python version for Community
170+
Cloud.
171+
- [`.streamlit/config.toml`](.streamlit/config.toml) — light theme and
172+
telemetry off.
169173

170-
Then:
174+
First-time deploy:
171175

172176
1. Go to <https://share.streamlit.io> and sign in with GitHub.
173177
2. **New app** → Repository `Yuma-Ichikawa/QQA4CO`, Branch `main`,
174178
Main file path `app/streamlit_app.py`.
175179
3. Click **Deploy**. Your app will be served at
176180
`https://<something>.streamlit.app` after a 3–5 min build.
181+
4. In the app's ``**Settings****Sharing**, set *"Who can view
182+
this app?"* to **"Anyone with the link can view"**. This is the only
183+
knob standing between a green deploy and a public URL — without it
184+
every visitor is redirected to Streamlit SSO.
185+
186+
Re-deploys happen automatically on every push to `main`. The runbook,
187+
common failure modes, and the health-check endpoint are documented in
188+
[`deploy/STREAMLIT_DEPLOY.md`](deploy/STREAMLIT_DEPLOY.md).
177189

178190
The custom-problem editor is **off by default** on public deployments
179191
(it evaluates arbitrary Python via `exec`). Re-enable it on a trusted
@@ -183,26 +195,20 @@ machine with:
183195
QQA_ALLOW_CUSTOM=1 uv run qqa gui
184196
```
185197

186-
### 2. Point your own domain at the app
187-
188-
If you own a domain on a shared rental host (e.g. Xserver), drop this
189-
snippet into the `public_html/` of the subdomain that you want to use
190-
(adjust the target URL):
191-
192-
```apache
193-
RewriteEngine On
194-
RewriteRule ^(.*)$ https://qqa4co.streamlit.app/$1 [R=301,L]
195-
```
198+
### 2. Other free / cheap targets
196199

197-
A ready-to-copy template with both `301` and `iframe` variants lives at
198-
[`deploy/xserver-htaccess.example`](deploy/xserver-htaccess.example).
200+
If you would rather self-host, the repository is portable enough to drop
201+
onto any of the usual platforms without edits:
199202

200-
### Other targets
203+
- **Hugging Face Spaces** (Streamlit SDK) — persistent URL, free CPU
204+
tier, HTTPS by default.
205+
- **Fly.io / Render** — Docker-based deploys; use `app/streamlit_app.py`
206+
as the entry point and `requirements.txt` as the dependency file.
207+
- **Google Cloud Run** — container image, pay-per-request.
201208

202-
The repository is portable enough to drop onto any of the usual
203-
platforms: Hugging Face Spaces (Streamlit SDK), Fly.io / Render
204-
(Docker), Google Cloud Run. The same `requirements.txt` and
205-
`app/streamlit_app.py` serve as the entry points.
209+
You do *not* need a domain registrar / shared-hosting account for any
210+
of these — each platform gives you a permanent HTTPS URL out of the
211+
box.
206212

207213
## Visualization
208214

deploy/xserver-htaccess.example

Lines changed: 0 additions & 50 deletions
This file was deleted.

0 commit comments

Comments
 (0)