📚 Molio

AI에게 당신의 개인 지식 기반을 제공하세요. Local-first 방식이며, 모든 데이터 조각은 당신의 것입니다.

English · 中文 · 🌐 공식 웹사이트

License

GitHub Stars

Last Commit

당신이 축적한 것은 한 가지 종류의 것이 아닙니다. 메모, 문서, 채팅 로그에 흩어져 있는 경험과 방법론들—그리고 온전한 책들, 그림으로 가득 찬 PDF 파일들, 산업 자료 더미까지도 그렇습니다. 대부분은 AI가 읽을 수 없는 형태로 존재하기 때문에, 모든 대화는 '0'부터 시작합니다.

Molio는 이 모든 것을 **AI가 읽고 사용할 수 있는 개인 지식 기반(personal knowledge base)**으로 변환합니다: Claude Code, Codex 및 기타 에이전트들이 당신의 지식 공간에 진입하여, 당신이 축적한 모든 것—연구, 작성, 답변, 분석—을 기반으로 작업하고 그 결과를 Markdown 형식으로 다시 기록함으로써, 이 기반은 매 작업마다 더욱 두꺼워집니다. 모든 것은 제3자 서버를 거치지 않고 당신의 기기에서 실행됩니다.

'0'부터 시작하는 것이 걱정되시나요? 리소스 라이브러리에는 지속적으로 성장하는 즉석 지식 기반이 제공되어, 하나를 가져와서 질문하기만 하면 됩니다.

<img src="https://raw.githubusercontent.com/zhuzhaoyun/Molio/HEAD/docs/img/video-poster.webp" alt="Zizhi Tongjian 지식 기반 데모" width="100%" style="border-radius: 8px;" />

▶ 클릭하여 데모 시청하기 — 하나의 책, 하나의 지식 우주: *자치통감(Zizhi Tongjian)*의 1,362년 역사를 Molio가 AI 탐색 가능한 지식 기반으로 처리하는 과정

🔁 작동 방식

01 · 수집 및 처리 — 흩어진 조각들이든, 아니면 온전한 책이든, 모두 호출 가능한 지식 기반이 됩니다.

입력 형식에 제한이 없습니다: Web Clipper를 통해 클릭 한 번으로 클립 페이지를 가져오거나, Obsidian 볼트를 직접 열거나, 로컬 문서를 일괄 가져올 수 있습니다. 스캔된 PDF와 Word / PPT / Excel 파일은 패키지화된 docling을 거쳐 레이아웃 분석, OCR(광학 문자 인식), 표 재구성을 수행합니다. 이미지는 OCR로 읽고; 수백만 단어 분량의 책은 청크 처리 전처리 및 요약 파이프라인을 통해 중단 가능한 진행 상황으로 처리됩니다. 디스크에 저장되는 것은 일반 Markdown이며 — 마이그레이션이나 종속성이 없습니다.

Wiki 엔진은 이 통합된 Markdown 레이어에서 개체(entities)와 개념(concepts)을 추출하여, 밀도 높은 교차 링크와 계층적 인덱스를 엮어냅니다. 데이터는 처리된 후에야 비로소 기반이 됩니다.

02 · 작업 및 과제 (Work & Task) — 에이전트가 당신의 데이터를 사용합니다

Claude Code, Codex, Gemini CLI, Qwen Code와 같은 에이전트들이 당신의 지식 공간 내부에서 연구하고, 작성하고, 답변하며, 분석합니다. 이들이 보는 것은 백지 상태가 아니라, 당신이 축적한 모든 것입니다. 통합 GUI에서 스트리밍 출력을 통해 원하는 에이전트를 선택하거나; QR 코드를 스캔하여 WeChat을 통해 휴대폰으로 기반(base)과 대화할 수 있습니다.

03 · 재구성 및 저장 (Reflow & Deposit) — 사용함에 따라 기반은 더욱 두꺼워집니다

모든 작업의 결과물은 Markdown으로 다시 작성되어 — 재사용 가능한 장기 자산이 됩니다. 지식 그래프는 계속 성장하며, 다음 작업은 더 높은 곳에서 시작합니다. 출판할 준비가 되셨나요? doocs/md로 타이포그래피를 적용하고 한 번의 클릭으로 30개 이상의 플랫폼에 배포하세요.

📥 지원하는 입력 형식 (Supported Inputs)

PDF와 Office 변환은 패키지화된 docling 스킬로 처리됩니다. 첫 번째 변환 시 도구와 약 500MB의 모델이 다운로드되며; 이후 실행에서는 캐시를 재사용합니다.

📦 준비된 지식 기반 (Ready-made Knowledge Bases)

Molio는 도구 자체를 넘어, **즉시 사용 가능한 구조화된 지식 그래프(structured knowledge graphs)**를 제공합니다. 처음부터 구축할 필요 없이, 책 전체나 전문 분야가 AI 준비 상태의 지식 기반으로 미리 정리되어 있어 원클릭으로 가져올 수 있습니다.

문학, 역사, 철학, 전통 중의학, 의학, 그리고 AI 엔지니어링을 다루며, 새로운 자료들이 정기적으로 추가되고 있습니다. 주요 기능으로는 온톨로지 지식 기반(ontology knowledge base), 자치통감(Zizhi Tongjian) 지식 시스템, 산과 초음파 지식 기반 등이 있습니다. 전체적이고 항상 최신 상태인 카탈로그는 리소스 라이브러리에서 확인하실 수 있습니다.

이들은 AI가 스스로 만들어낼 수 없는 독특하게 구조화된 자산들입니다. 하나를 Molio로 가져와 즉시 AI 질의응답(AI Q&A), 관계 검색, 주제별 연구 등을 수행할 수 있습니다.

• 홍루몽 (Dream of the Red Chamber): 120개 장에 걸친 등장인물 및 이미지

• 진핑매이 (Jin Ping Mei): 인물, 상업 및 사회 구조

• 사기 (Shiji, Records of the Grand Historian): 인물, 제도, 사상

• 자치통감 (Zizhi Tongjian): 1,362년간의 흥망성쇠

• 명사 (History of Ming): 제국, 제도 및 궁정 정치

• 주역 (Zhouyi): 64괘 전체, 변화와 이미지-숫자 분석 포함

• 노자 & 장자 (Laozi & Zhuangzi): 핵심 개념 시스템

• 중국 및 서양 철학: 로컬 AI를 위한 지식 기반

• 전통 중의학 고전: 육경 및 삼초 패턴 감별

• 산부인과 초음파: 태아 기형, 징후 및 감별 진단

• 지식 공학: 온톨로지(ontology), RAG, GraphRAG 및 에이전트 엔지니어링(agent engineering)

• 광동 가오카오(Guangdong gaokao) 입학 계획: 대학 및 전공

• 삼국지연의: 인물 관계도, 120개 장 전체

• 도면 데이터 추출: 엔지니어링 도면에서 계산 가능한 데이터로

• PCB 유연 제조: 온라인 주문부터 라이트아웃 공장까지

• 변호사 시험 형사법: 131개 시험 항목 및 주관식 문제 대비

• 중국 고전 시가와 산문: 종합 지식 기반

모든 리소스 둘러보기 →

📡 채널(Channels)

하나의 Molio 인스턴스는 여러 채널을 병렬로 서비스할 수 있습니다. 대부분의 채널은 웹 콘솔(Web console)에서 바로 온보딩 할 수 있습니다.

🖼️ 스크린샷(Screenshots)

🚀 빠른 시작 (Quick Start)

설치 (Installation)

GitHub Releases에서 최신 버전을 다운로드하세요:

• Windows: Molio-Setup-x.x.x.exe<br/>
• macOS: Molio-x.x.x.dmg<br/>

설치하고 실행하세요. 처음 실행 시, AI 런타임 CLI(예: Claude Code, Codex, Gemini)를 구성하는 안내를 받게 됩니다.

🐳 Docker / NAS 배포 (자체 호스팅)

Molio를 NAS 또는 서버에서 자체 호스팅 웹 서비스로 실행하세요. 단일 컨테이너가 데몬(daemon), 웹 UI, Claude Code CLI를 통합하며 linux/amd64와 linux/arm64 모두에서 작동합니다 — Synology, QNAP, TerraMaster, TrueNAS, Unraid 및 대부분의 다른 NAS 장치에서도 사용 가능합니다.

⚠️ 데스크톱 앱과의 차이점 (배포 전 반드시 읽어보세요)

• 브라우저 접근만 가능 — 이 모드에는 데스크톱 클라이언트가 없습니다. Electron 데스크톱 앱은 로컬에서 실행되는 데몬(daemon)과만 통신합니다 (localhost); 원격 NAS/서버에서 실행되는 컨테이너와는 연결할 수 없습니다.
• 데몬은 컨테이너 내부에서 실행되며, 그 안에 마운트된 디렉터리만 읽기/쓰기가 가능합니다. "폴더 피커를 통해 임의의 로컬 폴더를 지식 기반으로 선택하는" 데스크톱 워크플로우는 여기에 적용되지 않습니다. 브라우저에는 폴더 피커가 없으므로, 지식 기반을 추가할 때는 컨테이너 내부 경로를 직접 입력해야 합니다 (예: /vaults/your-folder, NAS 호스트 경로는 안 됨).
• 폴더를 지식 기반으로 노출하려면 docker-compose.yml의 volumes 섹션에서 해당 폴더를 /vaults 아래에 마운트해야 합니다. 데이터는 여전히 전적으로 사용자 소유(NAS)이며, 접근 모델만 "데스크톱 앱"에서 "브라우저 + 마운트된 볼륨"으로 변경되는 것입니다.

원클릭 설치 (Docker 및 Docker Compose v2 필요):

# 중국 지역 (권장)
curl -fsSL https://molio-releases.oss-cn-guangzhou.aliyuncs.com/script/install.sh | bash
# 해외 지역
...

스크립트는 지식 기반 디렉터리와 포트를 요청한 다음, 이미지를 다운로드하고 서비스를 시작합니다. 완료되면 http://<사용자 서버 IP>:3100을 열고 **설정(Settings) → 런타임(Runtimes)**으로 이동하여 AI 모델과 API 키를 구성하세요. Molio는 첫 부팅 시 마운트된 디렉터리에 기본 지식 기반을 자동 생성하므로, 수동 설정 없이 바로 내부로 진입할 수 있습니다.

수동 설치 (일반 docker compose 선호 시):

git clone https://github.com/zhuzhaoyun/Molio.git && cd Molio
cp .env.example .env      # AI 모델은 웹 UI에서 나중에 구성합니다.
docker compose up -d      # 그 후 http://<사용자 서버 IP>:3100을 엽니다.

일상적인 명령어 (설치 디렉터리 내에서 실행, 기본 ~/molio):

docker compose logs -f                          # 로그 추적(follow)
docker compose restart                          # 재시작(restart)
docker compose pull && docker compose up -d     # 최신 이미지로 업데이트(update to the latest image)
...

.env 파일에 MOLIO_VAULT_PATH를 설정하여 기존 문서 폴더를 컨테이너 내부(/vaults)로 마운트하세요. 모든 옵션은 install.sh 및 .env.example을 참조하세요.

개발(소스에서 빌드)

소스 코드를 직접 빌드하거나 개발에 기여하려면:

사전 요구 사항(Prerequisites):

• Node.js >= 22
• pnpm >= 9
• 최소 하나의 AI 런타임 CLI:
  • Claude Code
  • OpenAI Codex CLI
  • Gemini CLI
  • Qwen Code

# 저장소 복제(Clone the repository)
git clone https://github.com/zhuzhaoyun/Molio.git
cd Molio
...

데스크톱 빌드:

# 원클릭 빌드 + 압축 해제된 버전 생성(One-click build + generate unpacked version)
pnpm desktop:run
...

테스트:

pnpm test         # 모든 테스트 실행 (node:test)
pnpm typecheck    # 타입 검사(Type checking)
pnpm build        # 모든 패키지 빌드
...

🏗️ 아키텍처

Molio/
├── packages/
│   └── contracts/       @molio/contracts — 공유 타입 정의(Shared type definitions)
...

기술 스택(Tech Stack):

• 프론트엔드: React 19 + Vite 6 + TypeScript
• 백엔드: Hono + Node.js + SQLite (better-sqlite3)
• 데스크톱: Electron 40 + electron-builder
• 빌드: pnpm workspace monorepo

❓ FAQ