[오픈소스 사용법] Qlib — 마이크로소프트의 AI 퀀트 연구 플랫폼으로 모델 학습부터 백테스트까지
· 바이브코드 운영팀
Qlib은 마이크로소프트가 만든 AI 퀀트 투자 연구 플랫폼이에요. 시장 데이터를 처리하고, 머신러닝 모델을 학습하고, 그 모델로 만든 전략을 과거 데이터로 시험(백테스트)하는 전 과정을 한 틀에서 돌려 볼 수 있어요. README는 알파(초과 수익) 탐색, 위험 모델링, 포트폴리오 최적화, 주문 집행까지 퀀트 투자의 전체 흐름을 다룬다고 소개해요.
출처: microsoft/qlib README의 프레임워크 그림 (그림 속 글자는 영어예요)
이럴 때 쓰세요
- 머신러닝으로 주가 예측 모델을 만들어 보고 싶을 때
- 모델 여러 개를 같은 조건에서 비교하고 백테스트로 결과를 보고 싶을 때
- 퀀트 연구 논문의 모델(LightGBM, Transformer 등)을 직접 돌려 보고 싶을 때
데이터, 학습, 전략, 평가 부품이 서로 느슨하게 이어져 있어서 필요한 부분만 따로 쓸 수 있다고 README가 설명해요.
준비물
- Python과
pip - 데이터를 내려받을 디스크 공간과 여유 시간
- 이 글은 설치와 예제 실행까지만 다뤄요. 퀀트 투자나 머신러닝 지식이 있으면 결과를 해석하기 쉬워요.
설치
PyPI 패키지 이름은 pyqlib이에요. 저장소 이름과 달라서 헷갈리기 쉬워요.
pip install pyqlib
소스를 받아 설치하려면 이렇게 해요.
git clone https://github.com/microsoft/qlib.git && cd qlib
pip install .
처음 실행해 보기
1. 데이터 내려받기. 공식 예시는 중국 시장(cn) 일봉 데이터예요. 내 컴퓨터의 ~/.qlib/qlib_data/cn_data에 저장돼요.
python -m qlib.cli.data qlib_data --target_dir ~/.qlib/qlib_data/cn_data --region cn
1분봉 데이터는 --interval 1min을 붙여 따로 받아요.
python -m qlib.cli.data qlib_data --target_dir ~/.qlib/qlib_data/cn_data_1min --region cn --interval 1min
2. 모델 돌리기. 저장소의 examples 폴더에서 qrun 명령으로 설정 파일 하나를 실행해요. 설정 파일 하나에 데이터, 모델, 전략, 백테스트가 모두 적혀 있어서 한 줄로 처음부터 끝까지 돌아가요. 아래는 LightGBM 모델에 Alpha158 지표를 쓰는 예제예요.
cd examples
qrun benchmarks/LightGBM/workflow_config_lightgbm_Alpha158.yaml
실행이 끝나면 모델 점수로 종목을 고르는 전략의 백테스트 결과가 나와요. benchmarks 폴더 아래의 다른 설정 파일로 바꿔 다른 모델도 같은 방식으로 돌려 볼 수 있어요.
AI에게 맡겨 보기
README에는 마이크로소프트가 만든 RD-Agent도 소개돼 있어요. 퀀트 요인(factor) 발굴과 모델 개선을 LLM 에이전트가 자동으로 하는 별도 프로젝트예요. 설치와 사용은 RD-Agent 저장소에서 확인하세요.
관련 영상
I Spent Months on Qlib in 2025. Claude Did It in Hours in 2026. (Scooby Doo 채널, 영어) — Claude에게 GitHub 코드스페이스에서 Qlib 설치와 샘플 데이터 백테스트를 맡기는 과정을 보여 줘요. 이어서 RD-Agent를 설치하고 요인 탐색을 시험해요.
알아둘 점
- README 맨 위에 아직 정식 릴리스되지 않은 변경이 적혀 있어요. 소스에서 설치한 최신 코드는 저장된 모델이나 데이터셋을 다시 불러올 때 기본으로 막아 두고, 작성자와 저장소 권한을 확인한 뒤
trusted=True(명령줄은--trusted=True)를 직접 켜야 해요. 새로 학습한 결과를 메모리에서 바로 쓰거나 데이터만 읽을 때는 필요 없어요. 정식 릴리스 전까지는 PyPI 버전과 소스 버전이 다르게 동작할 수 있어서, 읽은 문서와 설치한 버전이 같은지 확인하세요. - 데이터를 내려받는 데 시간이 걸려요. 첫 실행은 여유를 두고 시작하세요.
- 공식 예시 데이터는 중국 시장이에요. 다른 시장 데이터를 쓰려면 Qlib 형식으로 직접 만들어 넣어야 해요.
투자 안내
이 글은 도구 사용법을 소개하는 글이고 특정 종목이나 투자 방법을 권하는 글이 아니에요. 백테스트 결과는 과거 데이터에서 나온 값이라 앞으로의 수익을 보장하지 않아요. 투자 판단과 그 결과는 본인의 몫이에요.
더 보기
- 바이브코드 도구 상세: Qlib
- 저장소: microsoft/qlib
- RD-Agent: microsoft/RD-Agent
확인한 날짜 2026-11-18 · 라이선스 MIT · 별 약 5만 개
글이 도움이 되었다면 좋아요를 눌러 주세요.