# tahir-1907/keyra architecture

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

- Interactive diagram: https://gitdiagram.com/tahir-1907/keyra
- Repository: https://github.com/tahir-1907/keyra

## Overview

Keyra is an offline Linux desktop password manager. The user opens or creates a vault, unlocks it with a master password or recovery key, then manages encrypted entries and their organization; the desktop interface also exposes history, trash, audit, generation, backup, transfer, and settings workflows. The core separates vault/key lifecycle, entry and metadata handling, repositories, SQLite storage, and service operations. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled implementations and wiring are represented conservatively.

Main entry points: [`app/core/vault.py`](https://github.com/tahir-1907/keyra/blob/main/app/core/vault.py) (Vault lifecycle), [`app/ui/main_window.py`](https://github.com/tahir-1907/keyra/blob/main/app/ui/main_window.py) (Application window), [`app/services/backup.py`](https://github.com/tahir-1907/keyra/blob/main/app/services/backup.py) (Encrypted backups), [`app/core/entries.py`](https://github.com/tahir-1907/keyra/blob/main/app/core/entries.py) (Entry service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_main["Application window<br/>[main_window.py]"]
  node_vaultui["Vault pages<br/>[vault.py]"]
  node_entrylist["Entry list<br/>[entry_list.py]"]
  node_dialogs["Dialogs<br/>[dialogs.py]"]
  node_components["UI components<br/>[components.py]"]
  node_settingsui["Settings page<br/>[settings.py]"]
  node_backupui["Backup page<br/>[backups.py]"]
  node_transferui["Transfer dialogs"]
end

subgraph group_vault["Vault security"]
  node_vaultcore["Vault lifecycle<br/>[vault.py]"]
  node_crypto["Cryptographic primitives<br/>[crypto.py]"]
  node_session["Session locking<br/>[session.py]"]
  node_recovery["Recovery keys<br/>[recovery.py]"]
end

subgraph group_domain["Vault data"]
  node_entries["Entry service<br/>[entries.py]"]
  node_metadata["Encrypted metadata<br/>[metadata.py]"]
  node_categories["Categories and tags<br/>[categories.py]"]
  node_builtin["Built-in categories"]
  node_audit["Security audit<br/>[audit.py]"]
  node_generator["Password generator<br/>[generator.py]"]
end

subgraph group_storage["Persistence"]
  node_database[("SQLite vault<br/>[database.py]")]
  node_repositories["Data repositories<br/>[repositories.py]"]
end

subgraph group_services["Vault services"]
  node_backup["Encrypted backups<br/>[backup.py]"]
  node_importexport["Import and export<br/>[import_export.py]"]
  node_pdf["PDF export<br/>[pdf_export.py]"]
  node_migration["Vault migration<br/>[migration_v4.py]"]
  node_upgrade["Upgrade workflow<br/>[vault_upgrade.py]"]
  node_settings["Application settings<br/>[settings.py]"]
  node_paths["Local data paths<br/>[paths.py]"]
  node_i18n["Localization<br/>[__init__.py]"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_main
node_main -->|"opens vault"| node_vaultcore
node_main -->|"manages session"| node_session
node_main -->|"requests backups"| node_backup
node_main -->|"starts upgrade"| node_upgrade
node_main -->|"loads settings"| node_settings
node_main -->|"hosts pages"| node_vaultui
node_vaultui -->|"manages entries"| node_entries
node_vaultui -->|"uses list"| node_entrylist
node_vaultui -->|"opens dialogs"| node_dialogs
node_entrylist -->|"renders with"| node_components
node_settingsui -->|"updates settings"| node_settings
node_settingsui -->|"renders with"| node_components
node_backupui -->|"manages backups"| node_backup
node_backupui -->|"opens transfer"| node_transferui
node_transferui -->|"transfers data"| node_importexport
node_transferui -->|"handles backup files"| node_backup
node_transferui -->|"exports PDF"| node_pdf
node_vaultcore -->|"wraps data key"| node_crypto
node_vaultcore -->|"opens vault file"| node_database
node_vaultcore -->|"reads vault metadata"| node_repositories
node_vaultcore -->|"uses recovery"| node_recovery
node_vaultcore -->|"creates metadata store"| node_metadata
node_entries -->|"encrypts fields"| node_crypto
node_entries -->|"uses metadata"| node_metadata
node_entries -->|"stores encrypted data"| node_repositories
node_categories -->|"uses built-ins"| node_builtin
node_categories -->|"validates references"| node_entries
node_categories -->|"accesses categories"| node_repositories
node_metadata -->|"derives subkeys"| node_crypto
node_repositories -->|"queries SQLite"| node_database
node_backup -->|"backs up vault"| node_vaultcore
node_backup -->|"encrypts backup"| node_crypto
node_backup -->|"reads vault metadata"| node_repositories
node_importexport -->|"imports entries"| node_entries
node_importexport -->|"imports categories"| node_categories
node_importexport -->|"uses vault"| node_vaultcore
node_upgrade -->|"runs migration"| node_migration
node_upgrade -->|"creates backup"| node_backup
node_upgrade -->|"opens vault"| node_vaultcore
node_settings -->|"resolves local paths"| node_paths
node_settings -->|"configures locking"| node_session
node_main -->|"sets interface language"| node_i18n
node_user -.->|"runs audit"| node_audit
node_user -.->|"generates passwords"| node_generator
node_user -.->|"configures app"| node_settingsui
node_user -.->|"manages backups"| node_backupui
node_user -.->|"imports or exports"| node_transferui

click node_main "https://github.com/tahir-1907/keyra/blob/main/app/ui/main_window.py"
click node_vaultui "https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/vault.py"
click node_entrylist "https://github.com/tahir-1907/keyra/blob/main/app/ui/entry_list.py"
click node_dialogs "https://github.com/tahir-1907/keyra/blob/main/app/ui/dialogs.py"
click node_components "https://github.com/tahir-1907/keyra/blob/main/app/ui/components.py"
click node_settingsui "https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/settings.py"
click node_backupui "https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/backups.py"
click node_transferui "https://github.com/tahir-1907/keyra/blob/main/app/ui/transfer_dialogs.py"
click node_vaultcore "https://github.com/tahir-1907/keyra/blob/main/app/core/vault.py"
click node_crypto "https://github.com/tahir-1907/keyra/blob/main/app/core/crypto.py"
click node_session "https://github.com/tahir-1907/keyra/blob/main/app/core/session.py"
click node_recovery "https://github.com/tahir-1907/keyra/blob/main/app/core/recovery.py"
click node_entries "https://github.com/tahir-1907/keyra/blob/main/app/core/entries.py"
click node_metadata "https://github.com/tahir-1907/keyra/blob/main/app/core/metadata.py"
click node_categories "https://github.com/tahir-1907/keyra/blob/main/app/core/categories.py"
click node_builtin "https://github.com/tahir-1907/keyra/blob/main/app/core/builtin_categories.py"
click node_audit "https://github.com/tahir-1907/keyra/blob/main/app/core/audit.py"
click node_generator "https://github.com/tahir-1907/keyra/blob/main/app/core/generator.py"
click node_database "https://github.com/tahir-1907/keyra/blob/main/app/database/database.py"
click node_repositories "https://github.com/tahir-1907/keyra/blob/main/app/database/repositories.py"
click node_backup "https://github.com/tahir-1907/keyra/blob/main/app/services/backup.py"
click node_importexport "https://github.com/tahir-1907/keyra/blob/main/app/services/import_export.py"
click node_pdf "https://github.com/tahir-1907/keyra/blob/main/app/services/pdf_export.py"
click node_migration "https://github.com/tahir-1907/keyra/blob/main/app/services/migration_v4.py"
click node_upgrade "https://github.com/tahir-1907/keyra/blob/main/app/services/vault_upgrade.py"
click node_settings "https://github.com/tahir-1907/keyra/blob/main/app/services/settings.py"
click node_paths "https://github.com/tahir-1907/keyra/blob/main/app/utils/paths.py"
click node_i18n "https://github.com/tahir-1907/keyra/blob/main/app/i18n/__init__.py"

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_vaultui,node_entrylist,node_dialogs,node_components,node_settingsui,node_backupui,node_transferui,node_user toneBlue
class node_vaultcore,node_crypto,node_session,node_recovery toneAmber
class node_entries,node_metadata,node_categories,node_builtin,node_audit,node_generator toneMint
class node_database,node_repositories toneRose
class node_backup,node_importexport,node_pdf,node_migration,node_upgrade,node_settings,node_paths,node_i18n toneIndigo
```

## Components

### Desktop interface

- [Application window](https://github.com/tahir-1907/keyra/blob/main/app/ui/main_window.py): `app/ui/main_window.py`
- [Vault pages](https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/vault.py): `app/ui/pages/vault.py`
- [Entry list](https://github.com/tahir-1907/keyra/blob/main/app/ui/entry_list.py): `app/ui/entry_list.py`
- [Dialogs](https://github.com/tahir-1907/keyra/blob/main/app/ui/dialogs.py): `app/ui/dialogs.py`
- [UI components](https://github.com/tahir-1907/keyra/blob/main/app/ui/components.py): `app/ui/components.py`
- [Settings page](https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/settings.py): `app/ui/pages/settings.py`
- [Backup page](https://github.com/tahir-1907/keyra/blob/main/app/ui/pages/backups.py): `app/ui/pages/backups.py`
- [Transfer dialogs](https://github.com/tahir-1907/keyra/blob/main/app/ui/transfer_dialogs.py): `app/ui/transfer_dialogs.py`

### Vault security

- [Vault lifecycle](https://github.com/tahir-1907/keyra/blob/main/app/core/vault.py): `app/core/vault.py`
- [Cryptographic primitives](https://github.com/tahir-1907/keyra/blob/main/app/core/crypto.py): `app/core/crypto.py`
- [Session locking](https://github.com/tahir-1907/keyra/blob/main/app/core/session.py): `app/core/session.py`
- [Recovery keys](https://github.com/tahir-1907/keyra/blob/main/app/core/recovery.py): `app/core/recovery.py`

### Vault data

- [Entry service](https://github.com/tahir-1907/keyra/blob/main/app/core/entries.py): `app/core/entries.py`
- [Encrypted metadata](https://github.com/tahir-1907/keyra/blob/main/app/core/metadata.py): `app/core/metadata.py`
- [Categories and tags](https://github.com/tahir-1907/keyra/blob/main/app/core/categories.py): `app/core/categories.py`
- [Built-in categories](https://github.com/tahir-1907/keyra/blob/main/app/core/builtin_categories.py): `app/core/builtin_categories.py`
- [Security audit](https://github.com/tahir-1907/keyra/blob/main/app/core/audit.py): `app/core/audit.py`
- [Password generator](https://github.com/tahir-1907/keyra/blob/main/app/core/generator.py): `app/core/generator.py`

### Persistence

- [SQLite vault](https://github.com/tahir-1907/keyra/blob/main/app/database/database.py): `app/database/database.py`
- [Data repositories](https://github.com/tahir-1907/keyra/blob/main/app/database/repositories.py): `app/database/repositories.py`

### Vault services

- [Encrypted backups](https://github.com/tahir-1907/keyra/blob/main/app/services/backup.py): `app/services/backup.py`
- [Import and export](https://github.com/tahir-1907/keyra/blob/main/app/services/import_export.py): `app/services/import_export.py`
- [PDF export](https://github.com/tahir-1907/keyra/blob/main/app/services/pdf_export.py): `app/services/pdf_export.py`
- [Vault migration](https://github.com/tahir-1907/keyra/blob/main/app/services/migration_v4.py): `app/services/migration_v4.py`
- [Upgrade workflow](https://github.com/tahir-1907/keyra/blob/main/app/services/vault_upgrade.py): `app/services/vault_upgrade.py`
- [Application settings](https://github.com/tahir-1907/keyra/blob/main/app/services/settings.py): `app/services/settings.py`
- [Local data paths](https://github.com/tahir-1907/keyra/blob/main/app/utils/paths.py): `app/utils/paths.py`
- [Localization](https://github.com/tahir-1907/keyra/blob/main/app/i18n/__init__.py): `app/i18n/__init__.py`

### Other components

- **Desktop user**

## Connections

- Desktop user → Application window: uses
- Application window → Vault lifecycle: opens vault (evidence: `app/ui/main_window.py`)
- Application window → Session locking: manages session (evidence: `app/ui/main_window.py`)
- Application window → Encrypted backups: requests backups (evidence: `app/ui/main_window.py`)
- Application window → Upgrade workflow: starts upgrade (evidence: `app/ui/main_window.py`)
- Application window → Application settings: loads settings (evidence: `app/ui/main_window.py`)
- Application window → Vault pages: hosts pages (evidence: `app/ui/main_window.py`)
- Vault pages → Entry service: manages entries (evidence: `app/ui/pages/vault.py`)
- Vault pages → Entry list: uses list (evidence: `app/ui/pages/vault.py`)
- Vault pages → Dialogs: opens dialogs (evidence: `app/ui/pages/vault.py`)
- Entry list → UI components: renders with (evidence: `app/ui/entry_list.py`)
- Settings page → Application settings: updates settings (evidence: `app/ui/pages/settings.py`)
- Settings page → UI components: renders with (evidence: `app/ui/pages/settings.py`)
- Backup page → Encrypted backups: manages backups (evidence: `app/ui/pages/backups.py`)
- Backup page → Transfer dialogs: opens transfer (evidence: `app/ui/pages/backups.py`)
- Transfer dialogs → Import and export: transfers data (evidence: `app/ui/transfer_dialogs.py`)
- Transfer dialogs → Encrypted backups: handles backup files (evidence: `app/ui/transfer_dialogs.py`)
- Transfer dialogs → PDF export: exports PDF (evidence: `app/ui/transfer_dialogs.py`)
- Vault lifecycle → Cryptographic primitives: wraps data key (evidence: `app/core/vault.py`)
- Vault lifecycle → SQLite vault: opens vault file (evidence: `app/core/vault.py`)
- Vault lifecycle → Data repositories: reads vault metadata (evidence: `app/core/vault.py`)
- Vault lifecycle → Recovery keys: uses recovery (evidence: `app/core/vault.py`)
- Vault lifecycle → Encrypted metadata: creates metadata store (evidence: `app/core/vault.py`)
- Entry service → Cryptographic primitives: encrypts fields (evidence: `app/core/entries.py`)
- Entry service → Encrypted metadata: uses metadata (evidence: `app/core/entries.py`)
- Entry service → Data repositories: stores encrypted data (evidence: `app/core/entries.py`)
- Categories and tags → Built-in categories: uses built-ins (evidence: `app/core/categories.py`)
- Categories and tags → Entry service: validates references (evidence: `app/core/categories.py`)
- Categories and tags → Data repositories: accesses categories (evidence: `app/core/categories.py`)
- Encrypted metadata → Cryptographic primitives: derives subkeys (evidence: `app/core/metadata.py`)
- Data repositories → SQLite vault: queries SQLite (evidence: `app/database/repositories.py`)
- Encrypted backups → Vault lifecycle: backs up vault (evidence: `app/services/backup.py`)
- Encrypted backups → Cryptographic primitives: encrypts backup (evidence: `app/services/backup.py`)
- Encrypted backups → Data repositories: reads vault metadata (evidence: `app/services/backup.py`)
- Import and export → Entry service: imports entries (evidence: `app/services/import_export.py`)
- Import and export → Categories and tags: imports categories (evidence: `app/services/import_export.py`)
- Import and export → Vault lifecycle: uses vault (evidence: `app/services/import_export.py`)
- Upgrade workflow → Vault migration: runs migration (evidence: `app/services/vault_upgrade.py`)
- Upgrade workflow → Encrypted backups: creates backup (evidence: `app/services/vault_upgrade.py`)
- Upgrade workflow → Vault lifecycle: opens vault (evidence: `app/services/vault_upgrade.py`)
- Application settings → Local data paths: resolves local paths (evidence: `app/services/settings.py`)
- Application settings → Session locking: configures locking (evidence: `app/services/settings.py`)
- Application window → Localization: sets interface language (evidence: `app/ui/main_window.py`)
- Desktop user → Security audit: runs audit
- Desktop user → Password generator: generates passwords
- Desktop user → Settings page: configures app
- Desktop user → Backup page: manages backups
- Desktop user → Transfer dialogs: imports or exports
