# Tech Stack

> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.

## 언어 & 런타임

| 항목 | 버전 | 비고 |
|------|------|------|
| Python | 3.12 | `C:\ProgramData\miniforge3\envs\quant\python.exe` |

## 핵심 패키지

| 패키지 | 용도 | 비고 |
|--------|------|------|
| numpy | 행렬 연산, 수치 계산 | 전이행렬 곱, PD 계산 |
| scipy | 최적화(WLS), 정규분포 | Zt 추정, Vasicek 임계값 |
| pandas | 데이터프레임, 시계열 | 거시변수, API 응답 처리 |
| statsmodels | OLS 회귀, 진단 검정 | Zt~거시 모형, ADF/LB/BP |
| matplotlib | 차트 생성 | 한글 폰트: Malgun Gothic |
| requests | HTTP 요청 | ECOS API 호출 |
| tabulate | 표 출력 | 콘솔 결과 테이블 |
| pyyaml | 설정 파일 | config.yaml 파싱 |

## 패키지 관리

- 패키지 매니저: conda (miniforge3) + pip
- 환경: `quant` (`C:\ProgramData\miniforge3\envs\quant`)
- 의존성 목록: `requirements.txt`
- 설치: `pip install -r requirements.txt`

## 개발 도구

| 도구 | 명령어 |
|------|--------|
| 실행 (API 사용) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py` |
| 실행 (Fallback) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py --no-api` |
| Vikunja 조회 | `python .agents\workflows\helpers\vikunja_helper.py list` |
| Wiki 업데이트 | `python .agents\workflows\helpers\wiki_helper.py update "페이지" /tmp/content.md` |

## 환경 변수

| 변수명 | 용도 | 설정 위치 |
|--------|------|-----------|
| ECOS API Key | 한은 Open API 인증 | `config.yaml` → `ecos.api_key` |

## 외부 API

| 서비스 | URL | 인증 |
|--------|-----|------|
| BOK ECOS | `https://ecos.bok.or.kr/api` | API Key in URL path |
| Gitea | `https://git.variet.net` | Token in header |
| Vikunja | `https://plan.variet.net` | Bearer token |
