Bolo

Bolo is built on open-source principles to guarantee security, privacy, and full reproducibility. All sensitive data transformations run locally on your hardware with zero telemetry or unexpected cloud dependencies.

## Key Technical Features & Capabilities
- **Native Desktop Architecture**: Engineered as a standalone desktop binary with near-instant startup and zero background telemetry.
- **Local-First Privacy**: Executes all core data transformations, media processing, and configuration storage 100% locally on your machine.
- **Optimized UI Workflow**: Apple Human Interface Guidelines-inspired design with dark mode, customizable keyboard shortcuts, and responsive layouts.
- **Zero Cloud Dependencies**: Operates completely offline without requiring cloud accounts, third-party analytics, or external API keys.

## Architecture & Technology Stack
- **Primary Languages**: Rust, Python / C++
- **Frameworks & UI Runtime**: Tauri 2, ONNX Runtime / Vulkan NCNN
- **Build Systems & Tooling**: Cargo
- **Supported Platforms**: macOS 12.0+ (Apple Silicon M1-M4 & Intel x86_64), Windows 10/11 x64, Linux

## System Requirements
| Specification | Minimum Requirement | Recommended Specification |
| :--- | :--- | :--- |
| **Operating System** | macOS 12.0 Monterey / Windows 10 x64 | macOS 14.0+ Sonoma / Windows 11 x64 |
| **Processor Architecture** | Apple Silicon (M1+) or Intel Core i5 x64 | Apple Silicon Unified Memory (M2/M3/M4) |
| **Memory (RAM)** | 4 GB Unified RAM | 8 GB+ High-Speed RAM |
| **Storage Space** | 300 MB available local disk space | 1 GB+ SSD storage |
| **GPU Acceleration** | Metal 2 / DirectX 12 compatible | Apple Neural Engine / Vulkan capable |

## Installation & Setup Guide
### macOS Installation (Recommended)
1. Download the verified `.dmg` release installer directly from CookApps.
2. Open the disk image and drag **Bolo.app** into your `/Applications` folder.
3. Launch Bolo via Spotlight (`Cmd + Space`) or Launchpad.

Alternatively, install using Homebrew if available:

### Windows Installation
1. Download the official installer package (`.exe` / `.msi`).
2. Run the executable and follow the setup wizard.
3. Launch **Bolo** from the Start Menu or desktop shortcut.

### Building from Source (Development Setup)

## How to Use & Workflow
1. **Application Launch & Workspace**: Open Bolo to load the responsive native workspace.
2. **Configuration & Preferences**: Press `Cmd + ,` (macOS) or `Ctrl + ,` (Windows) to configure hardware acceleration, custom directories, and display themes.
3. **Primary Operation**: Drag-and-drop source files or input parameters directly into the central window.
4. **Execution & Export**: Initiate the processing pipeline and verify output files saved directly to your chosen local directory.

## Troubleshooting & Common Issues
- **Problem**: macOS Gatekeeper displays *"App is damaged and can't be opened"* or unnotarized developer notice.
  - **Root Cause**: macOS quarantine flag set on binaries downloaded outside the Mac App Store.
  - **Resolution**: Open Terminal and run: