allenhutchison/obsidian-gemini

Gemini Scribe – Obsidian 내의 AI 기반 어시스턴트

소개

• Obsidian 커뮤니티 플러그인으로, 보관소 내에서 거대 언어 모델(LLM) 제공업체(Google Gemini, Ollama, OpenAI, Anthropic)와 대화할 수 있습니다. 이 플러그인은 노트를 컨텍스트로 활용하므로 모델이 파일을 읽고, 생성하고, 편집하고, 정리할 수 있습니다.

핵심 기능

• 도구 호출이 가능한 에이전트 모드 – 모델이 내장 도구를 실행하여 보관소를 검색하고, 노트를 읽고 쓰고, 파일을 이동/이름 변경하고, 폴더를 생성하며, 인용문과 함께 심층 연구를 수행할 수 있습니다. 세션은 markdown 파일로 저장되므로 버전 관리가 가능합니다.
• 기능별 제공업체 라우팅 – 채팅, 요약, 완성, 다시 쓰기, 웹 검색, RAG, 이미지 생성 등 각 작업을 처리할 제공업체(Gemini, Ollama, OpenAI, Anthropic)를 직접 선택할 수 있습니다.
• 의미론적 보관소 검색 – Google의 File Search API를 사용하여 노트(PDF 및 첨부 파일 포함)를 인덱싱하고 키워드가 아닌 의미 기반으로 결과를 검색합니다.
• 스마트 요약 및 다시 쓰기 – 클릭 한 번으로 노트를 front-matter로 요약하거나, 선택한 텍스트를 다시 쓰거나, 선택 영역에 대해 질문할 수 있습니다.
• IDE 스타일 완성 – 입력 시 실시간으로 컨텍스트를 인식하여 제안을 제공하며 Tab 키로 수락할 수 있습니다.
• 계획 모드 – 에이전트가 작업을 실행하기 전에 단계별 계획을 보여주는 선택적 UI입니다.
• 예약 작업 및 라이프사이클 훅 – 반복적인 프롬프트를 자동화하거나 파일 생성/수정 시 헤드리스 에이전트 실행을 트리거할 수 있습니다.
• 프로젝트 및 스킬 – 폴더 기반의 "프로젝트"별로 설정, 프롬프트, 권한을 그룹화하고, 확장 가능한 스킬 패키지(agentskills.io spec)를 로드하여 에이전트에게 전문적인 워크플로우를 제공합니다.
• 이미지 붙여넣기 및 생성 – 채팅에 이미지를 붙여넣거나, 제공업체가 지원하는 경우 Gemini/OpenAI 모델을 통해 이미지를 생성할 수 있습니다.
• MCP (Model Context Protocol) 지원 – stdio 또는 HTTP를 통한 외부 도구 서버와의 실험적 통합으로, OAuth 및 도구별 신뢰 설정을 지원합니다.

시작하기

1. Obsidian 커뮤니티 플러그인 목록에서 Gemini Scribe를 설치합니다.
2. API 키를 획득합니다(Gemini는 Google AI Studio, OpenAI/Anthropic은 개인 키 사용; Ollama는 키 불필요).
3. Settings → Providers를 열고 원하는 제공업체를 추가합니다.
4. Features 페이지에서 각 기능을 선호하는 제공업체로 라우팅합니다.
5. 리본 아이콘이나 명령 팔레트를 통해 에이전트 채팅을 시작합니다(예: “Gemini Scribe: Open agent chat”).
6. 우클릭 컨텍스트 메뉴 명령을 사용하여 선택한 텍스트에 대한 작업을 수행하거나, Automation 설정에서 예약 작업을 시작합니다.

지원 환경

• 데스크톱 Obsidian (Windows, macOS, Linux) – 전체 기능 지원.
• 모바일 Obsidian – UI 수정을 통해 iOS/Android에서 에이전트 뷰와 대부분의 명령이 작동합니다.
• 오프라인 사용을 위해 Ollama 또는 OpenAI 호환 서버(LM Studio, MLX 등)를 통한 로컬 모델 지원.

최근 주요 업데이트 (v4.12.1)

• Obsidian 플러그인 감사 통과(억제된 검사 없음).
• 모바일 친화적인 에이전트 뷰.
• 제공업체 연결 상태에 따른 이미지 생성 도구의 조건부 등록.
• Anthropic 및 범용 OpenAI 호환 제공업체 추가, 스트리밍 및 도구 호출 지원.
• 설정 UI 및 기능별 라우팅 테이블 재설계.
• 도구 호출 처리, 루프 감지, 토큰 사용량 표시의 견고성 향상.

추천 대상

• 방대한 노트를 관리하며 AI를 통해 정리, 요약, 확장을 원하는 지식 노동자.
• 보관소 내에서 직접 인용문이 포함된 자동화된 심층 연구가 필요한 연구자.
• Obsidian을 떠나지 않고 AI의 도움을 받아 초안 작성, 다시 쓰기, 아이디어 생성을 원하는 작가.
• git 기반 보관소에 노트를 저장하고 재현 가능한 AI 세션을 markdown으로 보관하려는 팀.

더 알아보기

• 전체 문서는 저장소의 docs/guide/에서 확인할 수 있습니다(각 제공업체 설정 가이드, 예약 작업, 라이프사이클 훅 등).
• 가이드와 블로그 게시물이 있는 공개 사이트: https://allenhutchison.github.io/obsidian-gemini/.

---

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.