# kirdev07/kiro-bot architecture

> Architecture diagram of the GitHub repository kirdev07/kiro-bot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kirdev07/kiro-bot
- Repository: https://github.com/kirdev07/kiro-bot

## Overview

Kiro Bot is an Android app for configuring and running a single VK or Telegram chatbot. The central workflow is: start the foreground service, receive a chat message through the selected messenger, apply commands and bot rules, search the local answer base, then send text or media; unanswered messages can be logged and optionally sent to an AI provider. The graph preserves editor, anti-spam, settings, media, and logging capabilities documented in the README. Some runtime details are unsampled, so only indexed or documented relationships are shown.

Main entry points: [`app/src/main/java/com/vkbot/manager/BotService.kt`](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/BotService.kt) (Foreground service), [`app/src/main/java/com/vkbot/manager/MainActivity.kt`](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MainActivity.kt) (Navigation), [`app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt`](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt) (Reply orchestration), [`app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt`](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt) (Answer search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App interface"]
  node_main["Navigation<br/>[MainActivity.kt]"]
  node_botui["Bot management<br/>[BotsFragment.kt]"]
  node_editor["Answer editor"]
  node_settingsui["Settings UI"]
  node_aiui["AI settings UI<br/>[AiFragment.kt]"]
  node_logsui["Logs UI<br/>[LogsFragment.kt]"]
end

subgraph group_runtime["Bot runtime"]
  node_service["Foreground service<br/>[BotService.kt]"]
  node_transports["Messenger adapters<br/>[MessengerBot.kt]"]
  node_commands["Chat commands<br/>[ChatCommands.kt]"]
end

subgraph group_brain["Answers and learning"]
  node_brain["Reply orchestration<br/>[BotBrain.kt]"]
  node_search["Answer search<br/>[AnswerDatabase.kt]"]
  node_analysis["Text analysis<br/>[TextAnalyzer.kt]"]
  node_answer["Answer records<br/>[AnswerElement.kt]"]
  node_unanswered["Unanswered log<br/>[UnansweredLog.kt]"]
end

subgraph group_data["Local data"]
  node_files["Answer file manager"]
  node_botdata[("Bot credentials<br/>[BotDataManager.kt]")]
  node_settings[("Bot preferences<br/>[SettingsManager.kt]")]
  node_blacklist[("Blacklist")]
end

subgraph group_integrations["Media and AI"]
  node_attachment["Media attachment<br/>[Attachment.kt]"]
  node_fetch["Image retrieval<br/>[ImageFetcher.kt]"]
  node_media["Media handling<br/>[MediaFiles.kt]"]
  node_ai["AI assistant<br/>[AiAssistant.kt]"]
  node_provider["AI provider clients<br/>[AiProvider.kt]"]
  node_aihttp["AI HTTP client<br/>[AiHttp.kt]"]
end

node_owner(("Bot owner"))
node_chatter(("Chat participants"))
node_messengers["VK / Telegram"]
node_ai_services["AI services"]

node_owner -->|"configures bot"| node_main
node_main -->|"opens"| node_botui
node_main -->|"opens"| node_editor
node_main -->|"opens"| node_settingsui
node_main -->|"opens"| node_aiui
node_main -->|"opens"| node_logsui
node_botui -->|"manages"| node_botdata
node_botui -->|"starts"| node_service
node_editor -->|"edits answer base"| node_files
node_editor -->|"reviews questions"| node_unanswered
node_settingsui -->|"updates"| node_settings
node_aiui -->|"configures AI"| node_settings
node_chatter -->|"sends messages"| node_messengers
node_messengers -->|"delivers updates"| node_transports
node_service -->|"starts adapters"| node_transports
node_service -->|"dispatches commands"| node_commands
node_service -->|"processes messages"| node_brain
node_service -->|"checks users"| node_blacklist
node_service -->|"reads preferences"| node_settings
node_service -->|"loads bot data"| node_botdata
node_brain -->|"searches replies"| node_search
node_brain -->|"records misses"| node_unanswered
node_brain -->|"reads behavior settings"| node_settings
node_search -->|"loads base and synonyms"| node_files
node_search -->|"normalizes queries"| node_analysis
node_search -->|"returns matches"| node_answer
node_files -->|"reads and writes"| node_unanswered
node_files -->|"loads and saves"| node_answer
node_botdata -->|"encrypts tokens"| node_ai_services
node_service -->|"requests fallback"| node_ai
node_ai -->|"creates client"| node_provider
node_provider -->|"uses HTTP"| node_aihttp
node_aihttp -->|"sends AI requests"| node_ai_services
node_service -.->|"retrieves linked media"| node_fetch
node_service -->|"handles attachments"| node_media
node_answer -->|"contains"| node_attachment
node_attachment -.->|"may reference image"| node_fetch
node_chatter -.->|"receives replies"| node_messengers
node_service -.->|"provides live logs"| node_logsui

click node_main "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MainActivity.kt"
click node_botui "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/BotsFragment.kt"
click node_editor "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/AnswersEditorFragment.kt"
click node_settingsui "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/SettingsFragment.kt"
click node_aiui "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/AiFragment.kt"
click node_logsui "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/LogsFragment.kt"
click node_service "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/BotService.kt"
click node_transports "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MessengerBot.kt"
click node_commands "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ChatCommands.kt"
click node_brain "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt"
click node_search "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt"
click node_analysis "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/TextAnalyzer.kt"
click node_answer "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AnswerElement.kt"
click node_unanswered "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/UnansweredLog.kt"
click node_files "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AndroidFileManager.kt"
click node_botdata "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/BotDataManager.kt"
click node_settings "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/SettingsManager.kt"
click node_blacklist "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/BlacklistManager.kt"
click node_attachment "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/Attachment.kt"
click node_fetch "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ImageFetcher.kt"
click node_media "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MediaFiles.kt"
click node_ai "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiAssistant.kt"
click node_provider "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiProvider.kt"
click node_aihttp "https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiHttp.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_main,node_botui,node_editor,node_settingsui,node_aiui,node_logsui toneBlue
class node_service,node_transports,node_commands toneAmber
class node_brain,node_search,node_analysis,node_answer,node_unanswered toneMint
class node_files,node_botdata,node_settings,node_blacklist toneRose
class node_attachment,node_fetch,node_media,node_ai,node_provider,node_aihttp,node_owner,node_chatter,node_messengers,node_ai_services toneIndigo
```

## Components

### App interface

- [Navigation](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MainActivity.kt): `app/src/main/java/com/vkbot/manager/MainActivity.kt`
- [Bot management](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/BotsFragment.kt): `app/src/main/java/com/vkbot/manager/BotsFragment.kt`
- [Answer editor](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/AnswersEditorFragment.kt): `app/src/main/java/com/vkbot/manager/AnswersEditorFragment.kt`
- [Settings UI](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/SettingsFragment.kt): `app/src/main/java/com/vkbot/manager/SettingsFragment.kt`
- [AI settings UI](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/AiFragment.kt): `app/src/main/java/com/vkbot/manager/AiFragment.kt`
- [Logs UI](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/LogsFragment.kt): `app/src/main/java/com/vkbot/manager/LogsFragment.kt`

### Bot runtime

- [Foreground service](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/BotService.kt): `app/src/main/java/com/vkbot/manager/BotService.kt`
- [Messenger adapters](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MessengerBot.kt): `app/src/main/java/com/vkbot/manager/MessengerBot.kt`
- [Chat commands](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ChatCommands.kt): `app/src/main/java/com/vkbot/manager/ChatCommands.kt`

### Answers and learning

- [Reply orchestration](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt): `app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt`
- [Answer search](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt): `app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt`
- [Text analysis](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/TextAnalyzer.kt): `app/src/main/java/com/vkbot/manager/botbrain/TextAnalyzer.kt`
- [Answer records](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AnswerElement.kt): `app/src/main/java/com/vkbot/manager/botbrain/AnswerElement.kt`
- [Unanswered log](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/UnansweredLog.kt): `app/src/main/java/com/vkbot/manager/botbrain/UnansweredLog.kt`

### Local data

- [Answer file manager](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/AndroidFileManager.kt): `app/src/main/java/com/vkbot/manager/botbrain/AndroidFileManager.kt`
- [Bot credentials](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/BotDataManager.kt): `app/src/main/java/com/vkbot/manager/utils/BotDataManager.kt`
- [Bot preferences](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/SettingsManager.kt): `app/src/main/java/com/vkbot/manager/utils/SettingsManager.kt`
- [Blacklist](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/utils/BlacklistManager.kt): `app/src/main/java/com/vkbot/manager/utils/BlacklistManager.kt`

### Media and AI

- [Media attachment](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/botbrain/Attachment.kt): `app/src/main/java/com/vkbot/manager/botbrain/Attachment.kt`
- [Image retrieval](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ImageFetcher.kt): `app/src/main/java/com/vkbot/manager/ImageFetcher.kt`
- [Media handling](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/MediaFiles.kt): `app/src/main/java/com/vkbot/manager/MediaFiles.kt`
- [AI assistant](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiAssistant.kt): `app/src/main/java/com/vkbot/manager/ai/AiAssistant.kt`
- [AI provider clients](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiProvider.kt): `app/src/main/java/com/vkbot/manager/ai/AiProvider.kt`
- [AI HTTP client](https://github.com/kirdev07/kiro-bot/blob/main/app/src/main/java/com/vkbot/manager/ai/AiHttp.kt): `app/src/main/java/com/vkbot/manager/ai/AiHttp.kt`

### Other components

- **Bot owner**
- **Chat participants**
- **VK / Telegram**
- **AI services**

## Connections

- Bot owner → Navigation: configures bot (evidence: `README.md`)
- Navigation → Bot management: opens (evidence: `app/src/main/java/com/vkbot/manager/MainActivity.kt`)
- Navigation → Answer editor: opens (evidence: `app/src/main/java/com/vkbot/manager/MainActivity.kt`)
- Navigation → Settings UI: opens (evidence: `app/src/main/java/com/vkbot/manager/MainActivity.kt`)
- Navigation → AI settings UI: opens (evidence: `app/src/main/java/com/vkbot/manager/MainActivity.kt`)
- Navigation → Logs UI: opens (evidence: `app/src/main/java/com/vkbot/manager/MainActivity.kt`)
- Bot management → Bot credentials: manages (evidence: `app/src/main/java/com/vkbot/manager/BotsFragment.kt`)
- Bot management → Foreground service: starts (evidence: `app/src/main/java/com/vkbot/manager/BotsFragment.kt`)
- Answer editor → Answer file manager: edits answer base (evidence: `app/src/main/java/com/vkbot/manager/AnswersEditorFragment.kt`)
- Answer editor → Unanswered log: reviews questions (evidence: `app/src/main/java/com/vkbot/manager/AnswersEditorFragment.kt`)
- Settings UI → Bot preferences: updates (evidence: `app/src/main/java/com/vkbot/manager/SettingsFragment.kt`)
- AI settings UI → Bot preferences: configures AI (evidence: `app/src/main/java/com/vkbot/manager/AiFragment.kt`)
- Chat participants → VK / Telegram: sends messages (evidence: `README.md`)
- VK / Telegram → Messenger adapters: delivers updates (evidence: `README.md`)
- Foreground service → Messenger adapters: starts adapters (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Foreground service → Chat commands: dispatches commands (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Foreground service → Reply orchestration: processes messages (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Foreground service → Blacklist: checks users (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Foreground service → Bot preferences: reads preferences (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Foreground service → Bot credentials: loads bot data (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Reply orchestration → Answer search: searches replies (evidence: `app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt`)
- Reply orchestration → Unanswered log: records misses (evidence: `app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt`)
- Reply orchestration → Bot preferences: reads behavior settings (evidence: `app/src/main/java/com/vkbot/manager/botbrain/BotBrain.kt`)
- Answer search → Answer file manager: loads base and synonyms (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt`)
- Answer search → Text analysis: normalizes queries (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt`)
- Answer search → Answer records: returns matches (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AnswerDatabase.kt`)
- Answer file manager → Unanswered log: reads and writes (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AndroidFileManager.kt`)
- Answer file manager → Answer records: loads and saves (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AndroidFileManager.kt`)
- Bot credentials → AI services: encrypts tokens (evidence: `app/src/main/java/com/vkbot/manager/utils/BotDataManager.kt`)
- Foreground service → AI assistant: requests fallback (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- AI assistant → AI provider clients: creates client (evidence: `app/src/main/java/com/vkbot/manager/ai/AiProvider.kt`)
- AI provider clients → AI HTTP client: uses HTTP
- AI HTTP client → AI services: sends AI requests
- Foreground service → Image retrieval: retrieves linked media
- Foreground service → Media handling: handles attachments (evidence: `app/src/main/java/com/vkbot/manager/BotService.kt`)
- Answer records → Media attachment: contains (evidence: `app/src/main/java/com/vkbot/manager/botbrain/AnswerElement.kt`)
- Media attachment → Image retrieval: may reference image
- Chat participants → VK / Telegram: receives replies
- Foreground service → Logs UI: provides live logs
