메인 칼럼 개발일지 작업물 연락처
← 작업물

작업물 · WORK

CueNote

AI 기반 로컬 우선 마크다운 노트 앱 — Electron + Vue 3 + FastAPI

Year
2026
Stack
ElectronVue 3FastAPIAI
Devlog
5개의 기록

CueNote

프라이버시를 최우선으로 하는 오픈소스 데스크톱 마크다운 노트 앱입니다. Electron + Vue 3 프론트엔드와 FastAPI 백엔드로 구축되었으며, 로컬 LLM(Ollama)부터 클라우드 AI(Gemini, OpenAI, Anthropic)까지 다양한 AI 프로바이더를 지원합니다.

핵심 기능

  • 리치 마크다운 에디터: Tiptap 기반 WYSIWYG 편집, 테이블·체크리스트·코드 블록·이미지 리사이징 지원
  • AI 글쓰기 어시스턴트: 텍스트 선택 후 요약·번역·교정·확장 등 AI 컨텍스트 메뉴, 인라인 Diff로 수락/거절
  • AI 챗봇 (Tool Calling): 17개 이상 내장 도구로 노트 생성·검색·일정 관리·웹 검색 등 자동 실행
  • Knowledge Graph: AI가 노트 간 관계를 분석하고 D3.js로 시각화, 자동 클러스터링
  • GitHub 연동: Clone, Pull, Commit, Push 및 AI 커밋 메시지 자동 생성
  • 스마트 캘린더: 노트에서 일정 자동 추출, 일/주/월/년 뷰 제공
  • 문서·이미지 처리: PDF 텍스트 추출, OCR(EasyOCR/TrOCR/Gemini Vision), 웹 스크래핑
  • MCP 지원: 외부 도구를 Model Context Protocol로 연결하여 AI 기능 확장

기술 스택

영역기술
FrontendElectron · Vue 3 · Tiptap · D3.js
BackendFastAPI · Python 3.11+
AIOllama · Gemini · OpenAI · Anthropic
StorageSQLite · Local Markdown Files
DevOpspnpm Workspace · Monorepo

아키텍처

CueNote/
├── apps/
│   ├── core/          # FastAPI 백엔드 (AI, GitHub, Graph, MCP 등)
│   └── desktop/       # Electron + Vue 프론트엔드
├── packages/
│   ├── contracts/     # 공유 TypeScript 타입 & 스키마
│   └── shared/        # 공유 유틸리티
└── data/              # 기본 Vault 위치

설계 철학

  • 로컬 스토리지 사용: 모든 노트를 로컬 SQLite에 저장, 텔레메트리 없음
  • 로컬 LLM 지원: Ollama로 완전 오프라인 AI 사용 가능
  • 선택적 클라우드 AI: 사용자가 원할 때만 클라우드 AI 연결
개발일지 / DEVLOG 5개의 기록
  1. 개발일지 베타 릴리스 — 캘린더 만들고 한글 입력 버그 잡고 v0.2.0-beta1 릴리스, 스마트 캘린더 구현, IME 버그 수정, Mac 빌드 안정화 릴리스캘린더Mac 빌드UX
  2. 개발일지 챗봇한테 노트 앱을 조종하게 하기 Tool Calling으로 17개 이상 앱 기능을 자동 실행하는 AI 챗봇, MCP 서버 연동 AI 챗봇Tool CallingMCP리팩터링
  3. 개발일지 GitHub 연동이랑 Knowledge Graph 만들기 Git clone 방식으로 GitHub 동기화 구현, D3.js로 노트 관계 그래프 시각화 GitHubGraphD3.jsOCR
  4. 개발일지 CodeMirror 버리고 Tiptap으로 갈아탄 날 에디터를 Tiptap으로 전면 교체하고, AI 글쓰기 기능을 붙이기 시작 TiptapAI에디터스트리밍
  5. 개발일지 모노레포 세팅하다가 하루 날림 pnpm workspace로 모노레포 잡고, Electron + Vue 3 올리고, WSL2에서 삽질한 이야기 모노레포ElectronVue 3초기 설정