personal memory agent
install: document parakeet linux path + cross-platform install flow
Rewrites the Parakeet section of INSTALL.md to cover both macOS
(Apple Silicon + Xcode CLT + FluidAudio helper) and Linux x86_64
(NeMo + torch via uv sync --extra parakeet-nemo, ~2.4 GB HF cache).
make install now runs the right prep step per OS, so the manual
instructions are simplified to the config snippet plus one bullet
per platform.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+5
-5
+5
-5
INSTALL.md
+5
-5
INSTALL.md
···
45
45
brew install git uv
46
46
```
47
47
48
-
#### Parakeet backend (optional, macOS only)
48
+
#### Parakeet backend (optional, macOS + Linux)
49
49
50
-
- Apple Silicon only. the helper is not supported on Intel macs or linux.
51
-
- Xcode command line tools are required because the helper is a Swift package; if the `xcodebuild -version` check above fails, fix that first.
52
-
- Build the helper from the repo root with `make parakeet-helper`.
53
50
- Enable it by setting `journal/config/journal.json`:
54
51
55
52
```json
···
58
55
"backend": "parakeet",
59
56
"parakeet": {
60
57
"model_version": "v3",
58
+
"device": "auto",
61
59
"timeout_sec": 120.0
62
60
}
63
61
}
64
62
}
65
63
```
66
64
67
-
- first run downloads roughly 461 MB of model data into `~/Library/Application Support/solstone/parakeet/models`.
65
+
- `device: "auto"` is primarily for Linux; macOS always routes to the CoreML helper on Apple Silicon.
66
+
- **macOS (Apple Silicon):** Xcode command line tools are required because the helper is a Swift package; if the `xcodebuild -version` check above fails, fix that first. `make install` runs `make parakeet-helper` automatically, and the first run downloads roughly 461 MB of model data into `~/Library/Application Support/solstone/parakeet/models`.
67
+
- **Linux (x86_64):** `make install` runs `uv sync --extra parakeet-nemo` automatically to install NeMo + torch. The first run downloads roughly 2.4 GB of model data into `~/.cache/huggingface/hub/`. CUDA is optional; `device: "auto"` falls back to CPU when no GPU is available.
68
68
- helper contract details live in `observe/transcribe/parakeet_helper/README.md`.
69
69
70
70
## install