Python과 가상환경

Python 버전 요구사항

marimo는 Python 3.11 이상에서 동작합니다. 공식 예제와 Docker 이미지는 3.11-slim 기준입니다. 이 책의 예제는 Python 3.11 이상이면 실행되며, 사용 중인 버전이 3.11 이상인지만 확인하면 됩니다.

설치된 Python 버전을 확인합니다.

python --version# 또는python3 --version

3.11 미만이라면 python.org 또는 운영체제 패키지 관리자를 통해 최신 버전을 설치합니다.

왜 가상환경인가

가상환경이 없으면 설치한 패키지가 시스템 Python 전체에 영향을 줍니다. 프로젝트 A가 라이브러리 버전 1.0을 요구하고, 프로젝트 B가 2.0을 요구하면 둘을 동시에 사용할 수 없습니다. 가상환경은 프로젝트마다 독립된 패키지 공간을 만들어 이 문제를 해결합니다.

marimo 자체도 0.x 시리즈여서 버전 간 API 변경이 있습니다. 프로젝트별로 가상환경을 분리하면 버전 충돌 없이 여러 프로젝트를 관리할 수 있습니다.

uv 설치

uv는 Rust로 작성한 Python 패키지 관리자입니다. pip보다 빠르고 가상환경 생성과 패키지 설치를 하나의 도구로 처리합니다. 이 책에서 권장하는 방식입니다.

uv를 처음 설치합니다.

# macOS / Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh# Windows PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

설치 후 터미널을 다시 열거나 아래 명령으로 환경 변수를 적용합니다.

source ~/.local/bin/env   # macOS / Linux (설치 스크립트가 안내하는 경로 사용)

설치 확인은 다음과 같이 합니다.

uv --version

uv로 가상환경 만들기

프로젝트 디렉터리를 만들고 가상환경을 생성합니다.

mkdir my-marimo-projectcd my-marimo-project# .venv 디렉터리에 가상환경 생성uv venv

가상환경을 활성화합니다.

# macOS / Linuxsource .venv/bin/activate# Windows (Command Prompt).venv\Scripts\activate# Windows (PowerShell).venv\Scripts\Activate.ps1

활성화되면 프롬프트 앞에 (.venv)가 표시됩니다.

(.venv) $

pip로 가상환경 만들기

uv를 사용하지 않는다면 Python 표준 도구 venv를 사용합니다.

python -m venv .venv# macOS / Linuxsource .venv/bin/activate# Windows (Command Prompt).venv\Scripts\activate

이후 패키지 설치는 pip install 명령으로 진행합니다.

가상환경 비활성화

작업이 끝나면 가상환경을 비활성화합니다.

deactivate

다음 챕터에서는 활성화된 가상환경 안에 marimo를 설치합니다.