marimo와 함께 uv 사용하기

marimo는 재현성과 전통적인 소프트웨어 개발 방식을 결합한 대화형 Python 노트북입니다. marimo 노트북은 Python 스크립트로 저장되므로 uv와 원활하게 통합됩니다.

독립 실행형 도구로 marimo 사용하기

프로젝트 설정 없이 격리된 환경에서 marimo 노트북에 접근하려면 다음을 사용합니다:

$ uvx marimo edit

특정 노트북을 실행합니다:

$ uvx marimo edit my_notebook.py

인라인 스크립트 메타데이터와 함께 marimo 사용하기

marimo 노트북은 uv의 스크립트 메타데이터 지원을 사용하여 자체 의존성을 선언할 수 있습니다. 다음과 같이 의존성을 추가합니다:

$ uv add --script my_notebook.py numpy

격리된 샌드박스에서 의존성과 함께 노트북을 편집합니다:

$ uvx marimo edit --sandbox my_notebook.py

marimo는 자동으로 uv를 사용하여 스크립트의 의존성이 포함된 격리된 가상환경에서 노트북을 시작합니다. marimo UI를 통해 설치된 패키지는 자동으로 노트북의 메타데이터에 추가됩니다.

이러한 노트북을 일반 Python 스크립트로 실행합니다:

$ uv run my_notebook.py

프로젝트 내에서 marimo 사용하기

marimo가 의존성으로 포함된 프로젝트 내에서는 다음을 사용합니다:

$ uv run marimo edit my_notebook.py

uv add를 사용하거나 marimo UI를 통해 추가 패키지를 추가할 수 있으며, UI는 자동으로 uv add를 호출합니다.

marimo가 의존성으로 나열되어 있지 않은 경우:

$ uv run --with marimo marimo edit my_notebook.py

이 방법은 프로젝트 모듈에 대한 접근을 제공하지만, marimo UI를 통해 설치된 패키지는 프로젝트 설정에 저장되지 않습니다.

비프로젝트 환경에서 marimo 사용하기

독립 실행형 가상환경을 생성합니다:

$ uv venv
$ uv pip install numpy
$ uv pip install marimo
$ uv run marimo edit

marimo의 설치 관리자는 uv pip install 명령을 사용하여 패키지를 추가합니다.

marimo 노트북을 스크립트로 실행하기

의존성 관리 방식에 관계없이 노트북을 Python 스크립트로 실행합니다:

$ uv run my_notebook.py

이 명령은 대화형 브라우저 세션을 실행하지 않고 노트북을 실행합니다.

원문(영어): https://docs.astral.sh/uv/guides/integration/marimo/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

원문(영어): https://docs.astral.sh/uv/guides/integration/marimo/