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.downloadAll("finance") — 전 종목 일괄 (pip install dartlab[hf]).
• 오프라인: dartlab.loadData("005930", refresh="local_only") — 네트워크 체크 생략.

2. 회사 전체 보기

c.sections   # topic × 기간 회사 지도
c.topics     # 어떤 topic 이 있나

3. 개별 topic 열기

c.show("businessOverview")   # 사업 개요 본문
c.show("companyOverview")    # 회사 개요

4. 재무제표

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

5. 변화 감지

c.diff()                    # 어떤 topic 이 가장 많이 바뀌었나
c.diff("businessOverview")  # 한 topic 깊이 보기

6. 미국 종목 — 같은 API

apple = dartlab.Company("AAPL")
apple.show("IS")
apple.show("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 — 구조화 보고서 생성.