AI.RUN 클라이언트 설치 가이드

# 시스템 요구사항

운영체제: Windows, Linux 또는 macOS
Python: 3.8.0 이상 (3.12.0 권장)
디스크 공간: 최소 500MB

# 설치 방법

## Linux/macOS 사용자:

1. 설치 스크립트 다운로드:
   curl -o airun-setup.zip http://localhost:5500/api/v1/client/setup

2. 압축 해제:
   unzip airun-setup.zip

3. 설치 스크립트 실행:
   chmod +x client-setup.sh
   ./client-setup.sh

## Windows 사용자:

1. PowerShell을 관리자 권한으로 실행 후:
   # 설치 스크립트 다운로드
   Invoke-WebRequest -Uri "http://localhost:5500/api/v1/client/setup" -OutFile "airun-setup.zip"

   # 압축 해제
   Expand-Archive -Path "airun-setup.zip" -DestinationPath "."

   # 설치 스크립트 실행
   .\client-setup.ps1

# 설치 확인

설치가 완료되면 다음 항목들이 생성됩니다:

## Linux/macOS:
- 가상환경: ~/.airun_venv
- 설정 파일: ~/.airun/airun.conf
- 실행 스크립트: ~/.airun/run.sh
- 자동완성: ~/.local/share/bash-completion/completions/airun

## Windows:
- 가상환경: %USERPROFILE%\.airun_venv
- 설정 파일: %USERPROFILE%\.airun\airun.conf
- 실행 스크립트: %USERPROFILE%\.airun\run.bat

# 자동완성 설정

## 설치 시 자동완성이 동작하지 않는 경우:

1. 별도 자동완성 설치 스크립트 실행:
   chmod +x scripts/install-completion.sh
   ./scripts/install-completion.sh

2. 또는 수동으로 쉘 설정 재로드:
   # Bash 사용자
   source ~/.bashrc
   
   # Zsh 사용자  
   source ~/.zshrc

3. 자동완성 확인:
   터미널에서 `airun <TAB><TAB>`을 입력하여 명령어 옵션이 표시되는지 확인

## 지원되는 쉘:
- Bash: 자동으로 설치됨
- Zsh: 자동으로 설치됨
- PowerShell (Windows): 향후 지원 예정

# Python 코드 실행 방법

Linux/macOS: ~/.airun/run.sh <python_file>
Windows: %USERPROFILE%\.airun\run.bat <python_file>

# 문제 해결

## 자동완성이 동작하지 않는 경우:

1. 쉘 재시작 또는 설정 파일 재로드
2. scripts/install-completion.sh 실행
3. 자동완성 파일 수동 확인:
   - Bash: ~/.local/share/bash-completion/completions/airun
   - Zsh: ~/.zsh/completion/_airun

## 기타 문제:

이메일 문의: hckim@invesume.com
