Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/azharul122/streamlit-app

Last synced: 16 days ago
JSON representation

Host: GitHub
URL: https://github.com/azharul122/streamlit-app
Owner: Azharul122
License: apache-2.0
Created: 2023-07-24T02:17:50.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-07-24T02:17:51.000Z (over 1 year ago)
Last Synced: 2023-07-24T03:33:42.069Z (over 1 year ago)
Language: Python
Size: 11.7 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# The `streamlit hello` multipage demo app, on Railway!

[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/nj-Wms?referralCode=ySCnWl)

This project highlights Streamlit's new multipage app functionality. Now deployable directly to Railway!

![In-use Animation](https://github.com/streamlit/hello/blob/main/mpa-hero.gif?raw=true "In-use Animation")

## How to run this project locally

- pip install -r requirements.txt
- streamlit run Hello.py
- open your browser to `http://127.0.0.1:8501`

## Learn more

- [The original repository that this template used](https://github.com/streamlit/hello)
- [Streamlit Documentation](https://docs.streamlit.io/)
- [Multipage Documentation](https://docs.streamlit.io/library/get-started/multipage-apps)
- [Blog post](https://blog.streamlit.io/introducing-multipage-apps/)

## What makes this work on Railway?

For this project to run on Railway I have added a `railway.json` file with a custom start command, let me break the start command down:
- `streamlit run Hello.py` tells streamlit to run `Hello.py`
- `--server.address 0.0.0.0` listen on host `0.0.0.0` so that streamlit is accessible externally
- `--server.port $PORT` configures streamlit to listen on the auto assigned `PORT` variable that railway expects the app to listen on
- `--server.fileWatcherType none` turns off the file watcher, code changes can't be made after the deployment so starting a file watcher uses unnecessary resources and can cause instabilities
- `--browser.gatherUsageStats false` disables telemetry reporting
- `--client.showErrorDetails false` disables showing debug messages in the browser
- `--client.toolbarMode minimal` removes the 3-dot debug menu from the deployed site

Documentation for additional configurations can be found [here](https://docs.streamlit.io/library/advanced-features/configuration)

I have also updated the dependencies in the `requirements.txt` file, and added a `.python-version` file that tells Railway to build this project with Python 3.10

## Questions? Comments? - Streamlit

Please ask in the [community forum](https://discuss.streamlit.io)

## Questions? Comments? - Railway

Join our [discord server](https://discord.gg/railway) and open a `#Help` thread!