letax

App for Letní X-Challenge: a 10-day event full of challenges and low-cost traveling across Europe 🌍️

Organized by X-Challenge, a Czech non-profit organization and community of people. 🧑‍🤝‍🧑

The app is available to participants during the event at 👉️ app.x-challenge.cz.

Quickstart

1. Clone the repository.
2. Prepare a new Python virtual environment:

python -m venv venv
source venv/bin/activate

3. Install the requirements:

pip install -r requirements.txt

4. Activate the template files:

for file in "src/app/accounts.yaml" "src/app/settings.yaml" ".streamlit/secrets.toml"; do
    cp $file{.template,}
done

5. Fill in the variables in .streamlit/secrets.toml (can be also launched without them with limited functionality).
6. Run the app:

./run.sh

The app should be accessible through your browser at http://localhost:7334/.

You should be able to log in on the user page with the following details:

• login: admin
• password: changethispassword

(you should of course change the default password)

Development

A few pointers:

• Streamlit docs
• my fork of Streamlit Authenticator
• Remote SSH in VSCode
• SQLite3 Editor for VSCode