Colab · Molab · 로컬 marimo 노트북

노트북 카탈로그

Colab 은 브라우저에서 바로 실행 (Google 계정). Molab 은 marimo 클라우드 (무료).

기능	설명	Colab	Molab
Company	Company("005930") — sections, show, trace, diff, 재무
Scan	scan() — 13 축 전 종목 횡단 스캔
Story	c.story() — 구조화 보고서 (AI 종합 의견은 dartlab.ask)
Gather	gather() — 주가 · 수급 · 거시 · 뉴스
Analysis	c.analysis() — 14 축 분석 · 인사이트 · 전망 · 밸류에이션
Ask (AI)	ask("...") — 자연어 LLM 분석

로컬 marimo 실행

uv run marimo edit notebooks/marimo/01_company.py

같은 코드 (notebooks/marimo/{name}.py) 가 Molab 클라우드에서도 동작한다.

Colab (.ipynb) 과 marimo (.py) 는 1:1 대응 — 같은 분석을 두 노트북 형식으로 유지한다. 한쪽만 갱신 금지.

노트북 작성 규칙

Colab — 마크다운 허용

• 학습·공유용 독자가 맥락을 빠르게 잡게 마크다운 셀로 섹션 설명.
• 3~4 코드 셀마다 1 마크다운. 너무 잦으면 흐름 끊고, 너무 드물면 맥락 사라진다.
• 노트북 최상단 1 장: 제목 + 한 줄 요약 + “이 노트북에서 다루는 것” 2~3 줄.
• 주요 섹션 전환점에만 1 장씩.

marimo — 코드 + 짧은 주석

• 실습·실행용. 설명은 코드 옆 짧은 주석으로.
• 첫 줄 한글 주석으로 셀 의도 표시.
• 마크다운 셀 자제 — reactive 모델은 코드 흐름이 본체다.

공통 규칙

• 같은 분석은 같은 코드·같은 순서로 두 노트북에 동기화.
• 셀 순서에 의존하는 비결정 코드 금지 (marimo 가 reactive 라 의도와 다른 결과 낳는다).
• 큰 데이터 셋 (Company 3 개 이상 동시 로드) 금지 — OOM 위험.

다음 단계

• start.installUv — 로컬 dartlab 설치.
• start.quickStart — 8 단계 walkthrough.
• engines.company — Company 엔진 메서드 카탈로그.