VLog Human Memory Engine

VLogは、VRChatのEvidenceからreview可能なHuman Memory、Narrative Artifact、明示承認されたPublic Projectionを生成する公開OSSエンジンです。

このREADMEは入口とセットアップだけを担当します。仕様・保証・運用詳細をここへ複製しません。

Start here

目的	正準
公開Reader	KafLog
製品仕様・動作保証	docs/SPEC.md
文書マップ	docs/README.md
Human Memory v2	docs/architecture/human-memory-v2.md
現行runtime	docs/architecture.md
portability	docs/architecture/portability.md
運用	docs/OPERATIONS.md
保守	docs/MAINTENANCE.md
agent router	AGENTS.md

Repository boundaries

apps/       deployable applications
packages/   storage非依存domain capabilities
adapters/   persistence・storage・external integrations
infra/      systemd・Windows・Supabase assets
schemas/    versioned interchange contracts
docs/       specification・architecture・operations・ADRs

Python runtimeはuv workspace上のvlog_capture packageです。製品操作はvlog、運用診断はvlog-operations、repository orchestrationはtaskを使います。

Setup

必要環境はPython >=3.12,<3.13、uv、Task、Readerを扱う場合はBunです。

git clone https://github.com/KAFKA2306/vlog.git
cd vlog
task setup
cp .env.example .env
export VLOG_ENV_FILE="$PWD/.env"

.env.exampleのVLog runtime設定はVLOG_*だけを受け付けます。systemdではrepository内.envを使わず、必要ならVLOG_ENV_FILEへ明示的な絶対パスを設定します。

実録音・文字起こし・同期には対象hostのaudio device、VRChat、GPU/model、network、credentialが別途必要です。secretやprivate Evidenceをcommitしません。

Commands

uv run --frozen vlog --help
uv run --frozen vlog daily
uv run --frozen vlog-operations --help
task verify

taskはbuild、test、deployment、infrastructure、maintenanceなどrepository作業に限定します。製品CLIのaliasはTaskfileへ重複させません。

Verification boundary

Repository/CIの成功と、actual host・audio・GPU・systemd・Windows Task Scheduler・Supabase・Vercel・object storageのenvironment verificationは別です。保証レイヤーの定義はdocs/SPEC.mdを正準とします。

Raw Evidence、private memory、credential、redaction前logは公開repositoryへ保存しません。公開物は明示的なpublication decisionを経たprojectionだけです。