1| 2| 3| 4| 5| 6| Herald — Your self-hosted AI companion for iPhone & iPad 7| 8| 9| 10| 11| 12| 13| 14| 193| 194| 195| 196| 197| 211| 212| 213|
214|
215|
Self-Hosted • Private • Open Source
216| Herald 217|

Your AI. Your iOS. Your rules.

218|

219| A native iOS companion for your self-hosted AI. Streaming chat, voice mode, 220| health sensors, CarPlay, and widgets — all without your data leaving your infrastructure. 221|

222| 232|
233|
234| 235|
236| 237| 238|
239|
240| 241|

Deeply native. Deeply capable.

242|

243| Herald uses iOS APIs the way you want — HealthKit, CoreLocation, 244| CoreMotion, CarPlay, widgets, and push notifications are all first-class citizens. 245|

246| 247|
248|
249|
250|

Rich Chat

251|

Real-time streaming with full markdown rendering, syntax-highlighted code blocks, collapsible thinking blocks, tool call bubbles, and an editable canvas for AI-generated output.

252|
253| Streaming 254| Markdown 255| Canvas 256|
257|
258| 259|
260|
261|

Voice Mode

262|

Full-duplex voice conversations via OpenAI Realtime API over WebSocket. Voice Activity Detection, push-to-talk, Bluetooth headset support, and live transcript display.

263|
264| Full-Duplex 265| VAD 266| Bluetooth 267|
268|
269| 270|
271|
272|

Health & Sensors

273|

Real-time HealthKit integration for heart rate, steps, sleep, and workouts. CoreLocation background tracking, visit detection, and CoreMotion activity classification.

274|
275| HealthKit 276| Location 277| CoreMotion 278|
279|
280| 281|
282|
283|

CarPlay

284|

Full CarPlay interface for hands-free AI while driving. Voice-driven conversation, Siri integration, session browsing, message dictation, and navigation-aware context.

285|
286| Hands-Free 287| Siri 288| Navigation 289|
290|
291| 292|
293|
294|

Widgets & Live Activities

295|

Home Screen widgets for health stats and connection status. Lock Screen Live Activities for real-time streaming. Dynamic Island integration for voice sessions.

296|
297| Live Activities 298| Dynamic Island 299| Widgets 300|
301|
302| 303|
304|
305|

Security & Privacy

306|

All data stays on your infrastructure. Keychain storage for tokens, biometric protection, App Attest for push broker auth, and no data leaves your relay.

307|
308| Keychain 309| Self-Hosted 310| App Attest 311|
312|
313| 314|
315|
316|

Session Management

317|

Pin, archive, rename, and search conversations. Device-scoped session isolation, context window usage ring, model switching, and slash command autocomplete.

318|
319| Multi-Session 320| Search 321| Model Switch 322|
323|
324| 325|
326|
327|

Push Notifications

328|

APNs with silent push wakes the app when your agent has something to deliver. Rich notifications with message previews, reply actions, and push broker architecture.

329|
330| APNs 331| Silent Push 332| Rich Notifications 333|
334|
335| 336|
337|
338|

Camera & Photos

339|

Attach images from your camera or photo library. Voice mode can stream live camera context to your agent. Image compression and preview with full-screen viewer.

340|
341| Camera 342| Live Feed 343| Image Attach 344|
345|
346|
347|
348|
349| 350|
351| 352| 353|
354|
355| 356|

How it works

357|

358| Herald connects to your Hermes Agent runtime through a relay server on your infrastructure. 359| Your data never touches a third-party server. 360|

361| Herald Architecture Diagram 362|
363|
364| 365|
366| 367| 368|
369|
370| 371|

Always open. Always yours.

372|

373| Herald is MIT licensed. Every line of code is yours to build, modify, and distribute. 374| No gates. No license keys. No activation servers. 375|

376| 377|
378|
379|

Compile it yourself. Get everything.

380|

381| Clone the repo, run xcodegen generate, build to your device. 382| Every feature — voice mode, HealthKit, CarPlay, widgets, the whole stack — 383| is yours. No trial, no paywall, no upsell. Just code. 384|

385|
386| MIT License 387| No Subscriptions 388| No Activation 389| Full Features 390| Forever Free 391|
392| 393| 394| View on GitHub 395| 396|
397|

398| git clone https://github.com/fireishott/Herald.git — 399| that's it. No signup, no license server, no account required. 400|

401|
402|
403| 404|
405| 406| 407|
408|
409| 410|

Built for iOS, powered by you.

411|

412| Herald is written in Swift 6.2 with SwiftUI at its core and UIKit where it matters. 413| The relay is Python + FastAPI. Everything is MIT licensed. 414|

415|
416|
417|

iOS App

418|

Swift 6.2, SwiftUI, UIKit. iOS 18+ deployment target with full iPad and CarPlay support.

419|
420|
421|

Relay Server

422|

Python, FastAPI, WebSockets, SSE. Docker deployable in one command.

423|
424|
425|

MCP Connector

426|

Python MCP protocol implementation. Plugs into any Hermes Agent runtime.

427|
428|
429|

Open Source

430|

MIT license. Always free to build, modify, and distribute. No hidden agendas.

431|
432|
433|
434|
435| 436| 437| 449| 450| 451| 452|