Lapis0x0/obsidian-yolo

📌 YOLO란 무엇인가?

YOLO("Agent‑native AI assistant for Obsidian")는 대규모 언어 모델 에이전트를 Obsidian 메모 앱에 직접 통합하는 커뮤니티 플러그인입니다. 볼트를 떠나지 않고도 AI 도구와 대화하고, 작성하고, 조율할 수 있어 개인 지식 기반을 대화형 RAG 지원 작업 공간으로 바꿔줍니다.

🚀 핵심 기능(README에 설명된 대로)

기능	설명
에이전트 경험	로컬에 로그인된 CLI 에이전트(Claude Code, Codex, Hermes, Pi, Grok)에 연결하여 볼트에서 도구 호출, 셸 명령 실행, 웹 검색 등을 수행할 수 있게 합니다.
볼트 RAG	Obsidian 노트(로컬 임베딩 모델 포함)를 인덱싱하고 맥락에 근거한 답변을 검색하여 AI가 사용자의 콘텐츠를 인용할 수 있게 합니다.
학습 모드	모든 주제와 원본 자료를 체계적인 학습 프로젝트로 전환합니다: 개요, 지식 포인트, 플래시카드, 간격 반복(FSRS), Anki `.apkg` 내보내기.
멀티 윈도우 채팅	각각 고유한 맥락과 작업을 가진 여러 독립적인 채팅 세션을 병렬로 실행합니다.
메모리 시스템	대화 전반에 걸쳐 선호도, 습관, 장기 맥락을 유지합니다.
커서 채팅 및 빠른 질문	편집기에서 원클릭 `@`로 질문, 편집, 또는 노트를 떠나지 않고 계속 작성할 수 있습니다.
탭 완성	입력하는 동안 실시간 AI 기반 제안을 제공합니다.
멀티 모델 지원	OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Groq 등 간에 전환할 수 있습니다.
외부 에이전트 / MCP 지원	외부 에이전트(예: Hermes, OpenClaw)를 연결하거나 구성된 YOLO 에이전트에 작업을 위임할 수 있습니다.
화이트보드	네이티브 캔버스보다 빠르게 작동하는 고성능 Obsidian Canvas로, AI 지원 브레인스토밍에 적합합니다.
i18n	완전한 다국어 UI.

🛠️ 시작하기(README의 빠른 시작 단계)

설치 – Obsidian 열기 → 설정 → 커뮤니티 플러그인 → 찾아보기 → "YOLO" 검색 → 설치 및 활성화.
구성 – 원하는 모델(OpenAI, Anthropic, Gemini, Grok 등)의 API 키를 추가하거나 OAuth 로그인을 사용합니다.
채팅 시작 – YOLO 사이드바를 열거나 아무 노트에서 @를 입력하여 빠른 질문을 실행합니다.
(선택 사항) 수동 설치 – 최신 릴리스에서 main.js, manifest.json, styles.css를 다운로드하여 <vault>/.obsidian/plugins/obsidian-yolo/에 넣은 후 활성화합니다.

참고: YOLO는 Smart Composer 플러그인과 충돌합니다. 먼저 후자를 비활성화해야 합니다.

📚 문서 및 도움말

전체 사용자 가이드: documentation/en/README.md
주제에는 시작하기, 모델 설정, 채팅 워크플로, Sparkle(빠른 질문 및 탭 완성), 지식 베이스, 도구 및 권한, 메모리, 스킬, 에이전트, MCP 통합, CLI 에이전트 등이 포함됩니다.
Discord 서버(README의 링크)와 GitHub 이슈 트래커를 통한 커뮤니티 지원.

🎯 누가 혜택을 받을 수 있나요?

지식 근로자 – Obsidian에 방대한 메모를 보관하고 AI 기반 검색과 작성을 원하는 사람.
학생 및 평생 학습자 – 플래시카드와 간격 반복이 있는 개인 학습 시스템을 찾는 사람.
개발자 – 이미 CLI AI 에이전트를 사용하고 그 힘을 메모 작성 워크플로에 가져오고 싶은 사람.
팀 – 공유 볼트 내에서 외부 도구 호출, 셸 명령 실행, 웹 검색을 수행할 수 있는 통합 AI 어시스턴트가 필요한 팀.

🧩 AI 환경에 어떻게 적합한가

RAG(검색 증강 생성) – YOLO는 볼트를 로컬(또는 원격 임베딩을 통해) 인덱싱하고 관련 구절을 검색하여 모델 응답의 근거를 제공합니다.
에이전트 오케스트레이션 – 도구 호출, 하위 에이전트, MCP(멀티 채널 프로토콜) 서버를 지원하여 단순한 Q&A 봇을 능동적인 협력자로 전환합니다.
멀티 모델 유연성 – 사용자는 Obsidian을 떠나지 않고 주요 LLM 제공업체 간에 전환할 수 있습니다.

📦 라이선스 및 기여

MIT 라이선스에 따라 라이선스가 부여됩니다.
기여를 환영합니다. 저장소에는 지침, AI 지원 PR 정책, 주요 기능에 대한 요청 우선 워크플로가 포함된 CONTRIBUTING.md가 있습니다.

TL;DR: YOLO는 Obsidian용 완전한 기능을 갖춘 AI 에이전트 플러그인으로, 채팅, RAG, 멀티 모델 지원, 도구 호출, 학습 시스템을 추가하여 메모 볼트를 대화형 AI 기반 작업 공간으로 전환합니다.