# victor-rebuild/victor-1.6-rebuild-2 architecture

> Architecture diagram of the GitHub repository victor-rebuild/victor-1.6-rebuild-2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/victor-rebuild/victor-1.6-rebuild-2
- Repository: https://github.com/victor-rebuild/victor-1.6-rebuild-2

## Overview

This repository is the source for the 1.6-rebuild Vector firmware, with runtime code for the robot engine, animation process, cloud connectivity, and system updates. A typical robot interaction enters through robot/engine messages, is handled by the engine or animation runtime, and can produce animation, display, light, or audio behavior; cloud services provide connectivity and voice-related support. The graph emphasizes those runtime boundaries and documented capabilities. Several subsystems are represented by tree-supported paths because their implementation was not sampled, so uncertain internal wiring is omitted.

Main entry points: [`animProcess/src/cozmoAnim/animEngine.cpp`](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/animEngine.cpp) (Animation Process), [`engine/tools/engined/cozmoEngineMain.cpp`](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/tools/engined/cozmoEngineMain.cpp) (Vector Engine), [`cloud/cloud/message_handler.go`](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/message_handler.go) (Cloud Message Handler), [`cloud/cloud/gateway.go`](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/gateway.go) (Cloud Gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_robot["Robot Runtime"]
  node_robot["Vector Engine"]
  node_robot_msgs["Robot Messaging"]
  node_nvstore[("Nonvolatile Storage")]
end

subgraph group_anim["Animation and Audio"]
  node_anim_process["Animation Process<br/>[animEngine.cpp]"]
  node_anim_stream["Animation Streaming"]
  node_anim_assets["Animation Assets"]
  node_face["Face Display<br/>[faceDisplay.cpp]"]
  node_backpack["Backpack Lights"]
  node_audio["Robot Audio"]
  node_audio_engine["Audio Engine"]
  node_speech["Speech Recognition"]
  node_tts["Text To Speech"]
  node_alexa["Alexa Integration<br/>[alexa.cpp]"]
end

subgraph group_cloud["Cloud Services"]
  node_cloud_gateway["Cloud Gateway<br/>[gateway.go]"]
  node_cloud_messages["Cloud Message Handler<br/>[message_handler.go]"]
  node_cloud_voice["Voice Streaming<br/>[process.go]"]
  node_cloud_tokens["Token Services<br/>[token.go]"]
end

subgraph group_system["System Services"]
  node_update["Firmware Updater<br/>[update-engine.py]"]
end

node_robot_user(("Robot User"))
node_remote_services(("External Services"))

node_robot_user -->|"interacts with"| node_robot
node_robot -->|"dispatches messages"| node_robot_msgs
node_robot -->|"starts process"| node_anim_process
node_robot_msgs -->|"handles storage requests"| node_nvstore
node_anim_process -->|"updates"| node_anim_stream
node_anim_process -->|"sets up audio input"| node_audio
node_anim_process -->|"initializes"| node_face
node_anim_process -->|"initializes and updates"| node_backpack
node_anim_process -->|"initializes via context"| node_speech
node_anim_process -->|"initializes"| node_tts
node_anim_process -->|"initializes"| node_alexa
node_anim_stream -->|"uses loaded animations"| node_anim_assets
node_audio -->|"sends audio messages"| node_robot
node_audio_engine -.->|"uses audio backend"| node_remote_services
node_cloud_gateway -->|"dispatches messages"| node_cloud_messages
node_cloud_gateway -->|"connects to"| node_remote_services
node_cloud_messages -->|"handles voice traffic"| node_cloud_voice
node_cloud_messages -->|"uses token services"| node_cloud_tokens
node_cloud_voice -->|"streams voice"| node_remote_services
node_alexa -.->|"integrates with"| node_remote_services
node_update -->|"downloads update data"| node_remote_services

click node_robot "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/tools/engined/cozmoEngineMain.cpp"
click node_robot_msgs "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/robotToEngineImplMessaging.cpp"
click node_nvstore "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/components/nvStorageComponent.cpp"
click node_anim_process "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/animEngine.cpp"
click node_anim_stream "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/animation/animationStreamer.cpp"
click node_anim_assets "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cannedAnimLib/cannedAnims/cannedAnimationLoader.cpp"
click node_face "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/faceDisplay/faceDisplay.cpp"
click node_backpack "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/backpackLights/animBackpackLightComponent.cpp"
click node_audio "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/audio/engineRobotAudioClient.cpp"
click node_audio_engine "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/lib/audio/source/engine/audioEngineController.cpp"
click node_speech "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/speechRecognizer/speechRecognizerSystem.cpp"
click node_tts "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/textToSpeech/textToSpeechComponent.cpp"
click node_alexa "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/alexa/alexa.cpp"
click node_cloud_gateway "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/gateway.go"
click node_cloud_messages "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/message_handler.go"
click node_cloud_voice "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/internal/voice/process.go"
click node_cloud_tokens "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/internal/token/token.go"
click node_update "https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/platform/update-engine/update-engine.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_robot,node_robot_msgs,node_nvstore,node_robot_user toneBlue
class node_anim_process,node_anim_stream,node_anim_assets,node_face,node_backpack,node_audio,node_audio_engine,node_speech,node_tts,node_alexa toneAmber
class node_cloud_gateway,node_cloud_messages,node_cloud_voice,node_cloud_tokens toneMint
class node_update toneRose
class node_remote_services toneIndigo
```

## Components

### Robot Runtime

- [Vector Engine](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/tools/engined/cozmoEngineMain.cpp): `engine/tools/engined/cozmoEngineMain.cpp`
- [Robot Messaging](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/robotToEngineImplMessaging.cpp): `engine/robotToEngineImplMessaging.cpp`
- [Nonvolatile Storage](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/components/nvStorageComponent.cpp): `engine/components/nvStorageComponent.cpp`

### Animation and Audio

- [Animation Process](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/animEngine.cpp): `animProcess/src/cozmoAnim/animEngine.cpp`
- [Animation Streaming](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/animation/animationStreamer.cpp): `animProcess/src/cozmoAnim/animation/animationStreamer.cpp`
- [Animation Assets](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cannedAnimLib/cannedAnims/cannedAnimationLoader.cpp): `cannedAnimLib/cannedAnims/cannedAnimationLoader.cpp`
- [Face Display](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/faceDisplay/faceDisplay.cpp): `animProcess/src/cozmoAnim/faceDisplay/faceDisplay.cpp`
- [Backpack Lights](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/backpackLights/animBackpackLightComponent.cpp): `animProcess/src/cozmoAnim/backpackLights/animBackpackLightComponent.cpp`
- [Robot Audio](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/engine/audio/engineRobotAudioClient.cpp): `engine/audio/engineRobotAudioClient.cpp`
- [Audio Engine](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/lib/audio/source/engine/audioEngineController.cpp): `lib/audio/source/engine/audioEngineController.cpp`
- [Speech Recognition](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/speechRecognizer/speechRecognizerSystem.cpp): `animProcess/src/cozmoAnim/speechRecognizer/speechRecognizerSystem.cpp`
- [Text To Speech](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/textToSpeech/textToSpeechComponent.cpp): `animProcess/src/cozmoAnim/textToSpeech/textToSpeechComponent.cpp`
- [Alexa Integration](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/animProcess/src/cozmoAnim/alexa/alexa.cpp): `animProcess/src/cozmoAnim/alexa/alexa.cpp`

### Cloud Services

- [Cloud Gateway](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/gateway.go): `cloud/cloud/gateway.go`
- [Cloud Message Handler](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/cloud/message_handler.go): `cloud/cloud/message_handler.go`
- [Voice Streaming](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/internal/voice/process.go): `cloud/internal/voice/process.go`
- [Token Services](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/cloud/internal/token/token.go): `cloud/internal/token/token.go`

### System Services

- [Firmware Updater](https://github.com/victor-rebuild/victor-1.6-rebuild-2/blob/master/platform/update-engine/update-engine.py): `platform/update-engine/update-engine.py`

### Other components

- **Robot User**
- **External Services**

## Connections

- Robot User → Vector Engine: interacts with
- Vector Engine → Robot Messaging: dispatches messages
- Vector Engine → Animation Process: starts process
- Robot Messaging → Nonvolatile Storage: handles storage requests
- Animation Process → Animation Streaming: updates
- Animation Process → Robot Audio: sets up audio input
- Animation Process → Face Display: initializes
- Animation Process → Backpack Lights: initializes and updates
- Animation Process → Speech Recognition: initializes via context
- Animation Process → Text To Speech: initializes
- Animation Process → Alexa Integration: initializes
- Animation Streaming → Animation Assets: uses loaded animations
- Robot Audio → Vector Engine: sends audio messages
- Audio Engine → External Services: uses audio backend
- Cloud Gateway → Cloud Message Handler: dispatches messages
- Cloud Gateway → External Services: connects to
- Cloud Message Handler → Voice Streaming: handles voice traffic
- Cloud Message Handler → Token Services: uses token services
- Voice Streaming → External Services: streams voice
- Alexa Integration → External Services: integrates with
- Firmware Updater → External Services: downloads update data