# Build and Deploy a “Hello World” Web App with Streamlit Community Cloud + GitHub

In this mini-guide, you’ll build a simple Python web app, upload your code to GitHub, and deploy it for free using Streamlit Community Cloud. By the end, you’ll have a live web app with a shareable URL.

### Tools you’ll use

- **Streamlit:** Builds interactive web apps using Python.
- **GitHub:** Stores and manages your application code in a repository.
- **Streamlit Community Cloud:** Deploys your GitHub repository as a live web app.

## 1\. Create a GitHub Repository

1. Go to [<u>GitHub</u>](https://github.com/) and sign in or create an account.
2. Click the **+** icon in the top-right corner and select **New repository**.
3. Name your repository **hello-streamlit**.
4. Set the repository visibility to **Public**.
5. Click **Create repository**.

## 2\. Add Your App Code ([app.py](http://app.py))

1. On your repository page, click **creating a new file** (in the Quick setup section).
2. Name the file [**app.py**](http://app.py)
3. Paste the following Python code:

```python
import streamlit as st
st.title("Hello, World!")
```

Click **Commit changes** to save the file to your repository.

### Understanding the code

- `import streamlit` tells Python to load the Streamlit package.
- `as st` gives that package the shorter name `st`.
- `st.title("Hello, World!")` displays a title in your web app.

## 3\. Add a Dependencies File (requirements.txt)

A **requirements.txt** file lists the Python packages your application needs. It helps Streamlit install the required dependencies during deployment.

1. In your repository, click **Add file → Create new file**.
2. Name the file **requirements.txt**
3. Add the following line:\
   `streamlit`

Click **Commit changes**.

*Dependencies are the packages your application needs to work.*

## 4\. Deploy on Streamlit Community Cloud

1. Go to [<u>Streamlit Community Cloud</u>](https://share.streamlit.io/) and sign in with your GitHub account.
2. Click **Create app.**
3. Select **Deploy a public app from GitHub**.
4. Configure your deployment settings:

- **Repository:** Select your repository, such as your **username/hello-streamlit**.
- **Branch:** main (or the branch containing your files).
- **Main file path:** [**app.py**](http://app.py)

Click **Deploy**.

Streamlit will build and launch your application. Once deployment is complete, you’ll receive a live URL that you can open in your browser and share with others.

Congratulations! You’ve built and deployed your first Streamlit web app using Python and GitHub.

---

This mini-guide was originally published on [**<u>PDF Python Hub</u>**](https://payhip.com/PDFPythonHub), where you can find more in-depth Python resources for working with PDFs.