make-quant-py/README.md

콴트 매니저 (Quant Manager)

한국 주식 시장을 위한 퀀트 투자 도구입니다.

프로젝트 구조

make-quant-py/
├── data/                     # 데이터 수집 관련 코드
│   ├── krx.py                # 한국거래소 데이터 수집
│   ├── prices.py             # 가격 데이터 수집
│   ├── financial.py          # 재무제표 데이터 수집
│   └── crawling.py           # 웹 크롤링 유틸리티
├── db/                       # 데이터베이스 유틸리티
│   └── common.py             # DB 연결 및 쿼리 공통 기능
├── strategies/               # 전략 구현
│   ├── factors/              # 개별 요소 모듈
│   │   ├── value.py          # 가치 전략
│   │   ├── quality.py        # 퀄리티 전략
│   │   ├── momentum.py       # 모멘텀 전략
│   │   ├── f_score.py        # F-Score 전략
│   │   └── all_value.py      # 종합 가치 전략
│   ├── composite/            # 복합 전략 구현
│   │   ├── magic_formula.py  # 마법공식 전략
│   │   ├── multi_factor.py   # 멀티팩터 전략
│   │   ├── super_quality.py  # 슈퍼 퀄리티 전략
│   │   └── super_value_momentum.py # 슈퍼 밸류 모멘텀 전략
│   └── utils.py              # 전략 공통 유틸리티
├── backtest/                 # 백테스트 도구
│   └── engine.py             # 백테스트 구현
└── streamlit/                # Streamlit 웹 앱
    ├── app.py                # 메인 앱
    ├── pages/                # 개별 페이지
    │   ├── data_page.py      # 데이터 수집 페이지
    │   ├── quality_page.py   # 슈퍼 퀄리티 전략 페이지
    │   └── value_momentum_page.py # 밸류 모멘텀 전략 페이지
    └── components/           # 재사용 가능한 UI 컴포넌트
        └── charts.py         # 시각화 컴포넌트

설치 및 설정

필수 요구사항

• Python 3.8 이상
• MySQL 또는 MariaDB

Windows에서 필요한 빌드 도구:

• Visual Studio Build Tools 2017 이상
  • Desktop development with C++ 워크로드 선택
  • (선택사항) Python development 워크로드 선택

가상환경 설정

가상환경 생성:

python -m venv .venv

가상환경 활성화:

• Windows: .venv\Scripts\activate
• Linux/Mac: . .venv/bin/activate

패키지 설치:

pip install -r requirements.txt

가상환경 종료:

deactivate

환경 변수 설정

프로젝트 루트에 .env 파일을 생성하고 다음 환경 변수를 설정하세요:

DB_USER=your_db_user
DB_PW=your_db_password
DB_HOST=localhost
DB_PORT=3306
DB_DB=your_db_name

실행 방법

Streamlit 앱 실행:

streamlit run src/app.py --server.port=20000

인증 설정

애플리케이션은 streamlit-authenticator를 사용하여 로그인 기능을 제공합니다. 기본 계정은 다음과 같습니다:

• 관리자: 아이디 admin, 비밀번호 adminpass
• 일반 사용자: 아이디 user, 비밀번호 userpass

비밀번호 변경 또는 계정 추가를 위한 steps:

1. src/config/generate_credentials.py 파일을 수정하여 원하는 계정 정보 입력
2. 아래 명령어 실행:

   cd src/config
   python generate_credentials.py
   

3. 생성된 credentials.yaml 파일을 확인하여 적용

모듈

데이터 수집

• data/krx.py: 한국거래소(KRX)에서 주식 데이터를 수집합니다.
• data/prices.py: 네이버 금융에서 주가 데이터를 수집합니다.
• data/financial.py: FnGuide에서 재무제표 데이터를 수집합니다.

투자 전략

개별 요소 전략

• strategies/factors/value.py: PER, PBR 등 가치 지표 기반 전략
• strategies/factors/quality.py: ROE, GPA 등 퀄리티 지표 기반 전략
• strategies/factors/momentum.py: 주가 모멘텀 기반 전략
• strategies/factors/f_score.py: Piotroski의 F-Score 계산 전략

복합 전략

• strategies/composite/magic_formula.py: Joel Greenblatt의 마법공식 전략
• strategies/composite/multi_factor.py: 다중 요소 통합 전략
• strategies/composite/super_quality.py: F-Score와 GP/A를 결합한 슈퍼 퀄리티 전략
• strategies/composite/super_value_momentum.py: 가치와 모멘텀을 결합한 전략

백테스트

• backtest/engine.py: bt 패키지를 사용한 백테스트 기능 구현