CLI 설치 — Windows · macOS · Linux

#1. Python 3.10 이상 준비

먼저 설치된 버전을 확인합니다. 3.10 이상이면 2단계로 넘어가세요.

py --version

없거나 낮으면 설치합니다.

winget install Python.Python.3.13
# 또는 python.org 설치 파일 — 첫 화면의 "Add python.exe to PATH" 를 체크하세요

#2. pipx 로 설치 (권장)

pipx 는 명령줄 프로그램을 저마다의 독립된 환경에 설치하고, 명령을 PATH 에 올려 줍니다. 다른 Python 프로젝트와 섞이지 않고, 업데이트·삭제도 한 줄입니다.

1. pipx 를 준비하고 PATH 를 정리합니다.
   WindowsmacOSLinux

   복사

   py -m pip install --user pipx
   py -m pipx ensurepath

2. AIMZ LABS CLI 를 설치합니다. Windows 는 같은 PowerShell 에서 py -m pipx 로 실행할 수 있습니다.
   WindowsmacOSLinux

   복사

   py -m pipx install https://aimzlabs.com/downloads/cli/aimz_labs_cli-0.4.54-py3-none-any.whl

3. 터미널을 닫고 새로 엽니다. aimz 명령의 PATH 는 새 터미널부터 적용됩니다.
4. 확인합니다.
   터미널복사

   aimz --version
   # aimz 0.4.54

#pipx 없이 설치 (venv)

pipx 를 쓸 수 없으면 Python 에 들어 있는 venv 로 전용 환경을 만들어 설치합니다. 관리자 권한이 필요 없습니다.

py -m venv $HOME\.aimz-venv
& $HOME\.aimz-venv\Scripts\python.exe -m pip install https://aimzlabs.com/downloads/cli/aimz_labs_cli-0.4.54-py3-none-any.whl
& $HOME\.aimz-venv\Scripts\aimz.exe --version

#PATH 설정

설치는 됐는데 aimz 를 찾을 수 없다고 나오면, 명령이 놓인 폴더가 PATH 에 없는 것입니다.

py -m pipx ensurepath
# 그다음 터미널을 새로 엽니다. 그래도 안 되면 '시스템 환경 변수 편집'에서
# %USERPROFILE%\.local\bin 이 사용자 Path 에 있는지 확인하세요.

PATH 를 고치지 않고 바로 쓰려면 aimz 대신 Python 모듈로 실행해도 똑같이 동작합니다.

py -m aimz_cli --version          # pip 로 설치한 경우
& $HOME\.aimz-venv\Scripts\python.exe -m aimz_cli --version   # venv 로 설치한 경우

#3. 로그인

aimz login

브라우저가 열리고, aimzlabs.com 에서 로그인하면 터미널로 돌아옵니다. 운영체제별로 다른 점은 이것뿐입니다.

#SSH 로 접속한 서버·데스크톱이 없는 Linux

aimz login --no-browser

출력된 주소를 내 PC 나 휴대폰 브라우저에서 열어 로그인하고, 화면에 나온 코드를 터미널에 붙여 넣습니다. 데스크톱이 없는 서버에는 OS 자격 증명 저장소가 없으므로 토큰을 ~/.aimz/credentials.json(본인만 읽기, 0600) 에 저장합니다.

#WSL (Windows 안의 Linux)

WSL 에서는 Linux 방법으로 설치하고, 로그인은 aimz login --no-browser 를 권합니다. 주소를 Windows 브라우저에 붙여 넣으면 됩니다.

#업데이트 · 삭제

새 판이 나오면 aimz 가 명령 끝에 알려 줍니다(하루 한 번 확인, 끄기: AIMZ_NO_UPDATE_CHECK=1).
aimz update 로 지금 바로 확인할 수 있고, 이 PC 에 맞는 업데이트 명령도 함께 보여 줍니다.
아래 명령으로 덮어 설치하면 됩니다.

# 업데이트 (새 주소로 덮어쓰기)
py -m pipx install --force https://aimzlabs.com/downloads/cli/aimz_labs_cli-0.4.54-py3-none-any.whl

# 삭제
py -m pipx uninstall aimz-labs-cli

로그인 토큰과 설정까지 지우려면 먼저 aimz logout 을 실행한 뒤 설정 폴더(~/.aimz, Windows 는 %USERPROFILE%\.aimz)를 지웁니다.

#파일 위치 한눈에