How SIC Works

Fundamentals of the Social Interaction Cloud framework.

This section contains higher-level information on the architecture of the Social Interaction Cloud framework.

SIC 101: Building Blocks

• Building Blocks of SIC
  • Components: Sensors, Actuators, and Services
  • Supporting Elements: ComponentManager, Connector, and Redis
  • Example Application Diagrams

Messaging System

• Messaging System

Processes and Threads

• Processes and Threads
  • Process Architecture
  • Thread Types
  • Shutdown Process

Redis registries (multi-user)

• Redis registries (multi-user and shared Redis)
  • Purpose
  • Redis keys and storage model
  • Device reservations
  • Data streams
  • Operational expectations

Docker

• Docker in SIC
  • How compose files work
  • Creating a compose file
  • Rebuilding containers
  • Looking at container logs
  • How containers know the SIC version
  • Manual runs without compose
  • Troubleshooting

Model Context Protocol (MCP)

• Model Context Protocol (MCP) in SIC
  • Why MCP in SIC?
  • Layout in the codebase
  • Core ideas: JSON-RPC, tools, and REPL-style use
    • JSON-RPC
    • Tools
    • REPL (read-eval-print loop)
  • Architecture: LangGraph client + stdio MCP server
    • Voice demos and blocking listen tools
  • Transports
  • Effect on SIC logging
  • Optional: standalone server or external MCP host
  • Installation
  • NAO (reference implementation)
    • Server and client
    • Voice on NAO
    • Chat on NAO
    • NAO tools (overview)
    • Running the NAO demos
    • NAO demos
    • Checklist (NAO demos today)