feat: hosted live demo (light requirements + theme + deploy guide)#29
Open
Rekin226 wants to merge 1 commit into
Open
feat: hosted live demo (light requirements + theme + deploy guide)#29Rekin226 wants to merge 1 commit into
Rekin226 wants to merge 1 commit into
Conversation
…loy guide) The Design Calculator and Optimize Ratio modes are deterministic and only need streamlit + pandas, so the hosted demo can install a light requirements.txt and boot in seconds — well inside Streamlit Community Cloud's free tier. Chat degrades to a friendly message when the heavy stack is absent (already handled in app.py). - requirements.txt: minimal manifest Streamlit Cloud auto-detects (demo + core). - requirement.txt: header clarifying it's the FULL stack (CI / chat / dev). - .streamlit/config.toml: on-brand green theme, headless, no usage stats. - README: "Try the live demo" link + badge, deploy-your-own guide. - docs/demo.md: deploy steps, subdomain claim, and GIF-recording playbook. Part of #24. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes Agronaut deployable as a free, key-free live demo and wires it into the README — the single highest-leverage change for stars (a visitor sees it work in 10 seconds).
Part of #24. The actual click-to-deploy and GIF recording are owner steps (need a Streamlit/GitHub login) —
docs/demo.mdis the playbook.The insight
The Design Calculator and Optimize Ratio modes are deterministic and import only
streamlit+pandasalong their path (verified).app.pyalready lazy-imports the chat stack and degrades gracefully when it's absent. So the demo doesn't need torch/faiss/langchain at all — it boots in seconds and stays well inside Streamlit Community Cloud's free-tier limit.What's here
requirements.txt— light manifest Streamlit Cloud auto-detects (the repo previously only hadrequirement.txt, singular, which Cloud ignores). Installs streamlit + pandas + numpy + openpyxl + markdown.requirement.txt— header comment clarifying it's the FULL stack (CI / chat / dev). Unchanged otherwise, so CI and local dev are unaffected..streamlit/config.toml— on-brand leaf-green theme, headless, usage stats off.docs/demo.md— deploy steps, how to claim theagronaut.streamlit.appsubdomain, and a GIF-recording playbook.Verification
AppTest: app boots with no exception and renders all three modes (Design Calculator default, Optimize Ratio, and chat) — confirmed locally.streamlit+pandas.git check-ignoreclean — none of the new files are gitignored.Owner follow-ups (in docs/demo.md)
main→app.py), claimagronautsubdomain.docs/agronaut-demo.gif, swap the README TODO line.🤖 Generated with Claude Code