danielmiessler/Personal_AI_Infrastructure

개요 (Overview): PAI란 무엇인가 · 원칙 (Principles) · 기능 (Features)

시작하기 (Get Started): 설치 (Installation) · 릴리스 (Releases) · 팩 (Packs)

리소스 (Resources): FAQ · 로드맵 (Roadmap) · 커뮤니티 (Community) · 기여하기 (Contributing)

PAI 전체 워크스루 (walkthrough) 시청하기 | 읽어보기: The Real Internet of Things

중요 사항

PAI v5.0.0 — Life Operating System — PAI 역사상 가장 큰 규모의 릴리스입니다. PAI는 더 이상 "AI 스캐폴딩 (scaffolding)"이 아닙니다. 통합된 Pulse 데몬 (Life Dashboard: localhost:31337), DA (Digital Assistant, 디지털 어시스턴트) 정체성 레이어, Algorithm v6.3.0 (현재 상태 → 이상적 상태, 7단계, 분류기 기반 모드 + 티어), ISA 프리미티브 (보편적인 "이상적 상태" 표현), 45개의 기술 (skills), 171개의 워크플로우 (workflows), 37개의 훅 (hooks), 그리고 격리 구역 (containment zones)을 통한 구조적 프라이버시를 갖춘 **Life Operating System (삶의 운영 체제)**입니다.

v5.0.0 릴리스 노트 (release notes) → | 모든 릴리스 (All releases) →

한 줄 설치: curl -sSL https://ourpai.ai/install.sh | bash

v4.x에서 업그레이드하시나요? 이것은 패치가 아니라 완전히 다른 시스템입니다. 먼저 마이그레이션 가이드 (migration guide)를 읽어주세요.

PAI는 Life Operating System입니다. PAI는 당신이 누구인지, 무엇을 중요하게 여기는지, 그리고 어디로 가고자 하는지를 포착하며, 당신을 잘 아는 AI를 사용하여 그곳에 도달할 수 있도록 돕습니다. 세 가지 레이어가 서로 쌓여 구성됩니다:

PAI— OS 그 자체입니다. 기술 (skills), 메모리 (memory), 알고리즘 (Algorithm), 당신의 텔로스 (Telos), 당신의 정체성 파일 (identity files)을 포함합니다.
Pulse— localhost:31337에서 실행되는 Life Dashboard입니다. 당신의 상태, 목표, 그리고 작업 내용을 실제로 확인하는 곳입니다.
The DA— 당신의 디지털 어시스턴트 (Digital Assistant)입니다. 당신이 대화하는 목소리이자 인격입니다.

이 시스템은 개인을 우선적으로 설계되었지만, 동일한 아키텍처 (architecture)는 팀, 기업, 또는 자신이 되고자 하는 바를 명확히 정의하고 그 방향으로 나아가고자 하는 모든 엔티티 (entity)에 적용될 수 있습니다.

PAI는 도구가 아닌 인간을 중심에 둡니다. 기술은 사람의 삶을 개선하기 위해 존재하는 것이지, 그 반대가 아닙니다. 모든 설계 결정은 하나의 질문에서 시작됩니다: "이것이 이를 실행하는 사람에게 무엇을 해주는가?"

PAI는 당신이 중요하게 생각하는 것들 — 목표, 업무, 관계, 건강, 재정 — 을 포착하고, 이 모든 영역에서 당신의 이상적인 상태 (Ideal State)를 추구할 수 있도록 돕습니다. PAI는 코드를 작성하고, 에이전트 (Agents)를 실행하며, 사람들이 AI 툴링 (AI tooling)과 연관 짓는 일들을 수행하지만, 그것들은 더 큰 목표를 위한 기능일 뿐입니다. 핵심은 도구가 아니라 당신의 삶입니다.

AI의 가장 큰 미해결 과제는 특정 작업에 대해 무엇이 실제로 "좋은" 것인지 또는 "완료된" 것인지를 아무도 정의할 수 없다는 점입니다. PAI는 이상적인 상태 (Ideal State) — 구체적으로는 현재 상태에서 이상적인 상태로의 전환 — 라는 개념을 중심으로 구축되었으며, 이는 모든 계층에 스며들어 있습니다.

그 주요 표현 방식은 ISA (Ideal State Artifact, 이상적 상태 산출물)입니다. ISA는 소프트웨어 PRD (Product Requirements Document, 제품 요구사항 정의서)와 유사합니다. 즉, 당신이 그것을 향해 나아갈 수 있도록 완료된 상태가 어떤 모습인지를 포착합니다. 차이점은 ISA가 범용적이라는 것입니다. 디자인부터 예술, 철학, 엔지니어링, 전략에 이르기까지 모든 창의적인 작업에 적용될 수 있습니다. 시스템은 이상적인 상태를 개별적인 ISC (Ideal State Criteria, 이상적 상태 기준)로 분해하며, 이 기준들이 문서의 내용을 채우고 검증 항목의 역할도 수행합니다. 이것이 PAI가 모든 종류의 작업에서 이상적인 상태를 향해 힐 클라이밍 (Hill-climbing) 하는 방식입니다.

저는 2016년 'The Real Internet of Things'에서 이에 대해 썼으며, 그때보다 지금 더 확신하고 있습니다. 궤적은 명확합니다: 챗봇 (Chatbots) → 에이전트 (Agents) → 어시스턴트 (Assistants). 우리는 모두 같은 것을 만들고 있으며, 그 종착점은 1인당 1개의 DA (Digital Assistant)입니다.

TRIOT은 PAI가 구축된 네 가지 핵심 아이디어를 가지고 있었습니다:

디지털 어시스턴트 (Digital Assistants) — 1인당 1개의 DA, 모든 AI에 대한 당신의 기본 인터페이스
모든 것이 API가 된다 (Everything gets an API) — 모든 제품, 서비스, 사람, 장소가 주소 지정 가능해짐
당신의 DA가 인터페이스를 동적으로 생성한다 (Your DA dynamically creates your interfaces) — 더 이상 앱이나 대시보드는 필요 없음; DA가 그 순간 당신에게 필요한 것을 조립함
당신이 이상적인 상태를 정의하면, AI가 그곳에 도달하도록 돕는다 (You define your ideal state, AI helps you get there) — 시스템 전체가 당신의 텔로스 (Telos, 목적)를 향함

이것이 바로 PAI가 지향하는 바입니다.

일반 텍스트와 Markdown에 대한 강한 편향을 보입니다. PAI는 가능한 한 SQLite, Postgres 및 기타 불투명한 저장소를 피합니다. 모든 것은 투명하고 파싱 가능해야 합니다. — 당신에게, 당신의 DA(Data Analyst)에게, rg에게, 그리고 다른 무엇이든 간에.

만인의 AI 관련 실수는 큰 그림을 제공하지 못하는 것입니다. PAI는 근본적으로 가장 똑똑한 모델들에게 적절한 컨텍스트를 전달하기 위한 시스템입니다. — 당신에 대한 것, 당신이 달성하려는 것에 대한 것, 그리고 그들이 가지고 있는 도구들에 대한 것 — 이를 통해 그들이 실제로 당신의 이상적인 상태에 도달하는 데 도움을 줄 수 있도록 합니다. 모델 자체보다 주변 환경(컨텍스트)이 더 중요합니다.

컨텍스트 스캐폴딩의 반대 측면은 다음과 같습니다. 모델이 강력해질수록, 작업을 수행하는 방법에 대한 지침은 덜 필요하게 됩니다. 우리는 모델이 적절한 컨텍스트와 도구만으로 더 잘할 수 있는 곳에서는 지나치게 규정적인 방향을 제거하기 위해 PAI를 지속적으로 감사(audit)합니다. 시스템은 모델이 커짐에 따라 작아집니다.

PAI는 2025년 6월 이후로 RAG(Retrieval-Augmented Generation)를 피했습니다. 교차 참조가 있는 리치 텍스트와 ripgrep과 같은 빠른 검색 기능은 우리가 일반적으로 RAG에서 원하는 모든 것을 제공합니다. — 임베딩 복잡성, 검색의 불안정성, 또는 충실도 손실 없이 말입니다. 당신의 파일 시스템이 인덱스입니다.

당신이 무엇을 했는지, 무엇을 배웠는지, 그리고 보존할 가치가 있는 것이 무엇인지를 포착하고 — 이를 미래 작업에 입력으로 다시 공급하는 텍스트 기반 메모리 시스템입니다. 세 가지 계층(WORK, KNOWLEDGE, LEARNING)과 사람, 회사, 아이디어 및 연구 전반의 타입 그래프를 갖추고 있습니다.

PAI는 잘 된 것과 그렇지 않은 것에 대한 신호 — 명시적 평점, 감성(sentiment), 검증 결과, 만족도 — 를 포착하고 이를 사용하여 스스로 개선합니다. 작업을 실행하는 시스템이 곧 그것을 더 잘 수행하도록 개선되는 시스템인 것입니다.

과학적 방법론에 기반하여 현재 상태 $
ightarrow$ 이상적인 상태 전환을 구동하는 사용자 정의 알고리즘입니다. 이 알고리즘은

결정론적 코드 실행 (deterministic code execution)에 편향된 기술 시스템 (skill system)입니다. 계층 구조는 다음과 같습니다: 코드 $\rightarrow$ 코드를 실행하는 CLI $\rightarrow$ CLI를 호출하는 워크플로 (workflows) $\rightarrow$ 워크플로 간의 경로를 지정하는 SKILL.md. 기술 (skill)은 컨테이너이며, SKILL.md는 정문 역할을 하고, 실제 작업은 가능한 한 실제 코드 (real code)로 이루어집니다. 프롬프트 (prompts)가 코드를 감싸는 것이지, 코드가 프롬프트를 감싸는 것이 아닙니다.

시스템 전반의 의사결정 품질을 높이기 위해 알고리즘 (Algorithm)이 가져다 쓰는 의미 있는 맞춤형 사고 기술 (custom thinking skills) 라이브러리 — 제1원칙 (first principles), 위원회 토론 (council debates), 레드팀 (red team), 근본 원인 (root cause), 시스템 사고 (systems thinking), 반복적 심화 (iterative depth), 조리개 진동 (aperture oscillation) 등을 포함합니다.

주의 사항

활발히 개발 중인 프로젝트 — PAI는 빠르게 진화하고 있습니다. 파괴적 변경 (breaking changes), 구조 재편, 빈번한 업데이트가 발생할 수 있습니다.

우리는 AI 기반의 PAI 설치 및 수정을 강력히 신뢰합니다. 작동 가능한 설치가 완료되면, 당신의 AI가 시스템 자체를 가리키도록 하십시오. 버전을 업그레이드하고, 기술을 추가하며, 훅 (hooks)을 수정하고, 설정을 변경하며, 고장 난 모든 것을 수리하십시오. 당신의 AI가 초기에 당신을 위해 할 수 있는 가장 중요한 일은 기존의 모든 맞춤형 컨텍스트 (custom context) — 노트, 프로젝트 상태, 선호도, 정체성, 이력 — 를 PAI/USER/ 디렉토리로 가져오는 것입니다. 그래야 PAI가 첫날부터 당신이 누구인지 알 수 있습니다. 당신의 DA에게 다음과 같이 말하십시오: "내 컨텍스트를 PAI/USER/로 마이그레이션하는 것을 도와줘." 이 시스템은 AI에 의해 운영되도록 설계되었습니다. AI에 의존하십시오.

curl -sSL https://ourpai.ai/install.sh | bash

그게 전부입니다. 설치 마법사가 Bun, Git, Claude Code 검증, ElevenLabs 키 (선택 사항), DA 정체성 설정, 음성 선택기, Pulse launchd 등록 및 검증을 처리합니다. 기존의 ~/.claude/는 무엇인가 덮어쓰기 전에 ~/.claude.backup-{TIMESTAMP}로 자동 백업됩니다.

먼저 검사하는 것을 선호하시나요? 파이프 (piping)로 넘기기 전에 스크립트를 읽어보십시오.

git clone https://github.com/danielmiessler/Personal_AI_Infrastructure.git
cd Personal_AI_Infrastructure/Releases/v5.0.0
cp -R .claude ~
...

설치 프로그램은 다음을 수행합니다:

• Bun, Git, Claude Code 설치 여부 확인
• ElevenLabs API 키 입력 요청 (건너뛰기 가능 — 건너뛸 경우 음성이 데스크톱 알림으로 대체됨)
• DA (Digital Assistant) 정체성 위저드 실행 (이름 + 목소리 + 성격)
• Pulse를 launchd 서비스(com.pai.pulse)로 설정
• 유효성 검사 실행

open http://localhost:31337 # Life Dashboard

그 다음 Claude Code에서 /interview를 실행하세요. 귀하의 DA가 다음 단계를 안내할 것입니다:

Phase 1 — TELOS: 미션, 목표, 신념, 지혜, 도전 과제, 도서, 멘탈 모델 (Mental models), 내러티브 (Narratives)
Phase 2 — IDEAL_STATE: 당신에게 성공이란 어떤 모습입니까?
Phase 3 — Preferences: 도구, 관습, 작업 스타일
Phase 4 — Identity: 최종 DA 성격 튜닝

이것은 가장 중요한 단계입니다. TELOS가 없다면, 귀하의 DA는 최적화할 기준이 아무것도 없습니다.

중요

v5.0.0은 패치가 아닌 완전히 다른 시스템입니다. 설치하기 전에 **전체 마이그레이션 가이드 (full migration guide)**를 읽으십시오.

빠른 경로:

# 1. 기존 설치 항목 백업
cp -R ~/.claude ~/.claude.backup-$(date +%Y%m%d)
# 2. v5.0.0 설치 (위의 한 줄 명령어 사용) 또는 수동 클론(manual clone)을 통해 설치
...

v4.x 버전에 개인 콘텐츠(노트, 프로젝트 상태, 사용자 정의 규칙 등)가 있었다면, DA에게 다음과 같이 말하세요: "내 이전 콘텐츠를 PAI/USER/ 구조로 마이그레이션하는 것을 도와줘."

Migrate 스킬은 .md / .markdown / .txt, Obsidian, Notion, Apple Notes로부터 데이터를 입력받아 — 각 청크(chunk)를 v5 분류 체계(TELOS, KNOWLEDGE, PROJECTS, FEED 등)에 따라 분류하고 출처(provenance)와 함께 커밋합니다.

업그레이드 후 체크리스트:

• Pulse 작동 확인:
  curl -s http://localhost:31337/api/pulse/health | jq

• 음성 알림 확인:
  curl -s -X POST http://localhost:31337/notify -H "Content-Type: application/json" -d '{"message": "Hello from your DA"}'

• 대시보드 렌더링 확인:
  open http://localhost:31337

• PAI/USER/DA_IDENTITY.md에 DA 정체성 생성 여부

• PAI/USER/TELOS/ 아래에 TELOS 캡처 여부

Pack은 PAI를 설치하지 않고도 어떤 AI 코딩 하네스 (coding harness)에든 추가할 수 있는 독립적이고 AI 설치 가능한 기능 단위입니다. 각 Pack은 DA가 읽고 실행할 수 있는 자급자족형 프롬프트 (prompt)입니다. Pack 디렉토리를 가리키며 "이것을 설치해줘 (install this)"라고 말하기만 하면 나머지는 알아서 처리됩니다.

PAI는 Claude Code를 기반으로 네이티브하게 구축되었으며, 그 상태를 유지하도록 설계되었습니다. 우리가 Claude Code를 선택한 이유는 그 훅 시스템 (hook system), 컨텍스트 관리 (context management), 그리고 에이전트 아키텍처 (agentic architecture)가 개인용 AI 인프라를 위한 현존 최고의 기반이기 때문입니다.

PAI는 Claude Code를 대체하는 것이 아니라, Claude Code를 당신의 것으로 만들어주는 상위 레이어 (layer)입니다:

지속성 메모리 (Persistent memory)— 당신의 DA가 과거의 세션, 결정, 그리고 학습 내용을 기억합니다.
커스텀 스킬 (Custom skills)— 당신이 가장 자주 하는 일들을 위한 특화된 기능들입니다.
당신의 컨텍스트 (Your context)— 목표, 연락처, 선호도 등 모든 것을 다시 설명할 필요 없이 사용할 수 있습니다.
지능형 라우팅 (Intelligent routing)— "이것을 조사해줘 (research this)"라고 말하면 적절한 워크플로우 (workflow)가 자동으로 트리거됩니다.
자기 개선 (Self-improvement)— 시스템이 학습한 내용을 바탕으로 스스로를 수정합니다.

이렇게 생각하면 쉽습니다: Claude Code가 엔진이라면, PAI는 그것을 당신의 자동차로 만들어주는 나머지 모든 요소입니다.

Claude Code는 강력한 프리미티브 (primitives)인 훅 (hooks), 슬래시 명령어 (slash commands), MCP 서버, 컨텍스트 파일 (context files)을 제공합니다. 이것들은 개별적인 빌딩 블록 (building blocks)입니다.

PAI는 이러한 프리미티브를 기반으로 구축된 완전한 시스템입니다. PAI는 모든 것을 하나로 연결합니다: 당신의 목표가 스킬에 정보를 제공하고, 스킬이 메모리를 생성하며, 메모리가 미래의 응답을 개선합니다. PAI는 Claude Code의 빌딩 블록들을 일관된 개인용 AI 플랫폼으로 변모시킵니다.

PAI는 Claude Code 네이티브입니다. 우리는 Claude Code의 훅 시스템, 컨텍스트 관리, 그리고 에이전트 기능이 개인용 AI 인프라를 위한 최고의 플랫폼이라고 믿으며, PAI는 이러한 기능들을 최대한 활용하도록 설계되었습니다.

그럼에도 불구하고, PAI의 개념들 (스킬, 메모리, 알고리즘)은 보편적이며, 코드는 TypeScript와 Bash로 작성되었습니다. 따라서 커뮤니티 구성원들이 다른 플랫폼에 맞게 이를 조정하는 것을 환영합니다.

Fabric은 특정 작업을 위한 AI 프롬프트 (patterns) 모음입니다. 이는 AI에게 무엇을 물어볼 것인가에 초점을 맞추고 있습니다.

PAI는 당신의 DA가 어떻게 작동하는가에 대한 인프라(infrastructure)입니다—메모리(memory), 기술(skills), 라우팅(routing), 컨텍스트(context), 자기 개선(self-improvement). 이들은 상호 보완적입니다. 많은 PAI 사용자들은 Fabric 패턴을 자신의 기술(skills)에 통합합니다.

복구는 간단합니다:

먼저 백업하세요— 업그레이드 전에는 반드시 다음을 실행하세요: cp -r ~/.claude ~/.claude-backup-$(date +%Y%m%d)

USER/는 안전합니다— USER/에 있는 당신의 커스텀 설정(customizations)은 설치 프로그램이나 업그레이드에 의해 절대 건드려지지 않습니다.

설정은 덮어쓰는 것이 아니라 병합됩니다— 설치 프로그램은 identity 및 version 필드만 업데이트합니다. 당신의 훅(hooks), 상태 표시줄(statusline), 커스텀 설정(custom config)은 보존됩니다.

Git 기반— 모든 것을 버전 관리(version control)하고, 필요할 때 롤백(roll back)하세요.

기록이 보존됩니다— 당신의 DA의 메모리(memory)는 실수가 발생하더라도 유지됩니다.

DA가 수정할 수 있습니다— 당신의 DA가 이를 구축하는 것을 도왔으므로, 수리하는 것도 도울 수 있습니다.

재설치— 설치 프로그램을 다시 실행하세요. 기존 설치를 감지하고 지능적으로 병합합니다.