OZ
OPERATION WORLD STUDIOBuild Your Own OZ
◆ Self-Host · 당신의 데이터, 당신의 지휘 화면

당신의 로컬에
고유 OZ Vault 를 세우세요

흩어진 공개출처를 검증 가능한 지식 자산으로 자산화하고, 그 위에서 OZ 대시보드를 직접 띄웁니다. 데모를 구경하는 것을 넘어 — 당신의 자료로 같은 시스템을 운용합니다.

당신의 소스PDF · MD · 메모 init-vault고유 Vault 골격 VaultForgeL0→L4 자산화 serve당신의 대시보드
🔒 전부 로컬·에어갭 — Ollama 임베딩, 외부 인터넷 불필요 (헌법 Art.2)
Python 3.11+python --version
Ollamaollama.com ↗ · 로컬 LLM/임베딩
Gitgit --version
1

플랫폼 설치 + 모델 준비

repo 를 클론하고 의존성을 설치한 뒤, Ollama 모델 2개를 받습니다(한 번만).

# 클론 · 설치 · 모델 · 환경점검
git clone https://github.com/kth3188/oz-codex-core.git
cd oz-codex-core
python -m venv .venv && pip install -e ".[dev]"
ollama pull nomic-embed-text
ollama pull llama3.2:1b
python -X utf8 cli.py doctor
2

고유 Vault 생성

PARA × L0-L4 규약에 맞는 빈 Vault 골격을 만듭니다. 정본 온톨로지 규약이 함께 복사됩니다.

python scripts/init_vault.py --path ./my-oz-vault --name "My OZ"
my-oz-vault/ 00-system/ # 온톨로지·메타데이터 규약 (정본 복사) 10-projects/ # 진행 중 프로젝트 20-areas/ # 책임 영역 (example/ 예시 노트 2개) 30-resources/ # ★ 원본 소스 투입 위치 40-archive/ # 종료/보관 _TEMPLATE.md # 새 노트 frontmatter 템플릿
3

당신의 소스 투입

원본(PDF·MD)을 30-resources/ 에 두고, 직접 쓰는 노트는 _TEMPLATE.md 를 복사해 작성합니다.

규약 핵심(검증됨): 임베딩 필드 = title·분류·para_category·tags · para_category 정본 = 소문자 단수 area|project|resource|archive · 관련 노트는 [[wikilink]] 로 연결 → 그래프 엣지 자동 생성 · 모든 주장에 출처 명시(anti-puff).
4

VaultForge 자산화 + 대시보드 기동

Vault 를 가리키도록 환경변수를 주고 인덱싱한 뒤 서버를 띄웁니다. 같은 변수를 두 명령에 동일하게.

# Windows (macOS/Linux 는 set → export)
set VAULT_PATH=.\my-oz-vault
set COLLECTION_NAME=my_oz_vault
python -X utf8 cli.py ingest --force   # VaultForge: L0→L4 자산화
python -X utf8 cli.py serve            # → http://localhost:8000
브라우저에서 http://localhost:8000 접속 → 당신의 Vault 데이터로 채워진 OZ 지휘 대시보드 (COP · 참모 평가 · Anti-Puff · Vault Browser · 3D 온톨로지)가 뜹니다.

데모를 넘어 — 당신의 OZ 를 운용하세요

전체 단계와 트러블슈팅은 repo 의 QUICKSTART.md 에 있습니다. 완전 오프라인(망분리) 배포는 scripts/build_offline_bundle.py 로 단일 archive 를 만들어 운반합니다.