# dasterprokio/awesome-ai-companion architecture

> Architecture diagram of the GitHub repository dasterprokio/awesome-ai-companion, 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/dasterprokio/awesome-ai-companion
- Repository: https://github.com/dasterprokio/awesome-ai-companion

## Overview

This repository is a curated directory of software, infrastructure, and communities for long-term AI companion relationships. Its main user workflow is to browse the catalog’s capability sections and compare listed projects by what they do, platform, and readiness. The README documents the catalog and its categories; the available source excerpts do not establish how the web files render or connect to it.

Main entry points: [`README.md`](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md) (Project catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Clients &amp; Spaces"]
  node_workspaces["Clients &amp; workspaces<br/>[README.md]"]
  node_virtual_spaces["Virtual phones &amp; spaces<br/>[README.md]"]
  node_games["Game worlds &amp; toys<br/>[README.md]"]
end

subgraph group_continuity["Continuity &amp; State"]
  node_continuity["Continuity &amp; ownership<br/>[README.md]"]
  node_memory["Memory, identity &amp; emotion<br/>[README.md]"]
end

subgraph group_interaction["Interaction &amp; Embodiment"]
  node_heartbeats["Heartbeats &amp; messaging<br/>[README.md]"]
  node_voice_visual["Voice &amp; embodiment<br/>[README.md]"]
  node_perception["Perception<br/>[README.md]"]
  node_activities["Shared activities &amp; media<br/>[README.md]"]
end

subgraph group_ecosystem["Integrations &amp; Community"]
  node_services["Services &amp; integrations<br/>[README.md]"]
  node_communities["Communities &amp; forums<br/>[README.md]"]
end

node_reader(("Catalog reader"))
node_catalog["Project catalog<br/>[README.md]"]

node_reader -->|"browses"| node_catalog
node_catalog -->|"organizes"| node_workspaces
node_catalog -->|"organizes"| node_virtual_spaces
node_catalog -->|"organizes"| node_games
node_catalog -->|"organizes"| node_continuity
node_catalog -->|"organizes"| node_memory
node_catalog -->|"organizes"| node_heartbeats
node_catalog -->|"organizes"| node_voice_visual
node_catalog -->|"organizes"| node_perception
node_catalog -->|"organizes"| node_activities
node_catalog -->|"organizes"| node_services
node_catalog -->|"organizes"| node_communities

click node_catalog "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_workspaces "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_virtual_spaces "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_games "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_continuity "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_memory "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_heartbeats "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_voice_visual "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_perception "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_activities "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_services "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"
click node_communities "https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md"

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_workspaces,node_virtual_spaces,node_games toneBlue
class node_continuity,node_memory toneAmber
class node_heartbeats,node_voice_visual,node_perception,node_activities toneMint
class node_services,node_communities toneRose
class node_reader toneIndigo
class node_catalog toneTeal
```

## Components

### Clients & Spaces

- [Clients & workspaces](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Virtual phones & spaces](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Game worlds & toys](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`

### Continuity & State

- [Continuity & ownership](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Memory, identity & emotion](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`

### Interaction & Embodiment

- [Heartbeats & messaging](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Voice & embodiment](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Perception](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Shared activities & media](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`

### Integrations & Community

- [Services & integrations](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`
- [Communities & forums](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`

### Other components

- **Catalog reader**
- [Project catalog](https://github.com/dasterprokio/awesome-ai-companion/blob/main/README.md): `README.md`

## Connections

- Catalog reader → Project catalog: browses (evidence: `README.md`)
- Project catalog → Clients & workspaces: organizes (evidence: `README.md`)
- Project catalog → Virtual phones & spaces: organizes (evidence: `README.md`)
- Project catalog → Game worlds & toys: organizes (evidence: `README.md`)
- Project catalog → Continuity & ownership: organizes (evidence: `README.md`)
- Project catalog → Memory, identity & emotion: organizes (evidence: `README.md`)
- Project catalog → Heartbeats & messaging: organizes (evidence: `README.md`)
- Project catalog → Voice & embodiment: organizes (evidence: `README.md`)
- Project catalog → Perception: organizes (evidence: `README.md`)
- Project catalog → Shared activities & media: organizes (evidence: `README.md`)
- Project catalog → Services & integrations: organizes (evidence: `README.md`)
- Project catalog → Communities & forums: organizes (evidence: `README.md`)
