How yydye/internalbeyond works
Project-IB is a local-first personal AI companion spanning desktop/web, local services, and an Android Home Node client. Its principal workflow is a user interacting with a companion feature, which may call a configured AI provider and persist or synchronize personal data locally. The graph preserves documented product areas and separates the Home Node, Bridge, Active scheduler, and optional work-mode runtime. Some capability links come from the README; unsampled internals are represented only where the tree supports a path.
Main entry points: apps Desktop / web · home-node-service.js Home Node service · active-message-service.js Active messages · ib-bridge-service.js Bridge API
Components 25
User experiences
- Desktop / web
apps - Room interactions
game - Chat and roles
active/model-client.js - Social network
active/moments.js
Home Node
- Long-term memory
services/home-node/memory-retrieval.js - Home Node service
services/home-node-service.js - Mobile gateway
services/home-node/mobile-gateway.js - Chat records
services/home-node/chat-store.js - Agent economy
services/home-node/economy-store.js - QQ bot integration
services/home-node/qq-official-manager.js
Local services
- Bridge API
services/ib-bridge-service.js - HTTP routes
bridge/routes.js - Voice services
bridge/voice-runtime.js - Active messages
services/active-message-service.js - Proactive scheduler
active/scheduler.js - AI provider client
active/model-client.js
Work mode
- Work-mode host
services/home-node/dsh-host-adapter.js - Work-mode interface
runtime/dsh-native-work-ui/client.js
Android client
- Android app
android/app/src/main/java/com/internalbeyond/mobile/app/MainActivity.kt - Pairing and session
android/app/src/main/java/com/internalbeyond/mobile/data/repository/SessionRepository.kt - Home Node API client
android/app/src/main/java/com/internalbeyond/mobile/data/api/HomeNodeClient.kt - Change synchronization
android/app/src/main/java/com/internalbeyond/mobile/data/sync/SyncEngine.kt - Local cache
android/app/src/main/java/com/internalbeyond/mobile/data/cache/LocalCache.kt
Other components
- User
- Configured AI provider
Connections 27
- User → Desktop / web: uses
README.md - Desktop / web → Room interactions: opens
README.md - Desktop / web → Chat and roles: starts conversation
README.md - Desktop / web → Social network: opens feed
README.md - Chat and roles → Configured AI provider: requests generation
README.md - Desktop / web → Home Node service: uses local services
README.md - Home Node service → Chat records: persists chat
services/home-node-service.js - Home Node service → Long-term memory: assembles memory
services/home-node-service.js - Home Node service → Mobile gateway: assembles gateway
services/home-node-service.js - Home Node service → Agent economy: provides economy
README.md - Desktop / web → Bridge API: uses local API
README.md - Bridge API → HTTP routes: dispatches requests
services/ib-bridge-service.js - Bridge API → Voice services: provides voice
services/ib-bridge-service.js - Desktop / web → Active messages: configures proactive messages
README.md - Active messages → Proactive scheduler: runs schedules
services/active-message-service.js - Active messages → AI provider client: generates messages
services/active-message-service.js - Active messages → Social network: schedules social activity
services/active-message-service.js - Desktop / web → Work-mode host: authorizes work runs
README.md - Work-mode interface → Work-mode host: uses host
- User → Android app: uses
README.md - Android app → Pairing and session: manages connection
- Pairing and session → Home Node API client: calls API
android/app/src/main/java/com/internalbeyond/mobile/data/repository/SessionRepository.kt - Android app → Change synchronization: synchronizes changes
- Change synchronization → Home Node API client: requests changes
android/app/src/main/java/com/internalbeyond/mobile/data/sync/SyncEngine.kt - Change synchronization → Local cache: updates cache
android/app/src/main/java/com/internalbeyond/mobile/data/sync/SyncEngine.kt - Home Node API client → Mobile gateway: calls Home Node
README.md - Home Node service → QQ bot integration: supports bot transport
services/home-node-service.js