Lain

내 PC에 상주하며 나에게 길들여지는 개인 AI 매니저입니다 — 대화하고, 여러 프로젝트의 코딩 작업을 지휘하고, 화면을 어깨너머로 지켜보다 필요할 때만 조언하며, 쓸수록 사용자를 학습합니다. Windows 데스크톱 앱(Electron + Claude Agent SDK)입니다.

A local orchestrator where a manager agent ("Lain") directs Claude Code workers ("Navi") across many projects — each Navi runs in its own isolated git worktree, and Lain plans, dispatches, reviews, and merges their work from one screen. Lain also learns its user over time: lessons, a user profile, and a customizable persona.

🇰🇷 한국어 전용 — Lain의 대화·UI·문서는 한국어 기준으로 만들어졌습니다. (Korean-only for now.)

Lain이 하는 일

• 대화 — 토큰 스트리밍과 빠른 대화 레인으로 사람과 말하듯 응답합니다. 앱을 껐다 켜도 종료 전 맥락을 기억하고 브리핑합니다
• 코딩 작업 지휘 — 채팅으로 지시하면 프로젝트별 워커(Navi, Claude Code)가 격리된 git worktree에서 작업 → 검증 → 결재(merge/폐기)까지 진행합니다. 여러 프로젝트를 동시에 운용할 수 있습니다
• 학습(길들이기) — 대화·작업에서 교훈을 자동 추출해 다음 판단에 반영하고, 사용자에 대한 사실(선호·습관·수준)을 프로필로 축적합니다. 쓸수록 내 방식에 맞춰집니다
• 유저 감시 — (opt-in) 화면을 지켜보다 진짜 도움이 될 때만 우하단에 잠깐 떠서 조언합니다. 대부분은 침묵합니다
• 음성 — TTS 3종(Edge/Supertonic/GPT-SoVITS)과 디스코드 음성통화를 지원합니다
• 모바일 — 텔레그램으로 어디서든 대화·작업 지시·승인·현황 확인이 가능합니다
• 안전장치 — 위험 명령 승인 큐, 시크릿 파일 접근 차단, autonomous 모드 spec-gaming 방어를 갖췄습니다

빠른 시작

전제조건

1. Windows (현재 Windows 전용 — macOS/Linux 미지원)
2. Node.js 20+, Git 2.x+
3. Claude Code 로그인 — Lain의 두뇌는 Claude입니다. 터미널에서 claude를 실행해 로그인되어 있어야 합니다(Claude 구독 또는 API 키). 로그인이 안 되어 있으면 Lain이 응답 대신 🔑 인증 안내를 띄웁니다.

설치·실행

git clone https://github.com/bestcow/Lain.git
cd Lain
npm install
npm run dev        # 개발 실행
npm run dist       # 설치본 생성 (dist\Lain Setup *.exe) — 상주용 권장

첫 5분

1. 실행하면 Lain이 인사합니다 — 그냥 대화부터 해보세요.
2. 프로젝트 등록: 프로젝츠 창에서 관리할 프로젝트 폴더를 추가하세요. (환경변수로 자동 스캔 루트를 지정할 수도 있습니다 — 아래 설정 참고)
3. 등록된 프로젝트에 채팅으로 작업을 시켜보세요 — "○○ 프로젝트에 ~~ 기능 추가해줘".
4. 환경설정(⚙)에서 호칭·모델·텔레그램 등을 취향대로 바꾸세요.

길들이기 (개인화)

Lain은 쓰는 사람에 맞춰 자라는 것을 전제로 설계되었습니다. 개인화 데이터는 전부 로컬(%APPDATA%\lain)에 저장되며 어디로도 전송되지 않습니다.

설정

폴더를 하나씩 추가하는 대신, 본인 작업 폴더를 환경변수로 지정하면 그 아래 프로젝트들을 자동 스캔해 등록합니다(선택 사항 — UI 수동 추가만으로도 충분합니다). 지정하지 않으면 기본값 경로를 살펴보고, 해당 폴더가 없으면 조용히 무시합니다.

텔레그램·디스코드·TTS·모델 티어 등 나머지는 전부 앱 내 환경설정(⚙)에서 지정합니다. 데이터(설정·대화·학습)는 %APPDATA%\lain에 저장되며 재설치해도 보존됩니다.

로컬 모델 (실험적)

Lain·판정·Navi 모델 선택지에 local(기본 매핑: Qwen3.6-35B-A3B)이 있습니다 — Claude 대신 로컬 llama.cpp llama-server(Anthropic Messages API 네이티브)로 라우팅합니다. Python·Ollama·프록시가 필요 없습니다.

powershell -File scripts\setup-qwen.ps1   # llama.cpp + GGUF(~22GB) 다운로드 (1회)
powershell -File scripts\start-llama.ps1  # 서버 기동 (기본 :8080 — 환경설정 '로컬 모델 서버'와 일치)

정직한 기대치 (메인테이너 실측, RTX 3060 Ti 8GB 기준):

즉 8GB급 VRAM에서는 배관은 동작하지만 실용적이지 않습니다. 대용량 VRAM(24GB+, 모델 전체 GPU 상주)에서는 실용권으로 예상되나 메인테이너 환경에서는 검증할 수 없었습니다 — 이 기능은 community-supported이며, 해당 하드웨어에서의 이슈 리포트는 환영하지만 재현 지원이 제한적입니다. 기본값은 Claude 티어이고, 서버가 꺼진 채 local을 선택하면 복구 안내가 표시됩니다.

개발

⚠️ 코드(src/**)를 바꿨으면 npm run deploy로 끝내야 합니다. 바탕화면/시작 바로가기는 전부 설치본을 가리키고 그 코드는 app.asar에 냉동되어 있어, npm run build만으로는 아이콘을 눌러도 옛 버전이 뜹니다.

구조

• src/main/ — L0 결정론 코어(store·ipc·registry·collectors·worktree·scheduler) + 판단 레이어(manager·worker·workerchat·orchestrator). store는 node:sqlite(네이티브 모듈 아님)
• src/preload/ — contextBridge로 window.lain API 노출
• src/renderer/ — React UI (도트 캐릭터 작업실, 네온 테마)
• src/shared/ — main/renderer 공용 타입 (types.ts = IPC 계약 단일 출처)

원칙: 결정론 배관은 코드가, 판단은 Claude가 담당합니다. L0에 LLM 호출을 넣지 않습니다(판단 레이어만 SDK 사용). 설계 전체는 PLAN.md, 개발 컨벤션은 CLAUDE.md, 릴리스 이력은 CHANGELOG.md를 참고하세요.

라이선스

MIT입니다. 번들된 폰트·에셋 등 제3자 구성요소의 라이선스는 THIRD-PARTY-NOTICES.md를 참고하세요.

자기개선·저널링 구조는 Hermes 에이전트(MIT)에서 영감을 받아 독립적으로 재구현했습니다(코드 복사 없음).