arche-pkm

アリストテレスの3アルケー原理に基づく RAG + LLM 統合 PKM システム

---

概要

arche-pkm は、アリストテレスの形而上学的概念「アルケー（根本原理）」を現代的な PKM（Personal Knowledge Management）システムに転用した、RAG + LLM 統合型知識管理基盤である。

単なるノートアプリではない。Zettelkasten の哲学的核心を抽出し、それを生成AIのアーキテクチャとして再実装したシステムだ。

---

3アルケー → 3技術レイヤー

アリストテレスが提唱した「知識の根本構成要素」をシステムの 3 レイヤーに直接マッピングする：

アルケー	哲学的原理	技術レイヤー	実装コンポーネント
原子性 (Atomicity)	1概念 = 1単位。Miller's Law：人間が同時処理できる情報は7±2	Note Ingestion + Atomic Chunking Engine	src/ingestion/
接続性 (Connectivity)	意味は関係の中に宿る。知識はネットワークである	pgvector Atomic Store + Knowledge Graph Layer	src/store/, src/graph/
再表現 (Re-expression)	書くことは考えることの検証。Feynman Technique	LLM Synthesis + Re-expression Engine	src/synthesis/, src/reexpression/

---

システム全体像

┌─────────────────────────────────────────────────────────────────────┐
│                         USER INTERFACE LAYER                        │
│              (Obsidian Plugin / CLI / REST API / Web UI)            │
└──────────────────────────────┬──────────────────────────────────────┘
                               │
┌──────────────────────────────▼──────────────────────────────────────┐
│                    INGESTION PIPELINE  [原子性]                      │
│   Markdown / PDF / URL → Parser → Atomic Chunker → Embedder         │
└──────────┬──────────────────────────────────────────────────────────┘
           │
     ┌─────▼──────────────────────────────────────────┐
     │              ATOMIC STORE  [原子性+接続性]       │
     │    Supabase PostgreSQL + pgvector (HNSW index)  │
     └─────┬──────────────────────────────────────────┘
           │
     ┌─────▼──────────────────────────────────────────┐
     │          KNOWLEDGE GRAPH LAYER  [接続性]         │
     │   Entity Extraction → Relation Mapping →         │
     │   Community Detection (Leiden Algorithm)         │
     └─────┬──────────────────────────────────────────┘
           │
┌──────────▼──────────────────────────────────────────────────────────┐
│                 HYBRID RETRIEVAL ENGINE  [接続性]                    │
│   Vector Similarity (local) ← Query Router → Graph Traversal (global)│
└──────────┬──────────────────────────────────────────────────────────┘
           │
┌──────────▼──────────────────────────────────────────────────────────┐
│                   LLM SYNTHESIS LAYER  [再表現]                      │
│      Agentic RAG Orchestration → Self-RAG → Citation Grounding       │
└──────────┬──────────────────────────────────────────────────────────┘
           │
┌──────────▼──────────────────────────────────────────────────────────┐
│                 RE-EXPRESSION ENGINE  [再表現]                       │
│   Feynman-style Rewriting → Personalized Synthesis → Link-back       │
└─────────────────────────────────────────────────────────────────────┘

詳細は ARCHITECTURE.md を参照。

---

リポジトリ構造

arche-pkm/
├── README.md                    # このファイル
├── docs/
│   ├── ARCHITECTURE.md          # 完全システム設計仕様
│   ├── ARCHE_PRINCIPLES.md      # アルケー原理の哲学的背景
│   ├── API_REFERENCE.md         # REST API仕様
│   └── DEPLOYMENT.md            # デプロイガイド
├── diagrams/
│   ├── system_overview.png      # システム全体図（nano-banana生成）
│   ├── arche_layers.png         # 3アルケーレイヤー図（nano-banana生成）
│   └── *.mermaid                # Mermaid図ソース
├── schema/
│   ├── pgvector_schema.sql      # Supabase pgvectorスキーマ定義
│   └── graph_schema.cypher      # Neo4j/知識グラフスキーマ
├── scripts/
│   ├── setup_supabase.py        # Supabase初期化スクリプト
│   └── ingest_obsidian.py       # Obsidianボルト一括取り込み
└── src/
    ├── ingestion/               # [原子性] ノート取り込み・チャンキング
    ├── store/                   # [原子性+接続性] pgvectorストア
    ├── graph/                   # [接続性] 知識グラフ構築
    ├── retrieval/               # [接続性] ハイブリッド検索エンジン
    ├── synthesis/               # [再表現] LLM合成レイヤー
    └── reexpression/            # [再表現] Feynman再表現エンジン

---

クイックスタート

# 1. リポジトリをクローン
git clone https://github.com/ohyesiamy/arche-pkm.git
cd arche-pkm

# 2. 依存関係をインストール
pip install -r requirements.txt

# 3. Supabase pgvector スキーマを初期化
psql $DATABASE_URL < schema/pgvector_schema.sql

# 4. Obsidianボルトを取り込み
python scripts/ingest_obsidian.py --vault ~/ObsidianVault

# 5. クエリを実行
python -m src.synthesis.query "Zettelkastenにおける接続性の哲学的意義とは"

---

技術スタック

カテゴリ	技術選定	根拠
Vector Store	Supabase + pgvector	PostgreSQL互換、HNSW index、< 10M vectors で十分
Embedding Model	text-embedding-3-large (OpenAI)	3072次元、多言語対応
LLM	GPT-4o / Claude 3.7 Sonnet	Agentic RAG オーケストレーション
Knowledge Graph	NetworkX (小規模) / Neo4j (大規模)	Leiden community detection
Chunking	LlamaIndex SentenceSplitter	512トークン、50トークンオーバーラップ
Orchestration	LangGraph	状態機械としてのAgentic RAGフロー
API	FastAPI	非同期、型安全
Obsidianプラグイン	TypeScript + Obsidian API	ネイティブ統合

---

ライセンス

MIT License. See LICENSE.

---

Built on the philosophical foundations of Aristotle's Arche — the first principles of knowledge.