시작하기

데스크톱 앱

데스크톱 앱은 npm 패키지와 같은 로컬 서버와 스튜디오를 전용 창과 메뉴 막대·트레이 아이콘으로 실행합니다. Apple Silicon macOS(Apple 서명·공증), Windows, Linux용으로 배포합니다. 모든 설치 파일은 데스크톱 릴리스의 최신 ima2 Desktop 릴리스에 있고, 사이트의 다운로드 섹션이 내 기기에 맞는 파일을 골라 줍니다.

macOS

1. ima2-<버전>-mac-arm64.dmg를 받으세요.
2. DMG를 열고 ima2를 응용 프로그램 폴더로 끌어다 놓으세요.
3. ima2를 실행하면 로컬 서버가 켜지는 과정이 보이고, 준비되면 스튜디오가 열립니다.

Windows

1. ima2-<버전>-win-x64.exe(ARM 기기는 -win-arm64.exe)를 받으세요.
2. 설치 파일을 실행하세요. 설치 폴더를 고를 수 있고 관리자 권한은 필요 없습니다.
3. SmartScreen이 Windows의 PC 보호를 띄우면, 릴리스 페이지에서 받은 파일인지 확인한 뒤 추가 정보 → 실행을 누르세요.

Linux

1. AppImage: ima2-<버전>-linux-x86_64.AppImage(또는 -linux-arm64.AppImage)를 받고 chmod +x ima2-*.AppImage 후 실행하세요.
2. Debian / Ubuntu: ima2-<버전>-linux-amd64.deb(또는 -linux-arm64.deb)를 받고 sudo apt install ./ima2-*.deb를 실행하세요.

처음 실행하면 환영 화면에서 제공자를 고르세요. ChatGPT가 가장 간단해요. 브라우저로 로그인하면 되고 API 키가 필요 없습니다.

요구 사항

• Apple Silicon macOS, Windows 10/11(x64 또는 ARM64), 64비트 Linux 데스크톱(x64 또는 ARM64).
• Intel Mac에서는 설치 스크립트나 npm을 쓰세요.
• Node.js를 따로 설치하지 않아도 됩니다. 앱에 들어 있는 런타임으로 서버를 실행합니다.

업데이트

앱이 새 데스크톱 릴리스를 확인하고, 설치를 위해 재시작하기 전에 먼저 물어봅니다. 앱 메뉴나 메뉴 막대·트레이 아이콘의 Check for Updates…로 직접 확인할 수도 있고, 설정에서 자동 다운로드를 끌 수 있습니다. Linux에서는 AppImage만 앱 안에서 업데이트되고, .deb 설치는 새 .deb를 다시 설치해 업데이트합니다.

설정

설정(macOS ⌘,, Windows·Linux Ctrl+,)에서 서버 포트, 로그인 시 열기, 숨긴 채로 시작, 메뉴 막대 전용 모드, 창을 닫아도 서버 유지, 자세한 서버 로그, 설정 폴더, 그리고 다른 ima2 서버가 이미 돌고 있을 때 어떻게 할지를 바꿀 수 있습니다.

CLI와 공유

앱은 npm 설치와 같은 설정 폴더(기본 ~/.ima2)를 써서 기록, 로그인, 설정을 함께 씁니다. 이미 돌고 있는 서버 옆에 두 번째 서버를 띄우지는 않습니다. 돌고 있는 서버가 앱 자신의 것이면 다시 연결하고, 터미널이나 ima2 start, 로그인 서비스가 띄운 서버라면 그대로 쓸지, 앱에 들어 있는 서버로 바꿀지 묻습니다. 설정 → 다른 ima2 서버가 돌고 있을 때에서 답을 고정할 수 있고, 나중에는 트레이 메뉴의 Use Bundled Server로 바꿀 수 있습니다. 로그인 서비스 서버를 바꾸면 그 서비스는 다음 로그인 때까지 멈춥니다. 아예 없애려면 ima2 service uninstall을 실행하세요.

CLI로도 앱의 서버를 다룰 수 있습니다. ima2 status --runtime은 데스크톱 앱이 띄운 서버라고 알려 주고, ima2 stop으로 멈추면 앱이 다시 띄우지 않습니다.