mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-20 13:03:14 +00:00
48bac85cbef8a8d2ed7b68584308d478b69aae5d
Phase 3 of the voice-assistant design: assistant.backend=external routes utterances over a dial-out websocket to faceclaw-agent-bridge (an OpenClaw plugin on the user's machine). The phone serves its ToolRegistry as MCP on the same socket, with proactive gating and rate limiting enforced locally. New Assistant settings section with backend/bridge settings. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XCdkQyB3RUVPTuEmhxVEdp
Add scripts/update_deltas.sh for updating in-app firmware updater to latest custom firmware versions
# Faceclaw - An unofficial user interface for the Even Realities G2 smart glasses This is an unofficial user interface for the Even Realities G2 smart glasses. It is entirely unofficial, and comes with no support or warranty from Even Realities or from anyone. This app runs on Android, and requires installing custom firmware on the glasses. The Android app itself can install and uninstall the custom firmware; it downloads the stock firmware from Even and applies patches generated from https://github.com/jimrandomh/g2flash. ## Installation To compile, you will need an Android SDK environment with SDK version 35 installed and licenses accepted, and the ANDROID_HOME pointing to the install. You will need Nativescript installed, and a JDK environment (v21), with the JAVA_HOME environment variable pointed at it. You will also need a reasonably up to date npm and nodejs installed. To install a version that you compiled, you will need `adb` connected. Go to Settings>About phone and tap the "Build number" field seven times. Then plug the phone's USB-C port into your computer, authorize access on the phone, then run `nativescript run android The compile, run 'npm run build' To install, run `nativescript run android --juslaunch` ## Features * A voice assistant that wakes up when you say "Hey Even", transcribes text with an on-device model, OpenAI Whisper, or ElevenLabs API, and responds to queries and commands using an Anthropic or OpenAI model (requires an API key). * Multitasking, with an app-switcher sidebar and app launcher * Supports full-screen apps using the full 640x480 display area (rather than the 576x288 that EvenHub apps can use) * Integration with Android notifications: A top-bar that shows the same icons your phone does, popups when notifications arrive, and menu items to dismiss or use Android-app-provided custom actions like mark as read or quick reply. * Mirror terminal apps such as Claude Code or Codex CLI with g2mirror (https://github.com/jimrandomh/g2mirror), view them on the glasses, and send them inputs with the voice assistant * Media player controls including playlist and media library navigation, compatible with most Android media players * Turn-by-turn directions (requires a Mapbox API token) * Nightscout, an app for viewing blood-glucose data (requires a cloud server and API token) * Power management: the glasses go to sleep properly when the screen is off, and wake when you double-tap the ring or speak the wakeword, allowing battery life similar to the stock Even app. * Connection management with auto-reconnect, and autodetection of conflict with the official Even Realities app * On-phone screen mirroring and simulated ring input * Dual-language NativeScript architecture with Java for the multithreaded Android API and bluetooth stack bits, Typescript for the bits you want to hack on ## Additional Caveats Some permissions are used, but may not reliably prompted for. Go to Android Settings > Apps > Faceclaw to ensure permissions are available or things may not work. Being a background app on a locked Android phone is fraught, and there may be issues with manufacturer-psecific battery optimization software that lead to it getting paused, throttled to low CPU usage, etc.
Releases
1
Whisper Small French int8 v1
Latest
Languages
TypeScript
50.8%
Kotlin
24%
JavaScript
13.8%
C
5.6%
Objective-C
1.9%
Other
3.9%