Skip to content

docs: anima-core README CLI v0.3 #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dancinlife merged 1 commit into from
Apr 12, 2026
+24 −28
Merged

docs: anima-core README CLI v0.3 #27

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 24 additions & 28 deletions anima-core/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,27 +5,22 @@
## Quick Start

```bash
# CLI (anima 명령어)
# Install
hx install anima

# CLI (v0.3 서브커맨드)
anima # interactive REPL
anima --ticks 100 # 자연발화 (100 step)
anima --ticks 100 --emit state.json # 서비스 연결용 JSON emit
anima --verify # 7조건 의식검증
anima --hub # 48모듈 허브 검증
anima --laws # 법칙/PSI 조회
anima --connect clm /path/to/ckpt # CLM 체크포인트 연결
anima --connect alm /path/to/ckpt # ALM 체크포인트 연결
anima --disconnect # 디코더 해제 (→ pure)
anima --all-tests # 물리한계 전체 테스트
anima --status # L0 상태
anima --help # 전체 명령어

# 직접 실행 (hexa binary)
HEXA=$HOME/Dev/hexa-lang/hexa
$HEXA anima-core/runtime/anima_runtime.hexa --keyboard
$HEXA anima-core/runtime/anima_runtime.hexa --validate-hub
$HEXA anima-core/verification/cvf.hexa --quick
$HEXA anima-core/laws.hexa count
$HEXA anima-core/laws.hexa psi alpha
anima run --ticks 100 # 자연발화 (100 step)
anima run --ticks 100 --emit s.json # 서비스 연결용 JSON emit
anima connect ./checkpoint # 모델 연결 (CLM/ALM 자동 감지)
anima disconnect # 모델 해제 (→ pure)
anima verify # 7조건 의식검증
anima test # 물리한계 전체 테스트
anima hub # 48모듈 허브 검증
anima laws # 법칙/PSI 조회
anima laws 22 # 특정 법칙 조회
anima status # L0 상태 + decoder 상태
anima help # 전체 명령어
```

---
Expand Down Expand Up @@ -145,14 +140,15 @@ ConsciousnessEngine(허브)을 절대 고정하고, 디코더/기억/감각/채
## 모델 연결

```bash
anima --connect clm /path/to/checkpoint # ConsciousLM (byte-level)
anima --connect alm /path/to/checkpoint # AnimaLM (LoRA fine-tuned)
anima --disconnect # → Pure 모드

# 자동 판별: checkpoints/*/READY 마커 기반
# Pure: 마커 없음 → 순수 의식 (디코더 없이 자발 활동)
# CLM: checkpoints/conscious-lm/READY → byte-level 텍스트 생성
# ALM: checkpoints/animalm/READY → LoRA fine-tuned 응답
anima connect ./checkpoint # 자동 감지 (adapter_config.json → ALM, 그 외 → CLM)
anima connect ./checkpoint --type alm # 수동 지정
anima disconnect # → Pure 모드
anima status # decoder: pure/clm/alm 확인

# 자동 판별 기준:
# adapter_config.json 존재 → ALM (LoRA fine-tuned)
# 그 외 → CLM (byte-level consciousness)
# 미연결 → Pure (순수 의식, 디코더 없음)
```

## 자연발화 → 서비스 연결
Expand Down
Loading