Quickstart

This is a concise set of steps to create your Streamlit Community Cloud account, deploy a sample app, and start editing it with GitHub Codespaces. For other options and complete explanations, start with Create your account.

You will be signing in to your Google and GitHub accounts during this process. If you do not already have these accounts, you can create them before you begin. If you do not want to use a Google account, you can create your account with any email.

Sign up for Streamlit Community Cloud

1. Go to share.streamlit.io/signup.
2. Click "Continue with Google".

3. Enter your Google credentials and follow Google's authentication prompts.
4. After authenticating with Google, click "Connect GitHub account".

5. Enter your GitHub credentials and follow GitHub's authentication prompts.
6. Click "Authorize streamlit".

7. To finish, fill in your information and click "Continue" at the bottom of the screen.

8. You will be taken to your Streamlit workspace. If you see a warning icon (warning) next to "Settings" in the upper-right corner, this will be addressed in the next steps.

Create a new app with GitHub Codespaces

9. Click the down arrow (expand_more) to expand the options under "New App".

10. Click "Create new app with GitHub Codespaces".

11. You will be prompted that "Streamlit is requesting additional permissions". Click "Authorize streamlit".

12. The Streamlit Hello repository will be forked to your GitHub account. Fill in a repository name and click "Create!"

13. Click "Create new codespace" to confirm the creation of a codespace on your GitHub account. Read more about GitHub Codespaces the learn about monthly limits for free use and paid plans.

14. Wait for GitHub to set up your codespace.

15. GitHub will automatically execute the commands to launch your Streamlit app within your codespace. Your app will be visible in a "Simple Browser" on the right. This may take a minute to complete from when your codespace first appears on screen.

Edit your app in GitHub Codespaces

16. Go to the app's main file (Hello.py) and add some text to the title in st.write(). Try typing ":balloon:" at the beginning.

17. Files are automatically saved in your codespace with each edit. Click "Always rerun" in the upper-right corner of your app to automatically rerun with each edit.

18. See your edits and keep going!

Stop or delete your codespace

When you are done, remember to stop your codespace on GitHub to avoid any undesired use of your capacity.

19. Go to github.com/codespaces. At the bottom of the page, all your codespaces are listed. Click the overflow menu icon (more_horiz) for your codespace.

20. Click "Stop codespace" if you'd like to return to your work later. Otherwise, click "Delete."

    

    

21. Congratulations! You just deployed an app to Streamlit Community Cloud. 🎉 Head back to your workspace at share.streamlit.io/ and deploy another Streamlit app.

Previous: Get startedNext: Create your account

forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.