Eidolon
Local-First AI Companion: Expo Mobile Client Paired with Bun Gateway
01.The Problem & Why Naive Implementations Fail
Cloud AI companions compromise privacy, leak personal context, and break without internet access. Local models require complex configuration across mobile and desktop environments.
02.Architectural Solution & Engineering Decisions
Architected a LAN-paired local companion system with typed Zod protocols between Expo and a Bun+Hono conductor. Includes a built-in preflight 'doctor' CLI, automated Android APK release tooling, and a theme token studio.
Key Architectural Highlights
Zero-Cloud LAN Pairing Protocol
End-to-end encrypted session negotiation over local Wi-Fi, routing inference requests directly to on-premise hardware without third-party API exposure.
Theme Studio & CSS Token Engine
Dynamic theme engine with CSS variables, runtime font switching, and customizable palettes previewed in real-time.
Automated Toolchain Doctor
Custom CLI verifying JDK, Android SDK/NDK, Bun, and Node versions, automatically installing safe missing components.