DartLab 8 단계 빠른 시작

DartLab 은 세 가지를 한다 — Company (한 회사 깊게), Scan (시장 횡단), Ask (AI 분석).

0. 설치

uv add dartlab

1. Company — 아무 회사나 읽기

import dartlab

c = dartlab.Company("005930")  # 삼성전자

데이터는 첫 호출 시 자동 다운로드. 별도 셋업 없음.

신선도

• 첫 사용: HuggingFace 에서 자동 다운로드 (종목당 수 MB).
• 이후: 24 시간마다 HF 갱신 자동 확인 (HTTP HEAD, 비용 거의 0).
• 오프라인: dartlab.loadData("005930", refresh="local_only") — 네트워크 체크 생략.

2. 회사 전체 보기

c.panel          # 항목 x 기간 wide 격자 그 자체 (pl.DataFrame)
c.panel.shape    # (항목 수, 기간 열 수)

3. 개별 topic 열기

정식 topic 은 IS · BS · CF · CIS · SCE · ratios 다. 주석 본문은 섹션명으로 검색한다.

c.panel("재고")     # 섹션명·canonicalKey 행 검색 (주석 본문)

4. 재무제표

c.panel("IS")       # 손익계산서
c.panel("BS")       # 재무상태표
c.panel("CF")       # 현금흐름표
c.panel("ratios")   # 47 개 재무비율

5. 값의 출처 되짚기

c.trace("IS")   # 손익 데이터가 어느 출처(panel/finance/report)에서 왔나

6. 미국 종목 — 같은 API

apple = dartlab.Company("AAPL")
apple.panel("IS")
apple.panel("10-K::item1ARiskFactors")

7. 시장 횡단 (Scan)

dartlab.search("삼성전자")              # 회사 검색
dartlab.scan("ratio", "roe")           # 전 상장 ROE
dartlab.scan("account", "매출액")       # 전 상장 매출

8. AI 분석 (Ask)

uv add "dartlab[llm]"

dartlab.ask("삼성전자 재무 건강도 분석")

provider (OpenAI · Ollama · ChatGPT OAuth) 가 필요하다. dartlab setup 으로 옵션 확인.

실습 노트북

같은 코드를 Colab · Molab · 로컬 marimo 세 경로로 돌려볼 수 있다 → runtime.notebooks.

다음 단계

• start.dartlabSkillOs — Skill OS 카탈로그 첫 진입.
• engines.company — Company 엔진 전체 메서드.
• engines.scan — 시장 횡단 19 축.
• engines.story — 구조화 보고서 생성.