다운로드

sudo apt install ./ilhae-ai_0.2.1_amd64.deb

왜 이렇게 큽니까

문서 엔진, 파이썬·노드 런타임, 검색용 임베딩 모델을 하나에 담아 설치 후 따로 내려받지 않아도 문서 처리가 돌아가게 했기 때문입니다. 그 대신 내려받는 파일이 약 1.1GB, 설치 후 차지하는 용량이 약 2.7GB 입니다. 내려받기 전에 디스크 여유를 확인해 주세요.

대화용 로컬 LLM 은 이 안에 들어 있지 않습니다. 대화를 내 컴퓨터에서 돌리려면 GGUF 모델과 모델 실행기를 직접 내려받아 앱에 경로를 연결해야 합니다. 기본 대화 엔진은 클라우드(Codex·Gemini)입니다.

시스템 요구사항

항목	값
운영체제	Ubuntu 24.04 이상 또는 Debian 13 이상, amd64
C 라이브러리	glibc 2.39 이상(패키지가 libc6 (>= 2.39) 를 요구합니다). Ubuntu 22.04(glibc 2.35)·Debian 12(glibc 2.36)에는 설치되지 않습니다.
내려받는 파일 크기	약 1.07GB (1,152,437,600 바이트)
설치 후 차지하는 크기	약 2.65GB (패키지의 Installed-Size 2,779,443KB)
설치에 필요한 여유 공간	설치 대상 디스크에 약 3GB. 내려받은 .deb 을 같은 디스크에 두고 설치하면 그 1.1GB 까지 합쳐 약 4GB 가 필요합니다(설치가 끝나면 .deb 은 지워도 됩니다).
선택 모델(로컬 LLM) 크기	설치 파일에 들어 있지 않습니다. 대화를 내 컴퓨터에서 돌리려면 GGUF 모델 파일을 따로 내려받아야 하고, 그 크기와 필요한 메모리는 고르는 모델에 따라 달라집니다 — 우리가 실측해 권장할 수 있는 값이 아직 없습니다.

문서 검색·편집과 클라우드 대화는 로컬 LLM 없이 됩니다. 로컬 LLM 까지 돌릴 때 필요한 메모리·디스크·GPU 는 위 표의 마지막 줄대로 고르는 모델에 따라 달라지니, 쓰려는 모델과 실행기가 요구하는 사양을 확인해 주세요.

설치

sudo apt install ./ilhae-ai_0.2.1_amd64.deb

내려받은 파일과 같은 디렉토리에서 실행합니다. 파일이 온전한지는 아래로 확인합니다.

sha256sum ilhae-ai_0.2.1_amd64.deb

설치 후

• 앱 메뉴에서 일해라.ai 를 실행합니다. 첫 화면은 대화창이 아니라 업무 원장입니다.
• 대화 엔진(로컬 모델 서버 / 클라우드 엔진) 선택과 승인 정책은 앱의 설정 화면에서 합니다. 로컬 모델 서버는 별도 화면에서 시작·정지하고, 모델 파일 경로는 ~/.ilhae/config.toml 의 프로필 설정에 적습니다(앱 설정값은 ~/.ilhae/brain/settings/app_settings.json 에 저장됩니다). 설정과 데이터는 모두 ~/.ilhae/ 아래에 있습니다.
• 앱이 문서 원문을 실어 보내는 요청의 외부 전송은 기본으로 막혀 있습니다. 문서 엔진(RAG·근거 노트)의 원격 호출만은 필요할 때 ILHAE_ALLOW_REMOTE_LLM=1 로 직접 풀 수 있고, 그렇게 나간 호출은 감사 로그에 남습니다. 대화 에이전트 쪽 차단은 이 배포본에서는 풀리지 않습니다.
• 이 차단은 앱이 조립한 요청에만 걸립니다. 클라우드 대화 엔진에게 파일을 읽게 하거나 원문을 붙여 넣으면 그 내용은 해당 서비스로 갑니다.

제거

sudo apt remove ilhae-ai

설정과 데이터는 홈 디렉토리에 남습니다. 완전히 지우려면 ~/.ilhae/ 를 삭제하세요.