iBetter Books
수정

더 배우기 _ 커뮤니티와 다음 단계

이 책은 marimo의 전부를 다루지 않았습니다. 반응형 실행의 원리, UI 위젯, SQL 데이터 처리, 배포, 운영까지 실용적으로 필요한 핵심을 다뤘지만, 그 너머에는 더 많은 것이 있습니다. 이 챕터는 그 다음을 향한 문을 안내합니다.

공식 자료

공식 문서

marimo의 API 레퍼런스와 가이드는 공식 문서에서 관리됩니다.

https://docs.marimo.io

이 책에서 다룬 mo.ui, mo.sql, mo.cache, marimo check, marimo export 등의 최신 동작은 공식 문서가 항상 우선합니다. 새 버전이 나오면 문서도 함께 업데이트됩니다.

예제 갤러리

marimo 팀이 직접 작성하거나 커뮤니티에서 제출한 예제 노트북 모음입니다.

https://marimo.io/gallery

데이터 시각화, ML 실험, 교육용 노트북, 인터랙티브 시뮬레이션 등 다양한 용도의 예제가 있습니다. 코드를 직접 열어볼 수 있어서, 이 책의 예제를 넘어서는 패턴을 빠르게 습득하는 데 유용합니다.

추가 예제는 공식 문서의 예제 섹션에서도 찾을 수 있습니다.

https://docs.marimo.io/examples/

GitHub 저장소

marimo 소스 코드와 이슈 트래커입니다.

https://github.com/marimo-team/marimo

새 기능 제안, 버그 보고, 릴리스 노트 확인 모두 이 저장소에서 이루어집니다. Discussions 탭에서 사용 관련 질문을 올리거나 다른 사람의 경험을 찾아볼 수 있습니다.

https://github.com/marimo-team/marimo/discussions

커뮤니티 Discord

marimo 팀과 사용자들이 실시간으로 소통하는 공간입니다.

https://marimo.io/discord

사용 중 막히는 부분을 물어보거나, 새 기능에 대한 피드백을 나누거나, 다른 사람이 만든 노트북에서 아이디어를 얻을 수 있습니다.

YouTube 채널

marimo 팀이 운영하는 YouTube 채널에는 튜토리얼 영상과 기능 소개 영상이 올라옵니다.

https://www.youtube.com/@marimo-team

문서를 읽는 것보다 영상으로 먼저 흐름을 파악하는 것이 편한 경우 유용합니다.

이 책 이후에 탐색할 주제

이 책에서 다루지 않았거나 일부만 다룬 주제 중, 실무에서 가치 있는 것들을 정리합니다.

고급 레이아웃

이 책에서는 mo.hstack, mo.vstack, mo.tabs 정도를 다뤘습니다. marimo는 그리드 레이아웃, 반응형 컬럼 구성, 커스텀 CSS 적용 등 더 세밀한 레이아웃 옵션을 제공합니다. 복잡한 대시보드를 만들 때 필요합니다.

anywidget 커스텀 위젯 심화

PART 03에서 anywidget으로 커스텀 위젯을 통합하는 기초를 다뤘습니다. anywidget은 JavaScript와 Python을 양방향으로 연결하는 프레임워크입니다. 기존 npm 생태계의 시각화 라이브러리를 marimo 위젯으로 만들거나, 완전히 새로운 인터랙션을 설계하는 것이 가능합니다.

대규모 데이터 처리

이 책의 예제는 메모리에 올릴 수 있는 규모를 전제로 했습니다. 파일 크기가 수 GB를 넘거나, 원격 데이터베이스와 실시간으로 연결해야 하는 상황에서는 DuckDB의 스트리밍 쿼리, Polars의 lazy 평가, 원격 Parquet 파일 직접 쿼리 같은 방법을 함께 다뤄야 합니다. DuckDB가 marimo SQL 셀의 백엔드이므로, DuckDB 자체를 더 깊이 익히는 것이 직접적인 도움이 됩니다.

실시간 데이터 스트리밍

marimo run으로 배포된 앱에서 주기적으로 데이터를 갱신하거나, 외부 이벤트에 반응하는 방식으로 셀을 트리거하는 패턴이 있습니다. marimo의 반응형 실행과 Python 비동기 처리를 조합하는 영역입니다.

테스트 자동화 확장

PART 10 Ch 04에서 노트북의 순수 함수를 분리해 pytest로 테스트하는 방법을 다뤘습니다. 더 나아가 노트북 실행 자체를 자동화하고 출력 스냅샷을 비교하는 방법, marimo의 앱 모드를 헤드리스로 실행해 엔드투엔드 테스트를 구성하는 방법도 탐색할 수 있습니다.

실전 적용을 권장하는 이유

배운 것을 실제 문제에 적용해보지 않으면 기억에 남지 않습니다. 지금 갖고 있는 Jupyter 노트북 하나를 marimo로 옮겨보거나, 반복해서 실행하는 데이터 정리 스크립트를 marimo 노트북으로 만들어보는 것이 가장 빠른 다음 단계입니다.

작은 것부터 시작하는 것이 좋습니다. 복잡한 대시보드보다 슬라이더 하나 달린 단순한 탐색 노트북이 먼저입니다. 그 노트북이 완성됐을 때의 경험이 다음 프로젝트의 기준점이 됩니다.

막히는 곳이 생기면 공식 문서와 커뮤니티를 활용하세요. 이 책의 GitHub 저장소도 열려 있습니다.

https://github.com/sung2ne/textbook-marimo

정리

  • 공식 문서(docs.marimo.io)는 API의 현재 상태를 반영하며, 이 책보다 항상 우선합니다.
  • 예제 갤러리(marimo.io/gallery)와 공식 문서 예제(docs.marimo.io/examples/)에서 실전 패턴을 찾을 수 있습니다.
  • GitHub Discussions와 Discord를 통해 커뮤니티와 연결될 수 있습니다.
  • 다음 학습 주제로는 고급 레이아웃, anywidget 심화, 대규모 데이터 처리, 실시간 스트리밍, 테스트 자동화 확장이 있습니다.
  • 가장 중요한 다음 단계는 실제 문제에 marimo를 적용해보는 것입니다.