n8n Agents & Automation Overview

The HALO ecosystem is built around modular n8n workflows that handle specific tasks, logic, and integrations. These workflows are orchestrated through the Nexus infrastructure and communicate via APIs, MQTT, and webhooks. This design allows for extensibility, customization, and separation of concerns.

HALO uses n8n for workflow automation and orchestration across all systems. Workflows range from simple task management to complex multi-system coordination, providing the intelligent glue that connects Omnia, Apollo, Home Assistant, and Frigate into a cohesive platform.

Each workflow is designed with a specific purpose and can be triggered by time-based schedules, external API calls, MQTT messages, or manual invocation. The modular architecture allows workflows to be developed and tested independently while maintaining clear integration points with other services.

Workflow Categories

Workflows are organized into six primary categories based on their domain and integration points:

Omnia Workflows: Support user interface features like task management, calendar integration, and routine coordination. These workflows handle data persistence, external API synchronization, and provide backend services for Omnia widgets.

Home Automation Workflows: Manage device control, sensor monitoring, and reactive automation through Home Assistant integration. These workflows subscribe to device state changes and execute multi-device scenes based on conditions and schedules.

Apollo Workflows: Enable AI-assisted features including smart suggestions, content generation, and routine optimization. These workflows integrate with LLM services to provide intelligent responses and predictive automation.

Security Workflows: Process Frigate camera events, manage zone monitoring, and coordinate security-related notifications and actions. These workflows handle object detection events, recording management, and integration with Home Assistant for automated responses.

System Workflows: Handle infrastructure maintenance including backups, monitoring, updates, and service health checks. These workflows ensure the platform remains healthy and provides operational visibility.

Utility Workflows: Provide shared services used across multiple domains, including weather data, notifications, location tracking, and external API integrations.

Workflow Status

Workflows are categorized by their development and sharing status:

Public Workflows are general-purpose implementations that could be shared with the n8n community or marketplace. These workflows avoid instance-specific configuration and use environment variables for customization.

Private Workflows contain custom logic, sensitive integrations, or household-specific context that makes them unsuitable for public sharing. These workflows are tailored to specific use cases and may reference private APIs or contain business logic unique to the HALO instance.

Workflow Catalog

Omnia Workflows

Workflow Name	Purpose	Status
Task Manager	Creates, tracks, and updates personal and family task lists with support for assignments, due dates, and recurring tasks	Public
Calendar Sync	Integrates with external calendars (Google, iCloud) and maintains internal event storage for household scheduling	Public
Routine Coordinator	Manages creation, scheduling, and execution of multi-step routines that can involve devices, notifications, and user interactions	Private
Grocery List Manager	Maintains shared grocery lists with AI-assisted item addition, category organization, and routine integration	Private
Vacation Planner	Coordinates trip planning including lodging research, packing lists, budget tracking, and itinerary management	Private
Project Tracker	Manages long-term projects with task hierarchies, time tracking, and milestone monitoring	Private
Chore Assigner	Distributes household chores based on family member profiles, schedules, and completion history	Public
School Schedule Sync	Fetches academic calendars, holidays, and special events, synchronizing them with family routines and reminders	Public
Media Queue Controller	Manages media playback based on routines, events, or manual requests, integrating with streaming services	Public
Reminder Service	Delivers scheduled reminders through push notifications, email, SMS, or Home Assistant TTS based on user preferences	Public

Home Automation Workflows

Workflow Name	Purpose	Status
Home Assistant Bridge	Receives WebSocket updates from Home Assistant and translates them into HALO-wide events via MQTT	Private
Device Controller	Executes commands against Home Assistant entities including lights, switches, scenes, and scripts	Public
Sensor Data Sync	Forwards Home Assistant telemetry to databases and other services for historical tracking and analytics	Private
Lighting Scene Manager	Activates lighting scenes based on time of day, occupancy, routines, or manual triggers	Public
Climate Control	Manages thermostat settings based on occupancy detection, weather forecasts, time-of-use rates, and routines	Public
Voice Notification System	Sends text-to-speech announcements to smart speakers with message templating and quiet hours support	Public

Apollo Workflows

Workflow Name	Purpose	Status
Smart Suggestions	Analyzes patterns and context to offer proactive recommendations for task rearrangement, meal planning, and schedule optimization	Private
Content Generator	Uses LLM services to create shopping lists, event summaries, itinerary descriptions, and other text content	Public
Routine Optimizer	Studies routine execution history to identify inefficiencies and suggest improvements	Private
Vacation Draft	Generates vacation planning documents including packing lists, activity suggestions, and budget estimates using AI	Private
Sentiment Logger	Processes journal entries or voice logs to track mood patterns and emotional trends over time	Public
Model Management	Routes requests to appropriate local GGUF models or external API services based on task requirements and availability	Private
Context Memory	Maintains conversation history and user preferences across Apollo sessions for personalized responses	Private
Voice Processing	Handles speech-to-text conversion and natural language understanding for voice-based interactions	Public

Security Workflows

Workflow Name	Purpose	Status
Security Sentinel	Enforces security policies including camera scheduling, access control rules, and automated escalation procedures	Private
Zone Monitor	Watches designated camera zones for motion or object detection and triggers appropriate responses	Public
Guest Mode Manager	Temporarily adjusts security settings during known events like parties or service appointments	Public
Access Logger	Records door sensor events, camera triggers, and access attempts with timestamp and context tagging	Public
Camera Controller	Manages camera PTZ controls, recording schedules, and detection sensitivity based on modes and conditions	Public
Footage Archiver	Processes and archives significant video clips with metadata tagging and long-term storage management	Public
Frigate Event Processor	Receives and processes Frigate object detection events, applying filters and routing to appropriate handlers	Public
Video Stream Manager	Provides live camera stream access to Omnia widgets with quality adaptation and authentication	Public
Camera Health Monitor	Tracks camera connectivity, recording status, and detection performance with alerting on failures	Public
Motion Detection Handler	Processes advanced motion patterns beyond basic zone detection including dwell time and path analysis	Public

System Workflows

Workflow Name	Purpose	Status
Update Manager	Fetches and applies updates for Omnia widgets and n8n workflows from GitHub repositories	Public
Workflow Registry	Maintains an inventory of available workflows, their dependencies, and integration points	Private
Tempo Scheduler	Provides time-based triggering for workflows outside of n8n’s native scheduling capabilities	Private
Workflow Proxy	Routes workflow execution requests with authentication and rate limiting	Private
User Profile Sync	Synchronizes user data and preferences between Omnia and backend services	Private
Aether Context	Manages timeline queries, causality tracking, and state correlation across services	Private
Archive Indexer	Indexes files and media for searchable access through Omnia or Apollo	Private
Backup Service	Creates encrypted database snapshots and configuration backups on schedule	Private
Monitoring Service	Tracks container health, resource usage, and service availability with alerting	Private
GitOps Sync	Pulls configuration updates from Git repositories and applies them to running services	Private
Widget Updater	Manages Omnia widget installations, updates, and removal based on manifests	Private
System Registry	Tracks service health, startup dependencies, and inter-service connections	Private
Container Health	Monitors Docker container status and triggers restarts or escalations on failures	Private
Log Analytics	Aggregates logs across services, performs analysis, and generates operational insights	Private
Database Maintenance	Handles PostgreSQL optimization, vacuum operations, and schema migrations	Private

Utility Workflows

Workflow Name	Purpose	Status
Weather Service	Fetches local weather forecasts and current conditions for display in widgets and use in automations	Public
News Aggregator	Pulls headlines and summaries from configured sources for morning briefings or widget display	Public
Location Service	Determines user presence through phone pings, WiFi detection, and geofencing for context-aware automation	Private
SMS/Push Notifier	Sends alerts through Twilio, Pushover, or other notification services with templating and delivery tracking	Public
Finance Tracker	Monitors budgets for projects, trips, or household expenses with integration to accounting systems	Public
Gas Mileage Calculator	Estimates fuel costs for planned trips based on vehicle data and current gas prices	Public
School Calendar API	Scrapes or queries public school district calendars for automatic synchronization	Public
MQTT Bridge	Handles MQTT communication for custom IoT devices and sensors not directly supported by Home Assistant	Public
External API Gateway	Manages authentication, rate limiting, and error handling for external service integrations	Private
Webhook Handler	Processes incoming webhooks from external services with payload validation and routing	Public

Creating Workflow Documentation

When implementing new workflows, create detailed documentation by adding a markdown file to the appropriate workflow category with the following structure:

Overview: Brief description of the workflow’s purpose
Triggers: What initiates the workflow (time, webhook, MQTT, manual)
Actions: Step-by-step description of workflow operations
Integrations: Other services or APIs the workflow interacts with
Configuration: Environment variables, settings, or dependencies
Example Payloads: Sample inputs and outputs
Status: Public or Private designation with rationale

Link the new workflow documentation from the appropriate category in this catalog to maintain organization.