← terug naar AI Infrastructuur

Anna v1 — Architectuur

iOS voice-agent met realtime Grok, vault-bridge en lokale tools

Anna v1 — architectuur iOS voice-agent met realtime Grok, vault-bridge, lokale tools. 5 mei 2026. spraak WebSocket realtime · PCM16 24kHz X-App-Secret → ephemeral token master key research vault r/w PAT deep-link generatie · geen API-call Onno iPhone / iPad Anna iOS-app com.terwisscha.assistente-onno Audio I/O AVAudioEngine · voice processing · float32 Voice WebSocket client xai-client-secret protocol · reconnect-loop LOKALE TOOLS EventKit lees_agenda · privacy-blacklist UN Notifications stuur_bericht_naar_onno · lokaal, geen ntfy ConversationLogger Documents/anna-log.txt · Files-app REMOTE TOOLS (via Worker) zoek_en_bewaar · search_obsidian append/upsert · get_note_content stel_afspraak_voor Google Calendar deep-link · geen API-key Cloudflare Worker praatmet.terwisscha.com /session ephemeral xAI token · 5 min TTL /research Live Search · Responses API · markdown /vault/private/* search · get · append · upsert SECRETS XAI_API_KEY master, alleen hier APP_SHARED_SECRET client-auth GITHUB_VAULT_PAT fine-grained, R/W Grok Voice Agent Ara stem · ~1s latency grok-voice-think-fast-1.0 xAI Live Search Responses API · web_search tool GitHub vault-private Anna's tweede brein commits als Anna <anna@terwisscha.com> Google Calendar deep-link template · iOS opent app LEGENDA User · mens-machine-interface Frontend (iOS-app) Backend (Worker) External AI / Database Auth / secrets WebSocket realtime HTTPS

User — Onno aan de microfoon

  • • Stick-figure aan de linkerrand maakt de interface-grens letterlijk zichtbaar
  • • iPhone én iPad als entry-points
  • • Anna hoort spraak via apparaat-mic + voice processing
  • • Geen alternatief invoer-kanaal: voice-only

Frontend — Anna iOS-app

  • • `com.terwisscha.assistente-onno`, native SwiftUI
  • • AVAudioEngine met voice processing + reconnect-loop
  • • Lokale tools: EventKit (agenda), UN Notifications, ConversationLogger
  • • Remote tools via Worker: vault r/w, research, afspraak-voorstel
  • • Geen API-keys in de bundle

Backend — Cloudflare Worker

  • • `praatmet.terwisscha.com`, edge-deployed
  • • `/session` geeft ephemeral xAI tokens (5 min TTL)
  • • `/research` proxy naar xAI Live Search
  • • `/vault/private/*` bridge naar GitHub-vault
  • • Drie secrets (XAI master, app shared secret, GitHub PAT) blijven hier

External — Grok, Search, Vault, Calendar

  • • Grok Voice Agent (Ara-stem, ~1s latency) via WebSocket realtime
  • • xAI Live Search via Responses API + web_search tool
  • • GitHub vault-private = Anna's tweede brein, commits als Anna
  • • Google Calendar via deep-link template, geen API-call nodig

Anna v1 architectuur • 5 mei 2026 • Voice-agent met realtime Grok + vault-bridge + lokale tools