초기 설정 마법사¶
Backend.AI GO를 처음 실행하면 6단계 온보딩 마법사가 열립니다.
- 언어
- 가속기 선택
- 모델 디렉터리
- 선택적 첫 모델 다운로드
- 선택적 클라우드 프로바이더 설정
- 완료
지원되는 인터페이스 언어¶
현재 마법사는 다음 UI 언어를 지원합니다.
- 영어 (
en) - 한국어 (
ko) - 일본어 (
ja) - 스페인어 (
es) - 프랑스어 (
fr) - 번체 중국어 (
zh-TW) - 간체 중국어 (
zh-CN)
1단계: 언어¶
먼저 인터페이스 언어를 고릅니다. 이후 단계는 선택한 언어에 맞춰 즉시 바뀝니다.
2단계: 가속기 선택¶
Backend.AI GO는 호스트를 감지하고 권장 가속기 계열을 제안합니다.
- Apple Silicon에서는 보통 Metal을 쓰는 로컬 엔진과 MLX 경로를 추천합니다.
- NVIDIA, AMD, Intel 시스템에서는 사용 가능한 로컬 가속 경로를 반영합니다.
- 권장값을 그대로 써도 되고 수동 선택으로 바꿔도 됩니다.
선택한 값은 설정에 기록되고, 마법사를 끝낼 때 실제로 반영됩니다. 선택한 계열을 이미 제공하는 설치된 엔진이 없고 앱에 내장 엔진도 없으면, 설정이 끝난 뒤 백그라운드에서 llama.cpp 엔진을 내려받습니다. 헤드리스 서버 설치가 바로 이 경우입니다. 내장 엔진이 없으므로 이 다운로드가 없으면 온보딩이 끝나도 로컬 모델을 실행할 수단이 전혀 없습니다.
온보딩은 이 다운로드를 기다리지 않습니다. 진행 상황은 알림 센터와 헤더의 다운로드 표시기에 나타나며, 실패해도 마법사를 막지 않고 Engines 링크가 달린 알림으로 알려줍니다. 6단계 요약에는 네 가지 결과 중 어느 쪽인지 표시됩니다. 엔진을 설치할 예정, 이미 설치되어 있음, 내장 엔진 사용, 자동 설치 없음입니다.
3단계: 모델 디렉터리¶
다운로드한 로컬 모델을 저장할 위치를 고릅니다. 비워 두면 서버가 기본 앱 데이터 경로를 사용합니다.
기본 앱 데이터 루트는 다음과 같습니다.
| 플랫폼 | 현재 앱 데이터 루트 | 기본 모델 디렉터리 |
|---|---|---|
| macOS | ~/Library/Application Support/ai.backend.go/ | ~/Library/Application Support/ai.backend.go/models/ |
| Windows | %APPDATA%\ai.backend.go\ | %APPDATA%\ai.backend.go\models\ |
| Linux | ~/.local/share/ai.backend.go/ | ~/.local/share/ai.backend.go/models/ |
예전 ~/.backend-ai-go/ 경로는 레거시 전용입니다. 현재 데스크톱 설치는 ai.backend.go 앱 데이터 디렉터리를 사용합니다.
4단계: 선택적 첫 모델 다운로드¶
모델을 바로 내려받지 않고 온보딩을 끝낼 수도 있고, 추천 첫 모델을 큐에 넣을 수도 있습니다.
마법사는 함께 내려받을 추출 모델도 제안할 수 있습니다. 이 두 번째 다운로드는 선택 사항이며, extraction 또는 utility-model 경로를 쓰는 워크플로우를 위한 것입니다.
온보딩 후에는 언제든 Models > Browse에서 모델을 더 내려받을 수 있습니다.
5단계: 선택적 클라우드 프로바이더 설정¶
원하면 온보딩 중에 지원되는 클라우드 프로바이더의 API 키를 등록할 수 있습니다.
현재 마법사가 지원하는 프로바이더는 다음과 같습니다.
- OpenAI
- Anthropic
- Gemini
이 단계는 건너뛸 수 있습니다. 이후에는 API Settings에서 언제든 추가하거나 수정할 수 있습니다.
6단계: 완료¶
마지막 화면은 선택 내용을 요약하고 사용자를 고급 사용자용 대시보드가 아닌 Home으로 보냅니다.
이후에는 다음 작업을 바로 이어갈 수 있습니다.
- Models > Browse에서 추가 모델 다운로드
- Models > Local에서 다운로드한 모델 로드
- Home 또는 Chat에서 chat / cowork 세션 시작
- Engines에서 추가 로컬 또는 컨테이너 엔진 설치