Skip to content

fluidos-project/quick-start-guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Service CI Status
Node build Node - Command Stack
Node Artifacts Node - Command Stack
Node Helm Docs Node - Command Stack
Node Linting Node - Command Stack
Node Build Deployment Node - Command Stack

💡 About

The IT landscape is hyperconnected: devices and information systems continuously exchange data across edge, fog, and cloud. FLUIDOS taps into unused compute anywhere—edge devices, network edge, fog, and cloud—to create a seamless computing continuum.
This repository collects quick-starts and links to the Release 2 components, playgrounds, and reproducible use cases.

⭐ Give a Star!

Support this research by giving it a star. Thanks!

Documentation

The latest project-wide docs (architecture, concepts, and component guides) live in the Docs repository.
For hands-on setup, each component repo also includes quick-start instructions referenced below.

🖥️ Software components (Release 2 of the integrated MetaOS)

Core components (Release 2)

FLUIDOS Node
  • Base component (one Kubernetes control plane per node) with Broker and telemetry endpoint in REAR, plus integration with Liqo v1.0.0 for stable federation and peering.
  • Repo: https://github.com/fluidos-project/node
FLUIDOS Edge
FLUIDOS MetaOrchestration
kubectl FLUIDOS plugin
FLUIDOS Identity Management (PSM, DID/VC, JWT)
FLUIDOS Cyber Deception (CDaaS)
FLUIDOS Energy Predictors
Security Enhancements & Optional Features (WP5)

New in Release 2

FLUIDOS Node Dashboard
Telemetry & OpenTelemetry Collector

Current standalone components

Serverless Function

💻 Click-and-play playground

Quick paths to spin up minimal FLUIDOS setups on your machine or lab.

FLUIDOS Node

FLUIDOS Node

  • Set up a FLUIDOS Node testbed using KIND (Kubernetes in Docker), the simplest local install path.
    👉 Begin here.
FLUIDOS at the Edge

FLUIDOS at the Edge

  • Minimal architecture to run FLUIDOS components on constrained boards (e.g., STM) using KubeEdge.
    👉 Project repo.
FLUIDOS Identity Management

FLUIDOS Identity Management

  • Build a functional demo with DIDs, Verifiable Credentials, and REAR integration.
    👉 Guideline.
FLUIDOS Node Dashboard (Release 2)

FLUIDOS Node Dashboard

  • Web UI to browse, reserve, and purchase resources through REAR; deploy via Kubernetes manifests and expose via NodePort services.
    👉 Project repo
Telemetry & OTEL Collector (Release 2)

Telemetry & OTEL

🕹️ Playgrounds (integrated demonstrators)

The playgrounds are reproducible testbeds that integrate Node, Meta-Orchestrator, Identity/Security, and Observability, and capture KPI evidence.

  • FLUIDOS CoreNet (UMU) — Security & privacy by design (PSM, DID/VC, REAR contracts and PEP-protected endpoints).
    Repo: (see D9.3 for replication guide)

  • FLUIDOS LiveGrid (POLITO) — Heterogeneous Cloud↔Edge continuum with centralized observability; validated on x86 and ARM (e.g., Tiesse routers); Edge→Cloud (LLM+GPU) and Cloud→Edge scenarios.
    Repos: edge infra installer (POLITO), plus FLUIDOS Node

  • FLUIDOS FlexSim (FBK) — Large-scale simulation (KWOK) integrating Node/Liqo/Meta-Orchestrator to stress-test scheduling and security.

  • FLUIDOS SmartCity (MARTEL) — “Smart City in a box” pipeline showing FLUIDOS in a real urban scenario, with replication guidelines.

  • FLUIDOS Broker (TOPIX) — Acts as a communication and routing hub where nodes can publish their announcements in order to make themselves visible to other participants in the FluidOS network.

  • FLUIDOS SensorFlow(HMU) — Demonstrates node–edge–IoT integration by connecting cloud clusters with edge gateways and real IoT devices to enable end-to-end data acquisition, processing and secure sharing.

🧪 Use cases (reproducible)

🗺️ Roadmap

  • Jan 2025: Upgrade of the FLUIDOS MetaOS to Liqo 1.0 (completed).
  • Oct 2025: Release 2 delivered (Node Dashboard, Telemetry/OTEL, R2 component updates, new playgrounds & reproducible use cases).

Contributors 11