🧠 avenoxbeyin V3
Claude Code, Codex, Google Antigravity 또는 Kiro와 사용할 수 있는 로컬 보조 두뇌(second brain)입니다. 메모는 Markdown 파일에 남아 있으며, 한 클라이언트에서 저장한 소스 및 작업 결과가 다른 곳에서도 존재할 수 있습니다. Obsidian으로 열거나 일반 텍스트 편집기로 수정할 수 있습니다.
Python 3.11 이상이면 충분합니다. Git, pip, Mem0 계정, API 키 또는 지속적으로 열려 있는 서버는 필요하지 않습니다. 사용 중인 AI 클라이언트의 설치 및 계정은 별도로 필요합니다.
V3.11.0: 같은 세션에서 동일한 메모를 다시 보내지 않는 선택적 컨텍스트 제거(context-dedupe) 모드(preferences --context-dedupe on), Kiro 지원, Windows에서 브라우저 및 커서 연결 또는 창 이미지를 저장하는 캡처(yakala), 예약 건강 검사(scheduled-check) 기능이 추가되었으며, 민감한(hassas)이라는 폴더는 인덱스 외부로 제외되었습니다. 긴 Kurallar.md가 시작 시 내용을 놓치지 않게 되었고, --uninstall 사용자가 텍스트를 보존합니다. 기존 설치의 경우 vault 내에서 python3 beyin.py update를 실행하고, 캡처를 사용하는 경우 이어서 한 번 python3 beyin.py yakala kur를 실행하세요. 버전 노트 · 캡처 · 업데이트 가이드.
가장 쉬운 설치: 폴더 하나, 메시지 하나
- Obsidian에서 새 vault를 생성하거나 기존 vault 폴더를 선택합니다.
- 이 폴더를 지원되는 AI 클라이언트 중 하나로 엽니다.
- 다음 메시지를 붙여넣습니다:
https://avenox.lol/beyin.md 주소를 읽어주세요. 이 폴더에 제 보조 두뇌(second brain)를 설치하세요. 기존 설치가 있다면 메모를 보존하며 업데이트해주세요. 필요한 다운로드 및 설치 단계를 직접 수행해 주세요. 마지막으로 예시 정보를 저장하고 새 세션에서 다시 읽으며 함께 확인합시다.
에이전트가 안정적인 패키지 파일을 찾고, 체크섬(checksum)으로 검증한 후, 임시 영역에서 열고, 설치를 진행하며, 건강 검사를 실행합니다. 사용자는 클라이언트가 보여주는 일반 폴더, 작업 공간 또는 훅 보안 검사만 완료하면 됩니다.
시각적 설명, 복사 가능한 메시지 및 수동 다운로드: avenox.lol/ikincibeyin.
수동 설치
- 최신 버전 페이지를 열어라.
beyin-v3-X.Y.Z.zip 파일과 옆에 있는 SHA-256 파일을 다운로드한다 (X.Y.Z는 페이지의 버전 번호이다). GitHub의 자동 “Source code” 아카이브 대신 이 패키지를 선택하라.
- Obsidian에서 볼트(vault)를 생성하거나 기존 볼트 폴더를 선택한다. 노트를 다른 곳으로 옮길 필요는 없다.
- 열린 패키지 폴더에서 터미널을 열고 볼트 경로를 자신의 폴더로 변경한다:
macOS / Linux:
python3 scripts/install_v3.py --vault "/전체/경로/Beynim"
Windows:
py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim"
이는 설치 클라이언트(installer)를 위한 프로젝트 연결, 공통 엔진, 세 가지 시작 스킬, 그리고 업데이트 바로가기를 설정한다. 이제부터는 패키지 폴더를 열어둘 필요가 없다.
Hermes Agent를 사용하는 경우 동일한 엔진을 Hermes 플러그인(plugin)을 통해 연결한다; 설치 프로그램은 플러그인 파일을 볼트 안에 작성하지만, 프로필 기반 연결 및 hermes plugins enable beyin-v3 단계는 사용자가 직접 수행해야 한다. 단계: docs/v3/HERMES.md. 이 지원은 V3.1.0 이상 패키지에 포함된다.
사용하는 AI 클라이언트에서 볼트 폴더를 열고 새 세션을 시작한다. Codex에서는 /hooks 화면에서 새로운 훅(hook) 정의들을 검토하고 신뢰하며, 다른 클라이언트에서는 워크스페이스 신뢰를 완료한다. 클라이언트 신뢰는 설치 프로그램이 사용자 대신 임의로 만들어주지 않는다. Agent와 함께 설치하려면 SETUP-V3.md 가이드를 따라 하도록 요청하라.
OpenCode의 경우 추가 단계가 없다: 설치 프로그램은 플러그인을 볼트 안에 작성하며, OpenCode에서 볼트 폴더를 열면 동일한 엔진에 연결된다. 이 플러그인은 OpenCode 1.x (1.3.4 이상) 및 2.x와 함께 작동한다. OpenCode 2.x 플러그인은 클라이언트가 종료되어도 작동하는 백그라운드 서비스에 로드되므로, 거기서 SessionEnd는 세션이 삭제되거나 서비스가 중지될 때만 발생하며, 라운드 종료 동기화(synchronization)는 Stop으로 매 라운드마다 수행된다. 단계: docs/v3/OPENCODE.md
OMP (Oh My Pi)의 경우 추가 단계가 필요하지 않습니다: installer vault 내에 .omp/hooks/pre/beyin-v3.ts를 작성하면, OMP vault 폴더에서 열릴 때 동일한 모터에 연결됩니다. 파일을 global agentDir로 복사하는 것은 vault 외부에서는 작동하지 않습니다. 단계: docs/v3/OMP.md.
Kiro IDE 1.x 및 CLI V3의 경우 이 리소스 체크아웃이 .kiro/hooks/beyin-v3.json과 .kiro/skills/를 설치합니다. Kiro에서 vault를 열고 hook을 검토하여 새 세션을 시작하세요. 이전 ZIP 패키지에는 이 파일들이 포함되어 있지 않을 수 있습니다. 리소스 설치 단계 및 클라이언트 제한: docs/v3/KIRO.md.
첫 대화
V3.1.0의 인격/지속성 행동: 새로운 설정 생각 파트너 정체성을 생성하고 시작 노트를 작성합니다. 기존 Core/Soul, 사용자 수정 사항, 활성 주제 및 마지막 세션 리소스가 시작 시 우선순위입니다. 영구 학습은 능동 에이전트에 의해 개념 및 연결 노트에 기록됩니다. V2/V3 비교 및 검증.
이 행동은 V3.1.0 및 이후 패키지에 포함됩니다.
에이전트에게 다음을 말하세요:
Beyin skill을 사용해 줘. 나를 알아가기 위해 짧은 질문들을 해주고, 답변들은 리소스 노트에 기록해 줘. 그리고 함께 하나의 과제를 만들고 다시 읽어보자.
설치된 세 가지 skill:
| Skill | 언제 사용되나요? |
|---|
| beyin | 노트를 찾거나, 정보를 저장하거나, 작업을 변경하거나, 작업 결과 및 교훈을 도출할 때 |
| ... | |
이들은 .agents/skills 아래에 위치하며, Claude와 Kiro는 자체 프로젝트 skill 복사본을 사용합니다. 추가하고 싶은 개인 skill은 별도로 가져올 수 있습니다. 동일한 이름의 다른 콘텐츠가 조용히 덮어쓰이지 않습니다. | |
일상적인 사용
노트를 작성하고, 에이전트에게 원하는 것을 말하세요. 리소스들은 세션 시작 및 대화의 적절한 지점에서 다시 인덱싱됩니다. 클라이언트가 꺼져 있을 때 지속적으로 검색하는 서비스는 없습니다. 중요한 작업 결과는 짧고 리소스 연결된 기록으로 보관되며, 모든 채팅 자체가 자동으로 정확한 정보로 변환된다고 주장되지는 않습니다.
Beyin은 채팅 내용을 저장하지 않습니다. Claude Code는 로컬 채팅 기록(~/.claude/projects/)을 기본적으로 30일 후에 삭제합니다. 영구적으로 보관하고 싶은 결정이나 정보는 노트에 작성하세요. 기간을 연장하려면 ~/.claude/settings.json 파일에 예를 들어 "cleanupPeriodDays": 365를 추가하십시오 (Claude Code 문서).
최근에 무슨 일이 있었는지 확인하려면 vault 폴더에서 python3 beyin.py recap --days 7을 실행하세요. 이 명령어는 최근부터 과거 순으로 출처 링크가 연결된 작업 결과를 나열하며, 모델 호출은 하지 않습니다. 이것들은 에이전트가 작성한 결과 주장일 뿐, 독립적으로 검증된 사실은 아닙니다. 개별 노트로 연결되는 링크는 숨겨지며, 삭제된 출처 목록은 표시되지 않습니다. --days (1-366)와 --limit (1-100)을 사용하여 기간과 길이를 변경할 수 있습니다.
특정 날짜 범위에 대해서는 --days 대신 --since와 --until을 사용하세요:
python3 beyin.py recap --since 2026-09-24 --until 2026-09-24만 해당 하루를 가져옵니다.
날짜만 작성할 경우 (YYYY-AA-GG), 컴퓨터의 로컬 날짜가 계산됩니다. 이는 daily/v3/ 파일 이름에 사용되는 날짜와 동일하며, --until은 그날의 끝까지 포함합니다. 시간을 지정하려면 끝에 Z 또는 시간대 오프셋을 추가하세요 (2026-09-24T18:30:00+03:00). 오직 --until만 제공하면 하한선이 없고, 오직 --since만 제공하면 범위는 오늘까지 지속됩니다.
--days는 이 두 옵션과 함께 사용할 수 없습니다.
문제가 발생하면 에이전트에게 **“beyin-doktor로 확인해 줘”**라고 말하세요. 터미널에서 vault 폴더 내에 다음 명령어를 실행합니다:
Windows에서는 동일한 명령어 앞에 py -3을 사용하십시오. 설치 시 사용자 지정 런타임 경로를 선택했다면, 설치된 beyin.py가 이미 이를 알고 있습니다.
선택 사항: 원터치로 Beyin에 접근하기
비디오, 트윗, 기사, 메일 또는 파일을 보는 곳에서 포착하여 에이전트가 텍스트를 추출하고 배운 내용을 knowledge/ 노트에 연결하도록 합니다. 설치는 한 번만 하면 됩니다: python3 beyin.py yakala kur (Windows에서는 py -3). 그 후 모든 애플리케이션에서 Mac에서는 Control+Option+B, Windows에서는 Ctrl+Alt+B; Linux의 KDE Plasma에서는 Ctrl+Alt+B (GNOME에서도 설치되지만 실제 데스크톱 환경에서는 아직 시도되지 않았습니다), 다른 데스크톱에서는 kur가 제공하는 명령어를 직접 단축키에 연결합니다; 브라우저에서는 Obsidian Web Clipper의 "뇌로 보내기(Beyne at)" 템플릿을 사용합니다. 키를 변경하려면 beyin.py yakala kisayol 'cmd+"'를 사용하세요. 에이전트에게 "포착된 것들을 처리해"라고 말하기만 하면 됩니다. YouTube의 경우, 먼저 자막을 사용하고, 그렇지 않으면 오디오만 로컬에서 텍스트로 변환됩니다. 상세 정보: docs/v3/YAKALA.md.
소비 및 제어 빈도
에이전트에게 “경제 모드로 전환(ekonomik moda geç)”, “자동 제어 끄기(otomatik kontrolleri kapat)” 또는 **“제어 간격을 30분으로 설정(kontrol aralığını 30 dakika yap)”**이라고 지시할 수 있습니다. 세 개의 클라이언트가 동일한 볼트 선호도를 사용하며, 업데이트는 이 선호도를 유지합니다.
| 모드 | 로컬 제어 | 세션에 추가되는 컨텍스트 |
|---|
| 일반 (기본값) | 관련 모든 클라이언트 이벤트 발생 시 | 세션 시작 및 메시지에서 최대 5000자 |
| ... | | |
시간이 만료되어도 스스로 작동하는 타이머는 설정되지 않습니다. 다음 클라이언트 이벤트가 제어를 시작합니다. 클라이언트를 닫았을 때는 처리가 이루어지지 않습니다. 로컬 Python 제어는 모델을 호출하지 않으므로 Luna/Sonnet에 대한 자동 비용이 없습니다. 에이전트에게 요청한 작업과 추가된 컨텍스트는 일반적인 클라이언트 소비량으로 계산됩니다. 경제 모드 또는 수동 모드에서 필요할 경우, context/sync 명령어를 통해 리소스를 새로 고칠 수 있습니다.
선택적 Jev 컨설턴트는 이와 별개입니다: 기본적으로 비활성화되어 있으며, 오직 자체 TypeSafe API 키를 가진 사람들을 위한 것이고, 창시자가 질문하거나 설정하지 않습니다. 상태는 python3 beyin.py jev status로 확인하며, jev shadow, jev on, 그리고 jev off로 변경할 수 있습니다. API 키가 필요 없는 로컬 옵션으로 별도로 설치된 오픈 웨이트 Laya 서버도 선택 가능합니다 (jev shadow --provider laya); Beyin은 PyTorch나 모델을 입력받지 않습니다. Laya는 오직 섀도우 모드에서만 작동하며: 측정 시 Jev보다 훨씬 약한 출력이기 때문에 점수들은 측정 및 프라이버시 테스트를 위해 기록되며, 보는 결과를 변경하지는 않습니다. 세부 정보 및 제한 사항.
환경 설정(Preferences): python3 beyin.py preferences. 경제적: preferences --profile economical. 수동: preferences --profile manual. 간격: preferences --interval-minutes 30. 옵트인 비밀 필터: preferences --secret-filter on. Windows에서는 py -3을 사용합니다. 세부 정보.
메모리 파일 크기
Last-Session.md는 마지막 세션의 전지(devir kart)이며 (세션당 ## YYYY-MM-DD HH:MM · <태그> · <session_id[:8]> 제목으로 열림, 세션은 자신의 카드만 편집함), Threads.md는 활성 주제의 최신 상태입니다. 둘 다 제자리에 업데이트되며, 아래에 추가되지 않습니다. 기본 제한은 3,000 및 8,000 문자입니다. 제한을 초과하면 세션 시작 컨텍스트가 한 줄짜리 Memory hygiene: 경고와 함께 열리고, doctor는 같은 정보를 표시합니다. 에이전트는 이때 python3 beyin.py companion-compact를 실행합니다: 오래된 섹션과 오래된 날짜의 기록은 글자 그대로 companion 폴더 안의 Arşiv/ 아래에 특별히 표시된 월별 파일로 이동됩니다. 어떤 텍스트도 삭제되거나 요약되지 않으며, 모델 호출이나 타이머 설정도 이루어지지 않습니다. 계획을 먼저 보려면 --dry-run, 제한을 변경하려면 preferences --last-session-chars 4000 --threads-chars 12000 (0은 비활성화)를 사용합니다. 세부 정보.
업데이트
에이전트에게 **“beynimi güncelle”**라고 말하거나 vault 내의 바로가기를 열 수 있습니다:
- macOS:
Beyni Güncelle.command
- Windows:
Beyni Guncelle.cmd
- Linux:
Beyni Güncelle.desktop 또는 Beyni Güncelle.sh
바로 가기는 동일한 업데이트 프로그램을 실행합니다. 터미널에서 먼저 확인하고 싶다면:
python3 beyin.py update --check
python3 beyin.py update
새 버전 확인은 기본적으로 켜져 있습니다: 세션 시작 시 별도의 프로세스가 하루에 최대 한 번 GitHub 버전 정보를 확인합니다. 프롬프트나 계정 정보를 전송하지 않으며, 모델을 호출하지 않습니다. 첫 번째 결과는 다음 세션 또는 doctor 출력에서 볼 수 있습니다. 동일한 버전에 대한 알림은 한 번만 표시됩니다. 자동 설치는 이루어지지 않습니다.
- 가벼운 확인:
python3 beyin.py update --check --metadata-only
- 알림 끄기:
python3 beyin.py preferences --update-notifications off
- 켜기:
python3 beyin.py preferences --update-notifications on
- 특정 버전 무시하기:
python3 beyin.py update --dismiss X.Y.Z
Windows에서는 python3 대신 py -3을 사용하세요. V3.0.2 설치에서는 새로운 옵션들이 첫 번째 update 작업 이후에 나타납니다.
기본 소스는 공식 GitHub stable release 패키지만입니다; 개발 브랜치에서 자동으로 코드를 가져오지 않습니다. 패키지가 게시되지 않았거나 액세스할 수 없으면 오류를 보고하며, 업데이트된 것처럼 작동하지 않습니다. 다운로드한 ZIP으로 오프라인 업데이트 및 롤백을 하려면 업데이트 가이드를 참조하세요.
V2에서 오는 경우
동일한 생성기를 기존 vault 위에서 실행합니다. 노트, Companion 파일, 이전의 daily/ 및 knowledge/ 내용은 보존됩니다. 인식된 이전 writer들은 복구 가능한 방식으로 비활성화되며; 사용자 지정 시스템 파일이나 작동 중인 이전 worker가 있으면 작업이 중단되고 설명이 제공됩니다.