Dash no Spaces

Com o Dash Open Source, você pode criar aplicativos de dados no seu laptop em Python puro, sem necessidade de JavaScript.

Conheça o Dash construindo um aplicativo de exemplo com código aberto. Escale com o Dash Enterprise quando seu aplicativo Dash estiver pronto para consumo em nível de departamento ou empresa. Ou, inicie sua iniciativa com o Dash Enterprise desde o início para desbloquear ganhos de produtividade para desenvolvedores e aceleração prática da equipe da Plotly.

Implante o Dash nos Spaces

Para começar a usar o Dash no Spaces, clique no botão abaixo:

Isso iniciará a construção do seu Space usando o template Docker do Dash do Plotly. Se tiver sucesso, você deve ver uma aplicação semelhante ao aplicativo do template Dash.

Personalizando seu aplicativo Dash

Se você nunca construiu com o Dash antes, recomendamos começar com nosso tutorial Dash em 20 minutos.

Ao criar um Dash Space, você receberá alguns arquivos essenciais para começar:

1. app.py

Este é o arquivo principal do aplicativo que define a lógica central do seu projeto. Aplicativos Dash são frequentemente estruturados como módulos, e você pode opcionalmente separar seu layout, callbacks e dados em outros arquivos, como layout.py, etc.

Dentro de app.py você verá:

1. from dash import Dash, html Importamos o objeto Dash para definir nosso aplicativo e a biblioteca html, que nos fornece os blocos de construção para montar nosso projeto.

2. app = Dash() Aqui, definimos nosso aplicativo. Layout, servidor e callbacks são vinculados ao objeto app.

3. server = app.server Aqui, definimos a variável do servidor, que é usada para executar o aplicativo em produção.

4. app.layout = O layout do aplicativo inicial é definido como uma lista de componentes Dash, um componente Dash individual ou uma função que retorna um desses.

   O app.layout é o seu layout inicial, que será atualizado como uma aplicação de página única por callbacks e outras lógicas do seu projeto.

5. if __name__ == '__main__': app.run(debug=True) Se você estiver executando seu projeto localmente com python app.py, app.run(...) será executado e iniciará um servidor de desenvolvimento para trabalhar no seu projeto, com recursos que incluem recarga automática, o grafo de callbacks e muito mais.

   Em produção, recomendamos gunicorn, que é um servidor de nível de produção. Os recursos de depuração não serão habilitados ao executar seu projeto com gunicorn, portanto, esta linha nunca será alcançada.

2. Dockerfile

O Dockerfile para um aplicativo Dash é minimalista, pois o Dash possui poucas dependências de sistema. Os requisitos principais são:

• Ele instala as dependências listadas em requirements.txt (usando uv)
• Ele cria um usuário não root para segurança
• Ele executa o aplicativo com gunicorn usando gunicorn app:server --workers 4

Você pode precisar modificar este arquivo se o seu aplicativo exigir dependências de sistema adicionais, permissões ou outras flags de CLI.

3. requirements.txt

O Space instalará automaticamente as dependências listadas no arquivo requirements.txt. No mínimo, você deve incluir dash e gunicorn neste arquivo. Você deve adicionar quaisquer outros pacotes necessários para o seu aplicativo.

O template Dash Space fornece uma configuração básica que você pode estender com base nas suas necessidades.

Recursos e Suporte Adicionais

• Documentação do Dash
• Repositório do Dash no GitHub
• Fóruns da Comunidade Dash
• Dash Enterprise
• Espaço do modelo Dash

Solução de problemas

Se você encontrar problemas:

1. Certifique-se de que seu notebook é executado localmente no modo de aplicativo usando python app.py
2. Verifique se todos os pacotes necessários estão listados em requirements.txt
3. Verifique se a configuração da porta corresponde (7860 é o padrão para Spaces)
4. Verifique os logs do Space em busca de erros do Python

Para mais ajuda, visite os Fóruns da Comunidade Plotly ou abra uma issue.

Update on GitHub