How marlon0066/ai-pocket-chat works
AI Pocket Chat is a native Android companion app whose data is stored on-device and whose chat uses a user-configured LLM provider. The principal workflow is chat through the app, with conversation history and character memory informing generation, then a response shown in the conversation. The repository also has distinct story, social, diary, voice, and explorable-world capabilities. The README documents these product branches; sampled sources and the SOURCE INDEX support only some internal links, so unsampled feature wiring is not asserted.
Main entry points: AssistantTurnEngine.kt Chat turn · AppDatabase.kt On-device database · MemoryService.kt Memory service · ContextLogService.kt LLM context and logs
Components 19
App experience
- Android app
app/src/main/java/com/situ/aichat/MainActivity.kt
Chat and memory
- Chat turn
app/src/main/java/com/situ/aichat/ui/chat/AssistantTurnEngine.kt - Memory service
app/src/main/java/com/situ/aichat/prompt/memory/MemoryService.kt - LLM context and logs
app/src/main/java/com/situ/aichat/diagnostics/ContextLogService.kt - LLM client
app/src/main/java/com/situ/aichat/data/remote/llm/LlmClient.kt
Companion features
- Interactive stories
app/src/main/java/com/situ/aichat/story/StoryGenerationService.kt - Social moments
app/src/main/java/com/situ/aichat/moments/MomentChatContextService.kt - Diaries and reviews
app/src/main/java/com/situ/aichat/prompt/diary/MonthlyReviewService.kt - Gifts and red packets
app/src/main/java/com/situ/aichat/gift/ProactiveGiftLLMService.kt - Voice calls
app/src/main/java/com/situ/aichat/voice/VoiceCallTurnService.kt - Offline speech recognition
app/src/main/java/com/situ/aichat/stt/SherpaSttEngine.kt - Explorable world
app/src/main/java/com/situ/aichat/world/stage/WorldStageService.kt
Local data and services
- Messages
app/src/main/java/com/situ/aichat/data/repository/MessageRepository.kt - Conversations
app/src/main/java/com/situ/aichat/data/repository/ConversationRepository.kt - Characters
app/src/main/java/com/situ/aichat/data/repository/CharacterRepository.kt - Provider settings
app/src/main/java/com/situ/aichat/data/repository/ApiConfigRepository.kt - On-device database
app/src/main/java/com/situ/aichat/data/local/AppDatabase.kt
Other components
- User
- Configured LLM provider
Connections 23
- User → Android app: uses
README.md - Android app → Chat turn: starts chat
- Chat turn → Messages: reads and writes
app/src/main/java/com/situ/aichat/ui/chat/AssistantTurnEngine.kt - Chat turn → Conversations: uses history
app/src/main/java/com/situ/aichat/ui/chat/AssistantTurnEngine.kt - Chat turn → Characters: uses character
app/src/main/java/com/situ/aichat/ui/chat/AssistantTurnEngine.kt - Chat turn → Memory service: uses memory
- Memory service → Messages: reads history
app/src/main/java/com/situ/aichat/prompt/memory/MemoryService.kt - Memory service → LLM context and logs: requests completion
app/src/main/java/com/situ/aichat/prompt/memory/MemoryService.kt - LLM context and logs → LLM client: calls
app/src/main/java/com/situ/aichat/diagnostics/ContextLogService.kt - LLM context and logs → On-device database: records logs
- LLM client → Configured LLM provider: sends requests
- Provider settings → Configured LLM provider: configures access
README.md - Chat turn → User: returns reply
- User → Interactive stories: creates stories
README.md - User → Social moments: uses social feed
README.md - User → Diaries and reviews: uses diaries
README.md - User → Gifts and red packets: interacts with
README.md - User → Voice calls: starts calls
README.md - Voice calls → Offline speech recognition: uses speech input
- User → Explorable world: explores
README.md - Messages → On-device database: persists in
- Conversations → On-device database: persists in
- Characters → On-device database: persists in
app/src/main/java/com/situ/aichat/data/repository/CharacterRepository.kt