70 lines
1.7 KiB
Markdown
70 lines
1.7 KiB
Markdown
# afs_studio
|
|
|
|
Native C++17 visualization and training management application for AFS.
|
|
|
|
## Build
|
|
|
|
```bash
|
|
# From AFS repo root
|
|
cmake -S apps/studio -B build/studio
|
|
cmake --build build/studio --target afs_studio
|
|
```
|
|
|
|
## Run
|
|
|
|
```bash
|
|
./build/studio/afs_studio --data ~/src/training
|
|
```
|
|
|
|
## Install (local)
|
|
|
|
```bash
|
|
cmake --install build/studio --prefix ~/.local
|
|
# Ensure ~/.local/bin is on PATH
|
|
```
|
|
|
|
## CLI helpers
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|