Files
labFusion/services/service-adapters
glenn schrooyen 8d1755fd52
Some checks failed
API Docs (Node.js Express) / test (16) (push) Failing after 5m29s
API Docs (Node.js Express) / test (18) (push) Failing after 5m25s
API Docs (Node.js Express) / test (20) (push) Failing after 1m4s
API Docs (Node.js Express) / build (push) Has been skipped
API Docs (Node.js Express) / security (push) Has been skipped
LabFusion CI/CD Pipeline / api-gateway (push) Failing after 4m52s
LabFusion CI/CD Pipeline / service-adapters (push) Failing after 5m1s
LabFusion CI/CD Pipeline / api-docs (push) Failing after 5m12s
LabFusion CI/CD Pipeline / frontend (push) Failing after 6m39s
LabFusion CI/CD Pipeline / integration-tests (push) Has been skipped
LabFusion CI/CD Pipeline / security-scan (push) Has been skipped
Docker Build and Push / build-and-push (push) Failing after 34s
Docker Build and Push / security-scan (push) Has been skipped
Integration Tests / integration-tests (push) Failing after 1m33s
Integration Tests / performance-tests (push) Has been skipped
Service Adapters (Python FastAPI) / test (3.1) (push) Failing after 35s
Service Adapters (Python FastAPI) / test (3.11) (push) Failing after 5m20s
Service Adapters (Python FastAPI) / test (3.12) (push) Failing after 5m27s
Service Adapters (Python FastAPI) / test (3.9) (push) Failing after 5m50s
Docker Build and Push / deploy-staging (push) Has been skipped
Service Adapters (Python FastAPI) / build (push) Has been skipped
Service Adapters (Python FastAPI) / security (push) Has been skipped
Docker Build and Push / deploy-production (push) Has been skipped
Refactor API Docs CI workflow to correct ESLint command syntax and enhance Python formatting in CI pipelines; update progress tracking documentation
2025-09-12 17:44:23 +02:00
..
2025-09-11 22:08:12 +02:00
2025-09-11 22:08:12 +02:00
2025-09-11 22:08:12 +02:00

Service Adapters

Python FastAPI service for integrating with external homelab services.

Purpose

  • Integrate with Home Assistant, Frigate, Immich, n8n
  • Transform external service data into standardized format
  • Publish events to the message bus
  • Provide unified API for service data

Technology Stack

  • Language: Python 3.11
  • Framework: FastAPI
  • Port: 8000
  • Message Bus: Redis
  • Documentation: OpenAPI/Swagger

Features

  • Home Assistant entity integration
  • Frigate event processing
  • Immich asset management
  • n8n workflow triggers
  • Event publishing to Redis
  • Comprehensive OpenAPI documentation
  • Modular architecture for maintainability

Project Structure

service-adapters/
├── main.py                 # FastAPI application (40 lines)
├── models/
│   ├── schemas.py          # Pydantic models
├── routes/
│   ├── general.py          # Root, health, services
│   ├── home_assistant.py   # HA integration
│   ├── frigate.py          # Frigate integration
│   ├── immich.py           # Immich integration
│   └── events.py           # Event management
└── services/
    ├── config.py           # Service configurations
    └── redis_client.py     # Redis connection

API Endpoints

  • GET / - API information
  • GET /health - Health check
  • GET /services - Service status
  • GET /home-assistant/entities - HA entities
  • GET /frigate/events - Frigate events
  • GET /immich/assets - Immich assets
  • POST /publish-event - Publish events
  • GET /events - Retrieve events

Development Status

Complete - Core functionality implemented with modular architecture