Coralyst

Coralyst is a macOS SwiftUI application for monitoring reef sites, their hydrophones, acoustic-health snapshots, and blast-detection alerts.

Open the project

Open Coralyst.xcodeproj in Xcode, select the CH5_Biorocks scheme, and run the macOS target. The project uses a file-system-synchronised Xcode group, so Swift files placed under CH5_Biorocks/ are included automatically.

Python pipeline (Python/)

The Simulator streams audio through reef_pipeline (vendored under Python/):

cd Python
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
export REEFGUARD_RAW_DATA="$HOME/Desktop/CH5/raw-data"

With the app running, use Simulator → Start stream, or from a terminal:

.venv/bin/python -m reef_pipeline stream --fleet --realtime

For an exhibition demo (separate beach/sea scene window + live detections in the app):

.venv/bin/python -m reef_pipeline exhibit --loop

Or pick Exhibition in the Simulator UI. Place the two windows side by side.

Source layout

CH5_Biorocks/
├── App/                 App entry point, shell, sidebar, and routing
├── Core/                Domain models and the shared design system
├── Data/                Persistence-facing stores
├── Features/            User-facing workflows grouped by feature
├── Services/            Audio input, networking, and detection pipeline
├── Shared/              Reusable feature-level UI, such as alert cards
└── Resources/           Bundled classifier resources
Python/                  reef_pipeline (simulate / stream / detect / features)

Ownership rules

• Put generic visual primitives in Core/DesignSystem.
• Put UI reused by multiple features, but still specific to Coralyst, in Shared.
• Keep complete screens and their feature-only components in Features.
• Keep audio capture, networking, and detection logic in Services.
• Keep SwiftData models in Core/Domain/Models; do not duplicate them in feature folders.

Runtime behavior

• SwiftData persists Sites, Hydrophones, health snapshots, and alert events.
• Debug builds bootstrap the simulator and start the local hydrophone ingress server. Release builds do not start that debug-only server from the app shell.
• The app's microphone selection UI uses the macOS audio-input permission.
• Blast alerts are tagged with domain scope indonesia_hydromoth.

Documentation

• Privacy policy
• Support
• Python pipeline