다운로드 및 설치
이 페이지에서는 Elftia를 처음 다운로드하고, 설치하고, 실행하는 과정을 안내합니다.
시스템 요구 사항
설치하기 전에 기기가 다음 최소 요구 사항을 충족하는지 확인하세요.
| 플랫폼 | 최소 버전 | 아키텍처 |
|---|---|---|
| Windows | Windows 10 (64-bit) 이상 | x64 / arm64 |
| macOS | macOS 10.15 (Catalina) 이상 | Intel / Apple Silicon |
| Linux | Ubuntu 20.04 / Fedora 36 / Debian 11 또는 이에 준하는 버전 | x64 |
하드웨어 권장 사항:
- RAM: 4 GB 이상(8 GB 권장)
- 디스크 공간: 최소 500 MB의 사용 가능한 공간
- 네트워크: LLM API 호출을 위한 인터넷 연결 필요
선택적 의존성(Agent 기능에 필요):
Elftia는 처음 실행할 때 다음 도구를 자동으로 감지합니다. Agent 기능(코드 편집, 파일 작업, Shell 명령 등)을 사용할 계획이라면 미리 설치하는 것이 좋습니다.
| 도구 | 용도 | 다운로드 |
|---|---|---|
| Node.js 18+ | MCP 서버 런타임, 일부 도구 실행 | nodejs.org |
| Git | 버전 관리, 프로젝트 관리 | git-scm.com |
| uv / uvx | Python 패키지 관리(일부 MCP 서버에 필요) | astral.sh/uv |
이 의존성은 선택 사항입니다. 기본 AI 채팅 기능만 필요하다면 건너뛰어도 됩니다.
다운로드
공식 웹사이트
Elftia 공식 웹사이트의 다운로드 페이지를 방문해 운영 체제에 맞는 버전을 선택하세요.
GitHub Releases
GitHub Releases 페이지에서도 최신 버전이나 이전 버전을 다운로드할 수 있습니다. 각 릴리스에는 다음 설치 파일이 포함되어 있습니다.
| 플랫폼 | 설치 파일 형식 | 파일 이름 예시 |
|---|---|---|
| Windows | NSIS 설치 프로그램 | Elftia-Setup-x.x.x.exe |
| macOS | DMG 이미지 | Elftia-x.x.x.dmg / Elftia-x.x.x-arm64.dmg |
| Linux | AppImage | Elftia-x.x.x.AppImage |
설치 단계
Windows
- 다운로드한
Elftia-Setup-x.x.x.exe파일을 두 번 클릭합니다. - Windows SmartScreen 프롬프트가 표시되면 "More info"를 클릭한 다음 "Run anyway"를 선택합니다.
- 설치 경로를 선택합니다(기본값은
C:\Users\<username>\AppData\Local\Elftia). - 설치가 완료될 때까지 기다립니다. 설치 프로그램이 바탕 화면 바로 가기와 Start Menu 항목을 자동으로 생성합니다.
- "Finish"를 클릭해 Elftia를 실행합니다.
Elftia는 자동 업데이트를 지원하는 NSIS 설치 프로그램을 사용합니다. 설치된 애플리케이션은 시스템 설정에서 일반적인 방식으로 제거할 수 있습니다.
macOS
- 다운로드한
.dmg파일을 두 번 클릭해 디스크 이미지를 마운트합니다. - 열린 창에서 Elftia 아이콘을 "Applications" 폴더로 드래그합니다.
- 처음 실행할 때 macOS에서 "Cannot verify developer" 프롬프트가 표시될 수 있습니다.
- "System Preferences → Security & Privacy → General"을 엽니다.
- "Open anyway" 버튼을 클릭합니다.
- Elftia가 실행되고 사용할 준비가 완료됩니다.
Apple Silicon(M1/M2/M3/M4) 사용자는 최적의 성능을 위해 arm64 버전을 다운로드해야 합니다. Intel Mac 사용자는 표준 버전을 다운로드해야 합니다.
Linux
.AppImage파일을 다운로드합니다.- 실행 권한을 부여합니다.
chmod +x Elftia-x.x.x.AppImage
- 두 번 클릭해 실행하거나 터미널에서 실행합니다.
./Elftia-x.x.x.AppImage
AppImage가 실행되지 않으면 FUSE를 설치해야 할 수 있습니다. sudo apt install libfuse2(Ubuntu/Debian).
첫 실행
Elftia를 처음 실행하면 다음 흐름이 표시됩니다.
1. 환경 감지
Elftia는 시스템에 설치된 도구(Node.js, Git, ripgrep, uv/uvx 등)를 자동으로 감지합니다. 감지 결과는 Settings 페이지의 "Environment" 섹션에 표시되며, 각 도구 옆에는 초록색(설치됨) 또는 빨간색(설치되지 않음) 상태 표시기가 표시됩니다.
나중에 Settings → General → Environment에서 이 도구들을 확인하고 관리할 수 있습니다. 누락된 일부 도구는 "Install" 버튼을 클릭해 직접 설치할 수 있습니다.
2. 언어 선택
Elftia는 세 가지 인터페이스 언어를 지원합니다.
- 중국어 간체
- 영어
- 일본어
기본 언어는 시스템 언어에 따라 자동으로 선택됩니다. Settings → General → Language에서 언제든지 변경할 수 있습니다.
3. LLM 제공업체 구성
AI 채팅을 시작하려면 최소 하나의 LLM 제공업체를 구성해야 합니다. 자세한 내용은 첫 채팅을 참조하세요.
Steam 버전 차이점
Steam을 통해 Elftia를 설치하는 경우 다음 차이점에 유의하세요.
| 항목 | 표준 에디션 | Steam 에디션 |
|---|---|---|
| 업데이트 방식 | 앱 내 자동 업데이트(electron-updater) | Steam 클라이언트를 통한 업데이트 |
| 설치 경로 | 사용자 정의 | Steam 라이브러리 폴더 |
| 제거 방법 | 시스템 설정 / 제어판 | Steam을 통해 제거 |
| 기능 | 동일 | 동일 |
Steam 버전은 표준 에디션과 기능이 동일하며, 업데이트 메커니즘만 다릅니다.
일반적인 설치 문제
설치 프로그램이 실행되지 않음
Windows: 백신 소프트웨어에 의해 차단되었는지 확인하세요. 일부 백신 프로그램은 Electron 애플리케이션을 잘못 감지할 수 있습니다. 백신 허용 목록에 Elftia를 추가하세요.
macOS: "damaged, can't be opened" 메시지가 표시되면 터미널에서 다음을 실행하세요.
xattr -cr /Applications/Elftia.app
Linux: FUSE 의존성이 설치되어 있고 파일에 실행 권한이 있는지 확인하세요.
시작 시 빈 화면 또는 충돌
- 그래픽 드라이버가 최신 버전으로 업데이트되어 있는지 확인하세요.
- 관리자 권한으로 실행해 보세요(Windows).
- 다른 Elftia 인스턴스가 이미 실행 중인지 확인하고 닫으세요.
- 오래된 GPU를 사용하는 경우 시작 시
--disable-gpu매개변수를 추가해 보세요.
.NET 또는 Visual C++ 런타임 누락(Windows)
일부 Windows 시스템에는 필요한 런타임 라이브러리가 없을 수 있습니다. Visual C++ Redistributable을 설치한 뒤 다시 시도하세요.
방화벽이 인터넷 연결을 차단함
Elftia는 LLM API를 호출하기 위해 인터넷 접근이 필요합니다. 방화벽이 Elftia의 아웃바운드 연결을 허용하는지 확인하세요. 프록시 설정은 프록시 사용을 참조하세요.
설치가 완료되면 첫 채팅을 계속 읽고 AI 여정을 시작하세요.