설치 경로는 두 개입니다. 창에서 채팅하고 싶으면 데스크톱 앱, 터미널이나 코딩 도구와 연결할 거라면 터미널을 씁니다. 둘 다 릴리스된 엔진 패키지를 사용하며, 정상 설치에는 소스 체크아웃이나 .bat 파일이 필요 없습니다.

설치 전 체크리스트

시작하기 전에 내 컴퓨터 환경이 Strata를 돌리기에 적합한지 먼저 확인해 보세요.

컴퓨터 환경	안내 및 권장 사항
Windows 10/11·Linux x86-64 + NVIDIA RTX	앱 또는 터미널 설치 가능. 전용 엔진은 자동 다운로드됩니다. 구형 NVIDIA 카드는 CUDA 12 엔진을 사용합니다.
Windows/Linux + 지원 AMD Radeon	AMD 가이드의 카드-패키지 대응표를 먼저 확인하세요.
Linux + Intel Arc	Intel Arc 가이드를 참고하여 드라이버와 컴퓨트 런타임, 모델 준비 상태를 점검하세요.
Apple Silicon Mac (macOS 15+)	M1 이상 칩셋이 탑재된 Mac에서만 지원하며, Intel Mac은 사용할 수 없습니다.
AMD Ryzen AI Max / DGX Spark	각각 전용 가이드에 따른 특수 설정이 필요합니다.

놓치기 쉬운 주의사항:

• 리소스 계산: 필요한 메모리와 디스크 공간은 어떤 모델을 선택하느냐, 어떤 양자화 버전을 쓰느냐, 컨텍스트 길이를 얼마나 잡느냐에 따라 크게 달라집니다. 다운로드 크기가 곧 RAM 사용량은 아니라는 점에 유의하세요. 통합 메모리(Mac 등)는 한 번만 계산하면 됩니다. SSD 공간을 충분히 확보하고, 준비 작업(prepare)을 위한 여유 공간도 남겨 두는 것이 좋습니다. 터미널의 --plan 옵션을 쓰면 부족한 리소스를 미리 알려 줍니다.
• 드라이버 버전: CUDA 13 패키지를 쓰려면 NVIDIA 드라이버 580 이상이 필요하며, 구형 카드는 CUDA 12 경로를 따라갑니다. 주의할 점은 Strata 패키지에 포함된 런타임이 시스템의 하드웨어 드라이버 자체를 대체하지는 않는다는 것입니다.
• 네트워크: 최초 설치, 모델 다운로드, 버전 업데이트 시에는 반드시 인터넷 연결이 필요합니다.

데스크톱 앱으로 간편하게 설치하기

터미널 조작이 낯설거나 GUI 환경에서 채팅하고 싶다면 데스크톱 앱이 가장 좋은 선택입니다.

1. 최신 릴리스 페이지로 이동합니다.
2. 내 운영체제에 맞는 설치 파일을 하나만 받으면 됩니다 (그래픽 카드별로 파일이 나뉘어 있지 않습니다):
   • Windows: Strata-0.2.9-windows-x64-setup.exe 실행. 사용자 단위 설치 방식이라 관리자 권한 없이도 빠르게 설치됩니다.
   • Linux: Strata-0.2.9-linux-x86_64.AppImage를 다운로드하고 실행 권한을 부여한 뒤 엽니다. FUSE가 설치되어 있지 않다면 --appimage-extract-and-run 옵션으로 실행하세요.
   • Mac: Strata-0.2.9-macos-arm64.dmg를 열어 Applications 폴더로 드래그합니다.
3. Windows와 Linux 설치 파일에는 엔진이 포함되어 있지 않습니다. 앱을 처음 실행하면 내 그래픽 카드에 맞는 최적의 엔진과 크기를 자동으로 찾아 보여주며, Download 버튼 하나로 설치를 진행합니다. (다운로드 중단 후 재개가 가능합니다.) 만약 이미 엔진 파일을 가지고 있다면 I already have the file을 선택해 오프라인으로 설치하세요. (Mac용 dmg에는 소형 Metal 엔진이 기본 내장되어 있습니다.)
4. 마지막으로 모델을 선택하고 저장 폴더를 지정해 다운로드하면 모든 준비가 끝납니다.

참고로 릴리스 페이지에 있는 strata-engine-…이나 strata-control-… 같은 압축 파일들은 개별 구성 요소입니다. 일반적인 사용자라면 설치기를 사용하는 것이 훨씬 편합니다. Intel Arc 사용자를 위한 데스크톱 설치기는 아직 준비 중이므로, Linux 터미널 설치 경로를 이용해 주세요.

알아두세요: 데스크톱 앱은 종료 시 앱이 관리하던 엔진 프로세스도 함께 종료합니다.

터미널로 설치하고 자동화하기

셸 환경이 익숙하거나, Strata를 다른 코딩 도구와 연결해 사용하고 싶다면 터미널 설치를 추천합니다. 한 번의 명령으로 Python 환경부터 엔진 설정까지 모두 처리할 수 있습니다.

Linux / Mac 사용자의 경우

curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh

Windows PowerShell 사용자의 경우

irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex

Windows 사용자는 설치 완료 후 반드시 새 터미널 창을 열어 PATH 설정을 반영해 주세요. Linux나 Mac에서 strata 명령어가 인식되지 않는다면, 설치 과정에서 안내된 전체 경로(보통 ~/.local/bin/strata)를 직접 입력하거나 해당 경로를 PATH에 추가하면 됩니다. 모든 설치 과정은 사용자 홈 디렉터리에서 이루어지므로 관리자 권한이 필요 없습니다.

설치가 끝났다면 다음 명령어로 모델 설정부터 서빙까지 한 번에 시작할 수 있습니다.

strata launch            # 화면 안내에 따라 모델·컨텍스트·폴더·접근 설정

특히 스크립트로 자동화하거나 AI 에이전트에 연결할 때는, 미리 계획을 확인하고 질문 없이 실행하는 옵션을 사용하는 것이 효율적입니다.

strata launch --family qwen --model q2_0 --plan          # 변경 사항 없이 어떤 일이 일어날지만 확인
strata launch --family qwen --model q2_0 --yes --no-tui  # 다운로드부터 백그라운드 서빙까지 한 번에 처리
strata launch --status   # 현재 서버 동작 상태 확인
strata connect           # 연결 가능한 코딩 도구 목록 확인
strata launch --stop     # 실행 중인 서버 정지

--no-tui 옵션을 쓰면 서버가 백그라운드에서 실행되며 접속 주소를 출력하고 바로 반환합니다. 만약 이미 다른 설정으로 모델이 구동 중이라면 --restart 플래그를 붙여야 새로운 설정으로 교체됩니다. (--yes 옵션만으로는 기존 모델이 자동으로 재시작되지 않습니다.) 기본 로컬 엔드포인트 주소는 http://127.0.0.1:8080입니다.

첫 실행과 엔진 다운로드

첫 실행은 큰 모델 파일을 점검·준비하는 데 시간이 걸립니다. 고정된 시작 시간은 없고, 진행률과 로그를 확인하세요. 앱에서 종료하면 관리되던 엔진도 종료됩니다.

엔진 검증은 엄격하게 동작합니다. strata launch는 릴리스에서 카드용 엔진을 내려받아 서명을 확인하고 시험 시작까지 한 뒤 사용합니다. GitHub가 공개한 SHA-256와 다르면 파일을 지우고 멈추며, 다시 실행하면 새로 받습니다.

업데이트와 롤백

데스크톱 앱: 설정 화면의 업데이트에서 확인·적용. 엔진을 교체하려면 실행 중인 모델을 언로드합니다. 모델 파일과 설정은 유지됩니다.

터미널:

strata update --check   # 무엇이 바뀌나 확인
strata update           # 업데이트
strata --version        # 버전 확인

모델이 로드된 상태에서 strata update를 하면 어떤 모델인지 알려 주고 정지 여부를 묻고, 모델이 서빙되는 동안 새 엔진을 내려받아 시험 시작 후에만 전환합니다. 실패하면 기존 엔진이 그대로 쓰입니다. 모니터에서 u를 눌러도 업데이트됩니다. 스크립트에서는 --yes만으로는 모델을 세우지 않고(종료 코드 7), --stop-model과 --start-again으로 정지와 재시작을 허용합니다.

앱, Control, 엔진은 버전 번호가 서로 다릅니다. 새 엔진이 말썽이면 strata components rollback으로 직전 엔진에 돌아갑니다(교체된 엔진 한 세대, 약 210MiB 보관).

파일이 저장되는 위치

항목	기본 위치
데스크톱 채팅·호스트 상태	~/.strata(STRATA_HOME으로 변경)
엔진 컴포넌트(Windows)	%LOCALAPPDATA%\Strata\components
엔진 컴포넌트(Linux/Mac)	$XDG_DATA_HOME/strata/components (대체로 ~/.local/share/strata/components)
터미널 파일	components 옆 terminal 폴더 (설치기가 정확한 경로를 찍음)
모델	앱·launch 화면에서 고른 폴더. 기존 모델 라이브러리 재사용

데스크톱 앱은 기본적으로 Documents/Strata/Models 폴더를 제안하며, 터미널은 이전 설치 기록이 있다면 해당 폴더를 자동으로 찾아냅니다. 정확한 경로는 추측하기보다 앱 설정이나 strata models list 명령어를 통해 확인하는 것이 가장 정확합니다. --data-dir 옵션은 새 파일의 다운로드 위치만 변경하며, 기존에 있던 모델 파일까지 옮기려면 --move-data 옵션을 함께 사용해야 합니다.

설치가 끝났다면 다음 편에서 내 PC에 맞는 모델을 고르고, launch 가이드에서 strata launch를 완전히 배웁니다.