Deploy com Streamlit Cloud: Guia para Iniciantes

Se você está começando a explorar o mundo da programação e deseja criar web apps simples e interativos, o Streamlit é uma ferramenta poderosa e fácil de usar. Além disso, com o Streamlit Cloud, você pode fazer o deploy dos seus apps de forma gratuita e rápida. Neste guia, vamos te mostrar, passo a passo, como realizar esse processo. Primeiramente, abordaremos a preparação do ambiente, e em seguida, iremos ao compartilhamento do seu app com o mundo.

Introdução ao Streamlit Cloud

O Streamlit Cloud é uma plataforma que permite que você hospede seus aplicativos Streamlit na nuvem com apenas um clique. Isso significa que você pode compartilhar suas criações com qualquer pessoa, sem precisar se preocupar com a infraestrutura de servidores. Além disso, o Streamlit Cloud é gratuito, o que o torna uma excelente opção para quem está começando.

O que é o Streamlit Cloud?

O Streamlit Cloud é uma plataforma que permite hospedar aplicativos desenvolvidos com a biblioteca Streamlit na nuvem de forma simples e rápida. Com apenas um clique, você pode compartilhar suas criações sem se preocupar com a infraestrutura de servidores. Além disso, o Streamlit Cloud é gratuito, tornando-se uma excelente opção para iniciantes que desejam distribuir seus dashboards e aplicativos de dados de maneira eficiente e acessível.

Vantagens de usar o Streamlit Cloud

Utilizar o Streamlit Cloud traz diversas vantagens. Primeiramente, ele é gratuito, o que é ótimo para quem está começando e não quer investir em hospedagem paga. Além disso, o processo de deploy é extremamente simples e rápido, permitindo que você compartilhe suas criações em minutos. Outra vantagem é a integração direta com o GitHub, facilitando a gestão do código e das dependências do seu projeto.

Preparando seu Ambiente

Antes de fazer o deploy do seu app no Streamlit Cloud, é necessário preparar o ambiente de desenvolvimento. Isso inclui a instalação do Streamlit e a criação do seu primeiro app.

Instalando o Streamlit

Para instalar o Streamlit, você pode usar o pip, o gerenciador de pacotes do Python. Basta abrir o terminal e executar o seguinte comando:

pip install streamlit

Criando seu primeiro app em Streamlit

Vamos começar criando um app simples que exibe a mensagem “Hello World”. Crie um arquivo chamado streamlit_app.py e adicione o seguinte código:

import streamlit as st

st.write('Hello World!')

Para executar o app, basta rodar o comando abaixo no terminal:

streamlit run streamlit_app.py

Configurando sua Conta no Streamlit Cloud

Agora que você já tem um app básico, é hora de configurar sua conta no Streamlit Cloud e conectá-la ao GitHub.

Como criar uma conta no Streamlit Cloud

Acesse o Streamlit Cloud e clique em “Sign up” para criar uma conta gratuita. Você pode usar sua conta do Google, GitHub ou um e-mail.

Conectando sua conta ao GitHub

Após criar sua conta, você precisará conectá-la ao GitHub. Isso pode ser feito de duas maneiras:

1. Clique em “New app” e autorize o Streamlit a acessar sua conta do GitHub.
2. Vá em “Settings”, depois em “Linked accounts” e clique em “Allow access”.

Preparando seu Projeto para Deploy

Para garantir que seu app funcione corretamente no Streamlit Cloud, é importante organizar seu projeto de forma adequada.

Estrutura de diretórios recomendada

A estrutura do seu repositório no GitHub deve ser semelhante a esta:

your-repository/
├── streamlit_app.py
└── requirements.txt

Criando e configurando o arquivo requirements.txt

O arquivo requirements.txt deve listar todas as dependências do seu projeto. Por exemplo:

streamlit
pandas
numpy

Adicionando arquivos de configuração e temas

Se você quiser personalizar a aparência do seu app, pode adicionar um arquivo de configuração chamado config.toml dentro de um diretório .streamlit:

your-repository/
├── .streamlit/
│   └── config.toml
├── streamlit_app.py
└── requirements.txt

Deploy do seu App no Streamlit Cloud

Agora que seu projeto está pronto, vamos fazer o deploy no Streamlit Cloud.

Passo a passo para fazer o deploy

1. Adicione seu app ao GitHub.
2. No Streamlit Cloud, clique em “New app”.
3. Preencha as informações do repositório, branch e caminho do arquivo.
4. Clique em “Deploy”.

Acompanhando o processo de deploy

Você pode acompanhar o processo de deploy em tempo real. O Streamlit Cloud exibirá logs que ajudam a identificar e resolver possíveis problemas.

Compartilhando seu App

Depois de fazer o deploy, é hora de compartilhar seu app com o mundo.

Como obter e personalizar a URL do seu app

O Streamlit Cloud gera uma URL única para o seu app, a qual você pode personalizar. Para realizar essa personalização, acesse as configurações do app e, em seguida, escolha um subdomínio personalizado.

Tornando seu app público ou privado

Você pode definir se seu app será público ou privado nas configurações do app. Lembre-se de que apenas um app privado é permitido por vez.

Adicionando um badge do Streamlit ao seu repositório GitHub

Para facilitar o acesso ao seu app, você pode adicionar um badge ao seu repositório GitHub. Basta incluir o seguinte código no seu README.md:

[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://<your-custom-subdomain>.streamlit.app)

Gerenciando e Atualizando seu App

Manter seu app atualizado é essencial para garantir seu bom funcionamento.

Como editar seu app com GitHub Codespaces

O GitHub Codespaces permite que você edite seu app diretamente no navegador, facilitando a manutenção e atualização do código.

Atualizando seu app e lidando com dependências

Sempre que você fizer alterações no código ou nas dependências, basta fazer um push para o GitHub que o Streamlit Cloud atualizará seu app automaticamente.

Monitorando logs e debugando problemas

Os logs do Streamlit Cloud são uma ferramenta valiosa para identificar e resolver problemas. Acesse-os diretamente no painel do Streamlit Cloud.

Perguntas Frequentes (FAQ)

O que é deploy?

Deploy é o processo de colocar um aplicativo em um ambiente onde ele pode ser acessado e utilizado por outras pessoas. Isso envolve expor a aplicação na internet, permitindo que qualquer pessoa, de qualquer lugar do mundo, possa acessá-la através de um link público. No caso do Streamlit Cloud, por exemplo, o deploy significa hospedar seu aplicativo na nuvem, facilitando o acesso e a utilização por meio de um link compartilhável.

Como criar um arquivo requirements.txt detalhado?

Para criar um arquivo requirements.txt detalhado, você deve listar todas as bibliotecas que seu projeto utiliza, incluindo suas versões específicas, se necessário. Por exemplo:

streamlit==1.3.0
pandas==1.3.3
numpy==1.21.2

Onde posso encontrar mais tutoriais sobre Streamlit e GitHub?

Você pode encontrar mais tutoriais sobre Streamlit e GitHub nos seguintes links:

• Documentação do Streamlit
• Tutoriais do GitHub

Conclusão

Neste guia, você aprendeu como fazer o deploy de um app Streamlit no Streamlit Cloud. Primeiramente, abordamos a preparação do ambiente, e em seguida, passamos pelo processo de compartilhamento do app. O Streamlit Cloud, além disso, é uma ferramenta poderosa e gratuita que, por fim, facilita tanto a criação quanto a distribuição de web apps interativos.

Se você gostou deste conteúdo e quer aprender mais sobre desenvolvimento de apps com Python, confira nossos outros tutoriais e cursos na Asimov Academy. Continue explorando e aprimorando suas habilidades!

Referências

• Deploy your app – Streamlit Docs
• Host your Streamlit app for free
• Share your app – Streamlit Docs