Repolode
Edgenesis

Edgenesis/shifu

A Kubernetes-native IoT gateway that lets developers connect devices over HTTP, MQTT, RTSP, OPC UA and other protocols as cluster resources.

Stars
1,436
Forks
136
Open issues
23
Last commit
2 days ago

What is it?

Shifu is an IoT gateway built on Kubernetes. It represents each physical device as a DeviceShifu, a pod that holds the device's driver and acts as a digital twin inside the cluster. Devices are integrated through a custom resource called shifu, so they can be managed with the same tooling used for other Kubernetes workloads.

The project aims to let application developers focus on their apps rather than maintaining separate operations infrastructure for devices. It is protocol and vendor agnostic: the README lists HTTP, MQTT, RTSP, Siemens S7, TCP sockets and OPC UA, and its microservice design is meant to make adding new protocols straightforward. It can run on edge hardware such as Raspberry Pi, on edge clusters, or in public, private and hybrid clouds.

The project is Apache-2.0 licensed and is a CNCF landscape project. Documentation, device connection guides and a hosted demo are available on its website.

Key features

  • 01Maps each physical device to a Kubernetes pod acting as a digital twin.
  • 02Integrates devices through a custom resource named shifu.
  • 03Supports HTTP, MQTT, RTSP, Siemens S7, TCP sockets and OPC UA.
  • 04Runs on edge devices such as Raspberry Pi as well as cloud and hybrid clusters.

Use cases

  • Connecting proprietary-protocol cameras or PLCs to a Kubernetes cluster.
  • Building edge IoT applications without running separate device management infrastructure.
  • Integrating industrial equipment that speaks OPC UA or Siemens S7 into cloud-native workflows.

Quick start

  1. 1

    Install Shifu by following the official install guide linked in the README

  2. 2

    Try the online KillerCoda demo without installing anything

Things to know

  • Requires a Kubernetes cluster, so setup is more involved than a standalone tool.

In collections

Topics

FAQ

What is shifu?
A Kubernetes-native IoT gateway that lets developers connect devices over HTTP, MQTT, RTSP, OPC UA and other protocols as cluster resources. Shifu is an IoT gateway built on Kubernetes. It represents each physical device as a DeviceShifu, a pod that holds the device's driver and acts as a digital twin inside the cluster. Devices are integrated through a custom resource called shifu, so they can be managed with the same tooling used for other Kubernetes workloads.
Is shifu free to use? What license does it have?
shifu is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is shifu still maintained?
Actively maintained. The last commit to shifu was on Nov 5, 2026.
What can I use shifu for?
Connecting proprietary-protocol cameras or PLCs to a Kubernetes cluster. Building edge IoT applications without running separate device management infrastructure. Integrating industrial equipment that speaks OPC UA or Siemens S7 into cloud-native workflows.
How do I install shifu?
Install Shifu by following the official install guide linked in the README Try the online KillerCoda demo without installing anything
Where can I get shifu?
The source code and installation instructions are on GitHub: https://github.com/Edgenesis/shifu

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects