# 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.10 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.5
```

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.

## Connect the reference data library

The public utility package deliberately excludes authored camera, character
motion, and source audio data. Obtain the access-controlled `CW-AI` data
library separately with Git LFS and use one of these layouts:

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 automatically finds the worker inside the installed
package and validates the 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.