# google-ai-edge/gallery architecture

> Architecture diagram of the GitHub repository google-ai-edge/gallery, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google-ai-edge/gallery
- Repository: https://github.com/google-ai-edge/gallery

## Overview

Google AI Edge Gallery is an Android application for exploring on-device generative AI. Users choose or download a model, then use chat and task-specific experiences; outputs can include speech, media search results, transcriptions, or edited content. The repository tree shows shared agent/session and speech services alongside separate custom-task feature areas. The README documents several capabilities whose implementation details are not sampled here, so those branches are represented at their task-module paths. Connections not demonstrated by excerpts or explicit README statements are omitted or marked dashed and unverified.

Main entry points: [`Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentChatViewModel.kt`](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentChatViewModel.kt) (Agent chat), [`Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/smartalbum/SmartAlbumTask.kt`](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/smartalbum/SmartAlbumTask.kt) (Instant media search), [`Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/TtsService.kt`](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/TtsService.kt) (Speech synthesis), [`Android/src/app/src/main/java/com/google/ai/edge/gallery/MainActivity.kt`](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/MainActivity.kt) (Android app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and models"]
  node_entry["Android app<br/>[MainActivity.kt]"]
  node_model["Model runtime<br/>[LlmModelHelper.kt]"]
  node_downloads["Model downloads"]
end

subgraph group_agent["Agent chat"]
  node_chat["Agent chat"]
  node_sessions["LLM sessions"]
  node_skills["Agent skills<br/>[SkillManager.kt]"]
  node_tools["Agent tools<br/>[AgentTools.kt]"]
end

subgraph group_speech["Speech services"]
  node_asr["Speech recognition<br/>[AsrService.kt]"]
  node_tts["Speech synthesis<br/>[TtsService.kt]"]
  node_ttsengine["MediaPipe TTS"]
  node_voicepreview["Voice preview"]
end

subgraph group_media["Media experiences"]
  node_smartalbum["Instant media search<br/>[SmartAlbumTask.kt]"]
  node_retrieval["Semantic retrieval"]
  node_photos["Photo library"]
  node_video["Video moment finder"]
end

subgraph group_tasks["Other tasks"]
  node_xr["XR language teacher"]
  node_mobile["Mobile actions"]
  node_garden["Tiny Garden<br/>[TinyGardenTask.kt]"]
  node_scrapbook["Scrapbook editor<br/>[ScrapbookTask.kt]"]
  node_example["Ask Image and tasks"]
end

node_user(("User"))
node_huggingface["Hugging Face"]

node_user -.->|"opens"| node_entry
node_entry -.->|"offers"| node_chat
node_user -.->|"manages models"| node_downloads
node_downloads -.->|"discovers models"| node_huggingface
node_chat -.->|"uses sessions"| node_sessions
node_chat -.->|"runs prompts"| node_model
node_chat -.->|"selects skills"| node_skills
node_chat -.->|"invokes tools"| node_tools
node_chat -.->|"accepts speech"| node_asr
node_chat -.->|"speaks replies"| node_tts
node_ttsengine -.->|"implements"| node_tts
node_voicepreview -->|"previews voices"| node_tts
node_user -->|"searches media"| node_smartalbum
node_smartalbum -.->|"retrieves matches"| node_retrieval
node_smartalbum -.->|"indexes photos"| node_photos
node_user -->|"finds moments"| node_video
node_user -->|"practices language"| node_xr
node_user -->|"requests actions"| node_mobile
node_user -->|"plays garden"| node_garden
node_user -.->|"edits images"| node_scrapbook
node_user -->|"asks about images"| node_example

click node_entry "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/MainActivity.kt"
click node_model "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/runtime/LlmModelHelper.kt"
click node_downloads "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/data/DownloadStorageManager.kt"
click node_chat "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentChatViewModel.kt"
click node_sessions "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/agent/sessions/DefaultLlmSessionManager.kt"
click node_skills "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/skills/SkillManager.kt"
click node_tools "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentTools.kt"
click node_asr "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/asr/AsrService.kt"
click node_tts "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/TtsService.kt"
click node_ttsengine "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/MediaPipeTtsEngine.kt"
click node_voicepreview "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/ui/modelmanager/VoicePreviewController.kt"
click node_smartalbum "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/smartalbum/SmartAlbumTask.kt"
click node_retrieval "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/semanticretrieval/SemanticRetrievalService.kt"
click node_photos "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/photolibrary/PhotoLibraryService.kt"
click node_video "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/videomomentfinder/VideoMomentFinderTask.kt"
click node_xr "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/xrlanguageteacher/XrLanguageTeacherTask.kt"
click node_mobile "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/mobileactions/MobileActionsTask.kt"
click node_garden "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/tinygarden/TinyGardenTask.kt"
click node_scrapbook "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/scrapbook/ScrapbookTask.kt"
click node_example "https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/examplecustomtask/ExampleCustomTask.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_model,node_downloads,node_user toneBlue
class node_chat,node_sessions,node_skills,node_tools toneAmber
class node_asr,node_tts,node_ttsengine,node_voicepreview toneMint
class node_smartalbum,node_retrieval,node_photos,node_video toneRose
class node_xr,node_mobile,node_garden,node_scrapbook,node_example,node_huggingface toneIndigo
```

## Components

### App and models

- [Android app](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/MainActivity.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/MainActivity.kt`
- [Model runtime](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/runtime/LlmModelHelper.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/runtime/LlmModelHelper.kt`
- [Model downloads](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/data/DownloadStorageManager.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/data/DownloadStorageManager.kt`

### Agent chat

- [Agent chat](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentChatViewModel.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentChatViewModel.kt`
- [LLM sessions](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/agent/sessions/DefaultLlmSessionManager.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/agent/sessions/DefaultLlmSessionManager.kt`
- [Agent skills](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/skills/SkillManager.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/skills/SkillManager.kt`
- [Agent tools](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentTools.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/agentchat/AgentTools.kt`

### Speech services

- [Speech recognition](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/asr/AsrService.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/asr/AsrService.kt`
- [Speech synthesis](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/TtsService.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/TtsService.kt`
- [MediaPipe TTS](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/MediaPipeTtsEngine.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/MediaPipeTtsEngine.kt`
- [Voice preview](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/ui/modelmanager/VoicePreviewController.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/ui/modelmanager/VoicePreviewController.kt`

### Media experiences

- [Instant media search](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/smartalbum/SmartAlbumTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/smartalbum/SmartAlbumTask.kt`
- [Semantic retrieval](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/semanticretrieval/SemanticRetrievalService.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/semanticretrieval/SemanticRetrievalService.kt`
- [Photo library](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/services/photolibrary/PhotoLibraryService.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/photolibrary/PhotoLibraryService.kt`
- [Video moment finder](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/videomomentfinder/VideoMomentFinderTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/videomomentfinder/VideoMomentFinderTask.kt`

### Other tasks

- [XR language teacher](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/xrlanguageteacher/XrLanguageTeacherTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/xrlanguageteacher/XrLanguageTeacherTask.kt`
- [Mobile actions](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/mobileactions/MobileActionsTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/mobileactions/MobileActionsTask.kt`
- [Tiny Garden](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/tinygarden/TinyGardenTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/tinygarden/TinyGardenTask.kt`
- [Scrapbook editor](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/scrapbook/ScrapbookTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/scrapbook/ScrapbookTask.kt`
- [Ask Image and tasks](https://github.com/google-ai-edge/gallery/blob/main/Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/examplecustomtask/ExampleCustomTask.kt): `Android/src/app/src/main/java/com/google/ai/edge/gallery/customtasks/examplecustomtask/ExampleCustomTask.kt`

### Other components

- **User**
- **Hugging Face**

## Connections

- User → Android app: opens
- Android app → Agent chat: offers
- User → Model downloads: manages models
- Model downloads → Hugging Face: discovers models
- Agent chat → LLM sessions: uses sessions
- Agent chat → Model runtime: runs prompts
- Agent chat → Agent skills: selects skills
- Agent chat → Agent tools: invokes tools
- Agent chat → Speech recognition: accepts speech
- Agent chat → Speech synthesis: speaks replies
- MediaPipe TTS → Speech synthesis: implements (evidence: `Android/src/app/src/main/java/com/google/ai/edge/gallery/services/tts/MediaPipeTtsEngine.kt`)
- Voice preview → Speech synthesis: previews voices (evidence: `Android/src/app/src/main/java/com/google/ai/edge/gallery/ui/modelmanager/VoicePreviewController.kt`)
- User → Instant media search: searches media (evidence: `README.md`)
- Instant media search → Semantic retrieval: retrieves matches
- Instant media search → Photo library: indexes photos
- User → Video moment finder: finds moments (evidence: `README.md`)
- User → XR language teacher: practices language (evidence: `README.md`)
- User → Mobile actions: requests actions (evidence: `README.md`)
- User → Tiny Garden: plays garden (evidence: `README.md`)
- User → Scrapbook editor: edits images
- User → Ask Image and tasks: asks about images (evidence: `README.md`)
