# 준비 및 설치하기

먼저, PyQQQ의 커맨드라인 도구를 설치하고 증권사 정보를 저장한 후에 SDK 설치하는 방법을 소개합니다.

## 준비과정

### Python

PyQQQ SDK는 Python 3.11 이상을 필요로 합니다. [공식 홈페이지](https://www.python.org/downloads/)에서 다운로드 받으실 수 있습니다.
아래의 공식문서들을 참고하여 Python 설치를 완료합니다.

- [초보자를 위한 Windows에서 Python 사용 시작](https://learn.microsoft.com/ko-kr/windows/python/beginners)
- [윈도우에서 파이썬 사용하기](https://docs.python.org/ko/3.11/using/windows.html)

Python을 처음 설치해보신 사용자는 conda를 건너뛰고 다음 단계인 {ref}`VSCode<VSCode>`를 진행합니다.

#### conda

conda 환경을 사용하는 경우, 다음 명령을 사용하여 기본 python 버전을 변경할 수 있습니다.

```
(base) $ conda install python=3.11.7
```

필요한 경우 [conda 페이지](https://docs.anaconda.com/miniconda/install/)에서 무료 버전의 miniconda를 다운로드 받을 수 있습니다.

```{tip}
---
name: hello
class: dropdown
---
아나콘다(Anaconda)는 과학 연구 및 머신러닝 분야에 적합한 Python 및 R 언어의 패키지 / 의존성 관리 및 배포를 편리하게 해주는 조건부 무료 오픈 소스 패키지 관리자 이름이다.

\- 나무위키
```

### VSCode
(VSCode)=

TBD


### 커맨드라인 도구(CLI) 설치

터미널을 이용해 PyQQQ 커맨드라인 도구를 설치합니다.

```bash
$ pip install pyqqq-cli
```

다음 명령을 실행하여 잘 설치됐는지 확인합니다.

```bash
$ qqq
Usage: qqq [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  delete  Delete a deployed strategy
  deploy  Deploy strategy
  list    List deployed strategies
  logs    Show logs of a deployed strategy
```

## API Key 저장

```{image} ../_static/images/apikey.png
:class: focus-box
:width: 600px
:align: center
```

커맨드라인 도구를 이용해 기능을 실행합니다. **PYQQQ_API_KEY**가 필요하다는 에러가 발생합니다.

```bash
$ qqq list
ERROR: Key not found.

Please set PYQQQ_API_KEY environment variable or create a file at ~/.qred with the API key.
```

PyQQQ 커맨드라인 도구의 강력한 기능을 사용하기 위해서는 PyQQQ 플랫폼에서 발급받은 API Key가 필요합니다.

1. [PyQQQ](https://www.pyqqq.net) 에서 회원가입을 합니다.
2. [프로필 페이지](https://pyqqq.net/profile)에서 본인의 API Key를 확인 후, API Key를 복사하여 `$HOME/.qred` 파일에 적어둡니다.
3. `qqq list` 명령을 실행하여 동작하는지 확인

```bash
$ qqq list
No strategies deployed
```


## SDK 설치하기

`pip` 명령어를 이용해 pyqqq sdk를 설치합니다.

```bash
$ pip install pyqqq
```