한국어 | English

🧠 뇌사료 (Brain Dogfood)

지식을 기록하는 습관을 넘어, 지능형 유기체로 성장하는 나만의 지식 창고

Minimalist, AI-powered, Privacy-first Knowledge Server

---

Important

보안 주의사항 (Security Notice)

• 기본 관리자 계정은 아이디: admin / 비밀번호: .env 파일에서 본인이 설정한 값입니다.
• 최초 로그인 후, 혹은 서버 실행 전 .env 파일에서 ADMIN_USERNAME과 ADMIN_PASSWORD를 반드시 본인만의 정보로 수정하세요. 수정하지 않을 경우 보안에 매우 취약해질 수 있습니다.

Note

AI 기능은 선택 사항입니다 (AI is Optional)

• Gemini API 키가 없어도 뇌사료의 핵심 기능(기본 메모, 히트맵, 지식 그래프 Nebula, 개별 암호화 등)은 모두 정상 작동합니다.
• AI 기능(GEMINI_API_KEY)은 자동 요약과 인공지능 태깅 기능을 사용할 때만 필요합니다.

---

📄 프로젝트 소개

**뇌사료(Brain Dogfood)**는 "내가 만든 지식은 내가 먼저 소비한다"는 철학에서 시작된 개인용 메모 서버입니다. 단순한 텍스트 기록을 넘어, AI가 당신의 지식을 분석하고 유기적인 그래프(Nebula)로 연결하여 새로운 통찰을 제공합니다.

또한 사용자의 정보를 절대 해독할 수 없는 암호화 방식을 지원합니다. "모든 데이터는 유출될 수 있다. 하지만 내 머리속의 패스워드는 절대 유출될 수 없다" 라는 신념으로, 설사 데이터가 통째로 유출당해도 '개별 암호화'된 데이터와 첨부파일은 사용자가 설정한 비밀번호 없이는 현대의 기술력으로 해독이 불가능합니다.

✨ 독보적인 강점

• 지능형 지식 네트워크 (Nebula & Visual Linker): 단순한 기록을 넘어, D3.js 기반의 '지식 성단' 시각화와 시각적 와이어링(Alt+클릭) 기능을 통해 파편화된 정보를 유기적인 지능체로 연결하세요. 인간의 사고 흐름을 물리적인 선으로 가시화하는 혁신적인 UX를 제공합니다.
• 지식 허브 & 무제한 다중 연결 (N:N Multi-Link): 하나의 메모를 수백 개의 아이디어와 잇는 '지식 허브(Hub)'를 구축하세요. AI의 기계적 연결이 아닌, 사람의 의도적인 큐레이션으로 기억의 지도를 완성합니다.
• Privacy-First Security: 메모별로 개별 암호화를 지원하여 절대적인 보안을 보장합니다. 서버 관리자조차도 당신의 마스터 비밀번호 없이는 지식을 엿볼 수 없습니다.
• High-End UX & Aesthetics: 글래스모피즘 기반의 모던한 UI와 하이엔드 셰이더 효과, 빠른 생산성을 위한 풍부한 단축키 및 슬래시 명령어를 제공합니다.

---

🚀 최신 업데이트 (v2.0)

• 비주얼 노드 링커 (Visual Node Linker): #ID 배지를 Alt + 클릭 드래그하여 지식과 지식을 선으로 잇는 '와이어링'을 수행하세요. 지식의 선후 맥락을 가장 직관적으로 설계하는 방식입니다.
• 멀티링크 에코시스템 (Multi-Link Ecosystem): 한 메모 내에 여러 지식 링크([[#ID]])를 삽입하여 거대한 지식 클러스터를 형성할 수 있습니다.
• 고속 워크플로우 (Instant Edit): 메모 카드 위에 마우스를 올리고 e를 누르면 즉시 수정 모드 진입. 모달 클릭의 피로감을 제로로 만듭니다.
• 드래그 앤 드롭 링크: 메모 카드를 작성기(Composer)로 드래그하여 즉시 참조 링크를 삽입하세요.

---

🆚 memos vs 뇌사료 (Comparison)

기능	memos (Open Source)	🧠 뇌사료 (Brain Dogfood)
기본 철학	타임라인 기반 마이크로 블로깅	유기적인 지식 연결 및 AI 통찰
시각화	단순 달력/히트맵	D3.js Knowledge Nebula (그래프)
AI 통합	외부 플러그인 의존	Gemini 2.0 Native 통합 (자동 요약/태그 / 선택 사항)
보안	DB 전체 보안	메모별 개별 암호화 (Grain-level Security)
사용성	모바일 앱 위주	데스크탑 생산성 최적화 (Slash Commands & Shortcuts)
디자인	미니멀, 정적인 UI	Modern Glassmorphism & 다이내믹 애니메이션

---

⌨️ 생산성 단축키

동작	단축키	설명
저장/수정	Ctrl + Enter	작성한 메모를 즉시 서버에 반영
새 메모	Ctrl + Shift + N	언제 어디서든 즉시 작성창 호출
슬래시 명령	/	/task, /ai, /h2 등으로 빠른 서식 지정
지식 탐색기	Ctrl + Shift + E	저장된 지식의 구조를 한눈에 파악
즉시 수정	e (Mouse Over)	카드 위에서 바로 편집 모드로 진입
비주얼 링커	Alt + #ID 클릭	지식과 지식을 선으로 잇는 '시각적 와이어링'

---

🗺️ Vision Roadmap

• v3.0 - Neural Mind-Map Mode: 그룹 필드를 루트 노드로 활용하여 지식의 위계를 한눈에 파악하는 마인드맵 레이아웃 도입.
• v4.0 - Fractal Knowledge Deep-Dive: 무한히 깊어지는 프랙탈 구조의 시각화를 통해 방대한 지식을 입체적으로 탐험하는 인터페이스 구축.
• Obsidian Plugin: 로컬 옵시디언 환경과 뇌사료 서버 간의 실시간 지식 동기화 브릿지.

---

🛠️ 시작하기

# 1. 저장소 복제 및 종속성 설치
pip install -r requirements.txt

# 2. .env.example을 .env로 복사 후 설정 수정 (필수)
cp .env.example .env

# 3. 서버 실행
python brain.py

.env 파일에서 관리자 아이디와 비밀번호를 꼭 수정하고, 필요한 경우에만 GEMINI_API_KEY를 등록하세요.

---

🌐 English Description

What is Brain Dogfood?

Brain Dogfood is a minimalist yet powerful personal knowledge server built on the philosophy: "I consume the knowledge I create." It’s not just a memo app; it’s an intelligent knowledge ecosystem that grows with you.

We provide a security model where user data is practically undecipherable. Built on the conviction that "Data can be leaked, but the password in my head cannot be," even if the entire database is compromised, any "grain-level encrypted" notes and attachments remain impossible to decrypt without the specific password known only to you.

Important

Security Notice: Default credentials are set in the .env file. You MUST change ADMIN_USERNAME and ADMIN_PASSWORD in your .env file before running the server in a public environment.

Note

AI is Optional: All core features (Memos, Heatmap, Knowledge Nebula, Encryption) work perfectly without an AI API key. The GEMINI_API_KEY is only required for automated summarization and AI tagging.

Key Features

• Intelligent Knowledge Network: Beyond simple notes, build a "Biological Intelligence" through D3.js-powered Nebula Maps and Visual Wiring (Alt+Click).
• Human-Centric Linking: While AI assists in analysis, you define the connections. Build high-density Knowledge Hubs that mirror your own cognitive patterns.
• N:N Multi-Link ecosystem: Support for unlimited bidirectional links between notes, allowing for complex, fractal-like knowledge growth.
• Grain-level Encryption: Advanced security for individual memos – your thoughts are encrypted with your master key, invisible even to server admins.
• Premium Aesthetics: High-end Glassmorphism UI with smooth micro-animations and production-ready shortcuts.

🆕 What's New in v2.0

• Visual Node Linker: Wire your ideas by Alt + Clicking the #ID badge. The most intuitive way to bridge text and visual structure.
• Multi-Link Support: Insert multiple internal links ([[#ID]]) to create clusters of networked thought.
• Instant Edit (e-key): Hover over a memo and press e to jump straight into editing mode. Zero-click productivity.
• Drag & Drop Workflow: Drag memo cards into the composer to instantly insert a semantic reference.

---

🆚 memos vs Brain Dogfood (Comparison)

Feature	memos (Open Source)	🧠 Brain Dogfood
Philosophy	Timeline-based micro-blogging	Organic knowledge linking & AI insights
Visualization	Basic calendar/heatmap	D3.js Knowledge Nebula (Graph)
AI Integration	Dependent on external plugins	Native Gemini 2.0 Integration (Auto summary/tagging)
Security	Database-wide security	Grain-level encryption per memo
Usability	Mobile-first app	Desktop productivity optimized (Shortcuts)
Design	Minimalist, static UI	Modern Glassmorphism & Dynamic Animations

---

⌨️ Productivity Shortcuts

Action	Shortcut	Description
Save/Edit	Ctrl + Enter	Immediately sync memo to server
New Memo	Ctrl + Shift + N	Call the composer from anywhere
Slash Commands	/	Quickly format with /task, /ai, /h2, etc.
Explorer	Ctrl + Shift + E	Gain an overview of the knowledge structure
Instant Edit	e (Mouse Over)	Enter edit mode directly from the card
Visual Linker	Alt + #ID Click	Connect notes visually via 'Visual Wiring'

---

Quick Start

1. Install dependencies: pip install -r requirements.txt
2. Create your .env from .env.example and update your master credentials.
3. Launch the server: python brain.py (Default port: 5050 on Windows, 5093 on Linux).

---

Developed with ❤️ for knowledge lovers.