2. Установка и настройка рабочей среды
2.1. Установка Streamlit
Требования к окружению
Для успешной работы с библиотекой Streamlit необходимы следующие условия:
-
Версия Python: от 3.7 и выше. Рекомендуется использовать актуальные версии (Python 3.10 или 3.11) для лучшей производительности и совместимости.
-
Пакетный менеджер pip: дистрибутивы Python обычно включают утилиту
pip
, необходимую для установки библиотек. Если по каким-то причинамpip
отсутствует или не обновлён, рекомендуется обновить его командой:python -m pip install --upgrade pip
Базовая установка Streamlit
Установка Streamlit осуществляется одной простой командой:
pip install streamlit
После выполнения данной команды в текущем окружении будет доступен исполняемый модуль streamlit
. Успешность установки можно проверить, выполнив:
streamlit --version
В ответ вы получите номер установленной версии Streamlit.
Работа с виртуальными окружениями (venv, conda)
В целях лучшей управляемости зависимостями и предотвращения конфликтов с системными пакетами, настоятельно рекомендуется использовать виртуальные окружения. Это также позволяет параллельно работать над несколькими проектами, не нарушая целостность общего окружения.
-
venv (стандартный модуль Python): Создание окружения:
python -m venv venv
Активация окружения (Windows):
venv\Scripts\activate
(Linux/macOS):
source venv/bin/activate
После активации можно устанавливать Streamlit командой
pip install streamlit
уже внутри данного окружения. -
conda (Anaconda/Miniconda): Создание окружения с конкретной версией Python:
conda create --name myenv python=3.10
Активация окружения:
conda activate myenv
Далее установка Streamlit:
pip install streamlit
Использование виртуальных окружений гарантирует изоляцию пакетов и упрощает переносимость проекта.
Полезные ссылки:
- Официальная документация по установке Streamlit
- Документация по модулю venv (официальный Python Docs)
- Документация по Conda
2.2. Структура приложения
Приложения на Streamlit отличаются простотой в том, что они представляют собой обычные Python-скрипты без необходимости дополнительного каркаса (каркасных директорий, HTML-шаблонов и прочих атрибутов, характерных для классической веб-разработки).
Обычный .py файл с кодом
Простое приложение на Streamlit может состоять всего из одного .py
файла, например app.py
. Содержимое файла может быть следующим:
import streamlit as st
st.title("Мой первый Streamlit-приложение")
st.write("Добро пожаловать! Это пример простейшего приложения.")
Данный код — полностью функциональный пример. Streamlit автоматически возьмёт его и сгенерирует веб-интерфейс.
Запуск приложения
Запуск приложения осуществляется командой:
streamlit run app.py
По умолчанию будет запущен локальный веб-сервер (обычно по адресу http://localhost:8501), и вы сможете взаимодействовать с приложением через браузер.
Горячая перезагрузка при изменении кода
Одним из ключевых преимуществ Streamlit является автоматическая перезагрузка. Если вы внесёте изменения в код app.py
и сохраните его, приложение обновится практически мгновенно. Это ускоряет итеративную разработку и позволяет немедленно видеть результаты внесённых изменений.
Пример типичного сценария разработки:
- Запустить приложение командой
streamlit run app.py
. - Внести изменения в код — добавить новый заголовок или интерактивный элемент.
- Сохранить файл
app.py
(приложение автоматически обновится в браузере).
Данный процесс напоминает работу в интерактивном блокноте, но с преимуществом полноценного веб-приложения, доступного локально или в сети.
Полезные ссылки: