설치 · Minara Agent

원하는 사용 방식을 선택하세요. 대부분의 사용자에게는 데스크톱 앱이 가장 간단합니다. 더 세밀한 제어가 필요하면 브라우저, 터미널, Docker도 사용할 수 있습니다.

데스크톱 앱

데스크톱 앱은 Agent, Web UI, 자동 업데이트를 하나의 설치 프로그램에 담습니다. Node.js, 빌드 도구체인, 터미널이 필요하지 않습니다.

플랫폼	지원 패키지	다운로드
macOS (Apple Silicon)	`.dmg`	GitHub Releases
Windows (x64)	설치 프로그램	GitHub Releases
Linux (x64)	AppImage 또는 `.deb`	GitHub Releases

릴리스 페이지에서 플랫폼에 맞는 패키지를 내려받아 설치한 뒤 로그인하고 대화를 시작하세요. 릴리스 노트에는 현재 빌드, 서명 상태, 알려진 문제가 표시됩니다.

브라우저와 명령줄

브라우저에서 Web UI를 쓰거나 터미널 중심 워크플로를 원하면 설치 스크립트를 사용하세요.

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh | bash

설치 스크립트는 Linux, macOS, WSL2, Termux를 통한 Android를 지원합니다. Node.js와 로컬 데이터베이스에 필요한 네이티브 빌드 도구를 확인하고 Minara를 설치한 뒤 설정을 시작합니다.

Windows: 데스크톱 설치 프로그램을 사용하거나, WSL2를 설치한 뒤 위 명령을 실행하세요. 네이티브 Windows shell 설치는 지원하지 않습니다.

네이티브 Windows에서 달라지는 점

데스크톱 설치 프로그램은 agent를 함께 담아 네이티브 Windows에서 실행합니다. 따라서 Windows에서 지원되는 사용 방식은 데스크톱 앱입니다. 네이티브 Windows를 지원하지 않는 것은 위의 shell 설치 스크립트입니다.

대화, 리서치, 시장 데이터, 거래, 자동화, Web UI는 모든 플랫폼에서 동일하게 동작합니다. 다음 기능은 다릅니다.

기능	네이티브 Windows	macOS · Linux · WSL2
터미널 도구	`cmd.exe`로 실행	`/bin/sh`로 실행
스킬 보조 스크립트	POSIX 스크립트(`.sh`, `jq`)는 실행되지 않습니다	사용 가능
코딩 프로젝트 작업(install, build, test)	사용 불가(OS 파일 시스템 jail 필요)	사용 가능(Linux는 bubblewrap, macOS는 sandbox-exec)
구조화 Git 및 Git over SSH	사용 불가	사용 가능
하위 프로세스 격리	명령 가드만 적용	명령 가드와 OS 파일 시스템 jail

사용 불가로 표시된 기능이 필요하면 WSL2에서 Minara를 실행하세요.

설치 후:

source ~/.zshrc             # 또는: source ~/.bashrc
minara setup                # Minara와 LLM provider 연결
minara serve --ui           # http://localhost:4173 에서 Web UI 열기
minara                      # 또는 터미널 대화 시작

소스에서 설치

Minara를 개발하거나 checkout을 직접 관리하려면 다음을 실행하세요.

git clone https://github.com/Minara-AI/minara-agent.git
cd minara-agent
corepack enable
pnpm install
pnpm dev

Node.js 24 이상과 pnpm 9.15.0이 필요합니다. macOS에는 Xcode Command Line Tools가 필요하고, Debian 또는 Ubuntu에서는 better-sqlite3 빌드를 위해 build-essential가 필요합니다.

설치 스크립트로 설치한 checkout은 minara update로 업데이트할 수 있습니다. 소스 checkout은 최신 변경을 pull한 뒤 pnpm install을 다시 실행하세요.

Docker

Docker는 Web UI와 gateway를 함께 시작합니다.

pnpm docker

처음 실행하면 예시에서 .env를 만들고 중지하므로 자격 증명을 입력할 수 있습니다. 다시 실행하면 빌드하고 시작합니다. 영구 데이터, 업그레이드, 네트워크 노출, Agent 전용 컨테이너는 배포를 참고하세요.

설정 확인

minara doctor
minara doctor --probe-llm

검사가 통과하면 준비가 끝납니다. 첫 거래로 시작하거나 Web UI를 둘러보세요.

설치