afs/apps/studio/README.md

afs_studio

Native C++17 visualization and training management application for AFS.

Build

# From AFS repo root
cmake -S apps/studio -B build/studio
cmake --build build/studio --target afs_studio

Run

./build/studio/afs_studio --data ~/src/training

Install (local)

cmake --install build/studio --prefix ~/.local
# Ensure ~/.local/bin is on PATH

CLI helpers

python -m afs studio build
python -m afs studio run --build
python -m afs studio install --prefix ~/.local
python -m afs studio alias

Quick aliases

export AFS_ROOT=~/src/trunk/lab/afs
alias afs-studio='PYTHONPATH="$AFS_ROOT/src" python -m afs studio run --build'
alias afs-studio-build='PYTHONPATH="$AFS_ROOT/src" python -m afs studio build'

Data sources

• Training data path: AFS_TRAINING_ROOT if set, otherwise ~/src/training or ~/.context/training (override with CLI arg).
• Context graph: AFS_GRAPH_PATH or ${AFS_CONTEXT_ROOT}/index/afs_graph.json (defaults to ~/src/context or ~/.context).
• Dataset registry: AFS_DATASET_REGISTRY or ${AFS_TRAINING_ROOT}/index/dataset_registry.json.
• Resource index: AFS_RESOURCE_INDEX or ${AFS_TRAINING_ROOT}/index/resource_index.json.

Flags

• --data or --data-path: override training root
• --version: print version and exit

Features

• Dashboard: Training metrics overview
• Analysis: Quality score trends, domain breakdown
• Training Hub: Real-time training status
• Sample Review: Data quality inspection
• Text Editor: Built-in code editor
• Shortcut System: Customizable keyboard shortcuts (Ctrl+/)

Dependencies (auto-fetched)

• Dear ImGui (docking branch)
• ImPlot
• GLFW
• nlohmann/json