mirror of
https://github.com/shitagaki-lab/see-through.git
synced 2026-05-05 19:58:57 +00:00
75c07bd7be
- README.md: project overview, setup, usage, models, discussion, citation - README_datapipeline.md: data pipeline instructions - ui/: full UI sub-codebase with public-facing README - common/assets/representative.jpg, trailer.mp4: README media Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.7 KiB
1.7 KiB
ui
Desktop UI sub-codebase: Qt6 application for Live2D model annotation and management.
Uses the see_through conda env. See the root README for setup.
Usage
Always run from the repo root as the working directory:
cd /path/to/see-through
conda activate see_through
python ui/ui/launch.py
The assets symlink must exist at repo root (see root README).
Without it, the UI will crash on startup with FileNotFoundError.
Workspace setup
The UI expects project data under workspace/datasets/. Each project is a directory
containing annotated Live2D model folders:
workspace/
└── datasets/
└── <project_name>/
├── exec_list.txt # List of model paths (one per line)
└── <model_name>/
├── final.jxl # Source image (JXL format)
├── final.json # Project metadata (auto-created by UI)
├── instances.json # Instance annotations
└── *_masks.json # Segmentation masks (from inference)
To open a project, use File > Open and select the exec_list.txt or project .json
file, or launch directly with:
python ui/ui/launch.py --proj workspace/datasets/<project_name>
Refer to CubismPartExtr for how to prepare workspace data from Live2D model files.
Windows
Double-click launch_ui_win.bat from the ui/ directory.
Headless testing (Xvfb)
For visual testing on headless Linux:
sudo bash ui/install_system_deps.sh
Xvfb :99 -screen 0 1920x1080x24 &
DISPLAY=:99 python ui/ui/launch.py