다운로드

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

왜 이렇게 큽니까

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

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

시스템 요구사항

항목	값
운영체제	Ubuntu 22.04 이상 또는 Debian 12, amd64
내려받기	약 5.0GB
디스크	약 11GB(설치 후 — 패키지의 Installed-Size 기준)

문서 검색·편집과 클라우드 대화는 로컬 LLM 없이 됩니다. 로컬 LLM 까지 돌릴 때 필요한 메모리·디스크·GPU 는 고르는 모델에 따라 달라집니다 — 우리가 권장 수치로 제시할 만큼 실측하지 못했으니, 쓰려는 모델과 실행기가 요구하는 사양을 확인해 주세요.

설치

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

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

sha256sum ilhae-ai_0.2.0_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/ 를 삭제하세요.