# External workstation installation

## Supported environment

- Windows 10/11 x64
- Unity 6000.0 or newer
- Git 2.14 or newer available on `PATH`
- Git LFS installed before Unity resolves the package

The bundled `CWCameraWorker` contains Python 3.12.13 and its inference
dependencies. Do not install Python on an artist workstation for this package.
The worker is an onedir build: `CWCameraWorker.exe` and its `_internal` folder
must remain together.

## Install from Git

In Unity Package Manager, choose **Add package from git URL** and enter:

```text
https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.20
```

The initial package download is large because the frozen Windows worker is
stored with Git LFS. If Git LFS was missing during the first resolve, install
it, remove the package lock entry, and add the package again.

## Reference data

Version 0.1.20 includes a compact, read-only `RuntimeData~` bundle with the
263 prepared reference songs, cut policy, and ranker model. An artist
workstation does not need a separate `CW-AI` checkout or Python installation.
If a newer access-controlled library is available, it remains an optional
override:

1. Put `CW-AI` next to the Unity project directory.
2. Set the `CWAI_ROOT` environment variable to its absolute path before
   launching Unity.
3. Open `Tools > Streamingle > AI 카메라 생성`, expand `고급 · 진단`, and
   choose the `참조 데이터 루트` manually.

A valid data root contains all of the following:

```text
CW-AI/
  DatasetExports/
  reports/training_index.json
  models/cut_ranker_v2.json
```

The generation window prefers the bundled `RuntimeData~` root and falls back
to the optional external root when explicitly configured. It validates the
selected reference data before enabling generation.

The reference library may be read-only. Generation caches are stored under
the current Unity project's `Library/CWAI` directory. Set `CWAI_CACHE_ROOT`
before launching Unity only when a different writable cache location is
required.

## First run

1. Open `Tools > Streamingle > AI 카메라 생성`.
2. Confirm the panel shows `Timeline 입력 확인 완료` after selecting a
   Timeline containing character animation and audio.
3. Leave `후보 풀도 새로 계산 (느림)` disabled for the normal fast path.
4. Run `전체 카메라 자율 생성`.

Generated files and caches are written to the Unity project, never into the
reference library or the immutable Package Cache.
