EdgeFlow Platform

Lightweight, visual IoT automation platform for Raspberry Pi and edge devices

Website · Features · Quick Start · Tech Stack · Build Profiles · Contributing

About

EdgeFlow is a node-based automation platform that lets you build IoT workflows visually. Connect sensors, process data, trigger actions, and monitor everything from a single dashboard — no cloud required.

Single binary — deploy one Go binary + static frontend, no runtime dependencies
Built for constrained devices — runs on a Raspberry Pi Zero with ~50 MB RAM
150+ built-in nodes — GPIO, MQTT, Modbus, databases, AI, and more out of the box
Hardware-first — native GPIO support for Pi 4/5 via Linux character device, not memory-mapped hacks

Think Node-RED, but lighter, faster, and purpose-built for edge devices.

Features

Visual Flow Editor

Drag-and-drop node canvas with 150+ pre-built node types
Real-time execution tracing and debug panel
Sub-flow support for reusable logic
Built-in terminal, logs, and system monitoring panels

Hardware Integration

Raspberry Pi 4/5 GPIO via Linux character device (gpiocdev)
I2C sensors (BME280, BMP280, BH1750, AHT20, ADS1015, and more)
PIR motion, HC-SR04 ultrasonic, relay, LED, button
Software PWM and edge detection

Industrial & Wireless Protocols

MQTT, Modbus TCP/RTU, OPC-UA, BACnet, CAN Bus, PROFINET
BLE, Zigbee, Z-Wave, LoRa, NFC, RFID, RF433, IR

Integrations

AI/LLM: OpenAI, Anthropic, Ollama
Databases: SQLite, PostgreSQL, MySQL, MongoDB, Redis, InfluxDB
Cloud Storage: AWS S3, Google Drive, Dropbox, OneDrive
Messaging: Email, Telegram, Slack, Discord
HTTP webhooks and REST APIs

Monitoring & Debugging

CPU, memory, disk, temperature, network speed
GPIO state visualization
Execution history with structured logs
Web-based interactive terminal

Quick Start

Prerequisites

Go 1.24+
Node.js 18+
Git

Run Locally

# Clone
git clone https://github.com/EdgxCloud/EdgeFlow.git
cd EdgeFlow
# Build & run backend
make run
# In another terminal — build frontendcd web
npm install
npm run dev

Open http://localhost:5173 (dev) or http://localhost:8080 (production build).

Docker

docker compose up -d

Raspberry Pi

# Build for ARM64
make build-pi-standard
# Install as service
sudo cp deploy/edgeflow-backend.service /etc/systemd/system/
sudo systemctl enable --now edgeflow-backend

Tech Stack

Layer	Technology
Backend	Go 1.24, Fiber v2, Zap logging
Frontend	React 18, TypeScript, Vite, Tailwind CSS
Flow Canvas	React Flow (`@xyflow/react`)
Code Editor	Monaco Editor
UI Components	Radix UI
State	Zustand
Hardware	`go-gpiocdev` (Linux character device)
Protocols	MQTT (Paho), Modbus, OPC-UA
Databases	SQLite, PostgreSQL, MySQL, MongoDB, Redis, InfluxDB
Auth	JWT, API key

Node Categories

150+ nodes across 10 categories:

Category	Count	Examples
Core	25+	inject, debug, function, switch, template, delay, trigger, filter
GPIO	15+	digital in/out, PWM, PIR, HC-SR04, DHT, BMP280, servo
Network	10+	HTTP request, webhook, TCP, UDP, FTP, CSV/JSON parser
Database	6	SQLite, PostgreSQL, MySQL, MongoDB, Redis, InfluxDB
Messaging	4	Email, Telegram, Slack, Discord
AI/ML	3	OpenAI, Anthropic, Ollama
Industrial	5	Modbus TCP/RTU, OPC-UA, BACnet, CAN Bus, PROFINET
Wireless	10+	BLE, Zigbee, Z-Wave, LoRa, NFC, RFID, RF433, IR
Dashboard	12	Chart, gauge, button, slider, switch, table, form, template
Cloud Storage	5	AWS S3, Google Drive, Dropbox, OneDrive, SFTP

Build Profiles

Three build profiles optimized for different hardware:

Profile	Target	Binary Size	RAM Usage
Minimal	Pi Zero, BeagleBone	~10 MB	~50 MB
Standard	Pi 3, Orange Pi	~20 MB	~200 MB
Full	Pi 4/5, Jetson	~35 MB	~400 MB

make build PROFILE=minimal # Pi Zero / constrained devices
make build PROFILE=standard # Pi 3/4 / general use
make build PROFILE=full # Pi 4/5 / all features

Configuration

Copy .env.example to .env and configure:

EDGEFLOW_SERVER_HOST=0.0.0.0
EDGEFLOW_SERVER_PORT=8080
EDGEFLOW_DATABASE_TYPE=sqlite
EDGEFLOW_DATABASE_PATH=./data/edgeflow.db
EDGEFLOW_LOGGER_LEVEL=info

Project Structure

EdgeFlow Platform
├── cmd/edgeflow/ # Application entry point
├── internal/
│ ├── api/ # REST API handlers (Fiber)
│ ├── engine/ # Flow execution engine & scheduler
│ ├── hal/ # Hardware Abstraction Layer (GPIO, I2C, SPI, Serial)
│ ├── node/ # Node registry & message framework
│ ├── storage/ # File, SQLite, Redis backends
│ ├── websocket/ # Real-time WebSocket hub
│ ├── resources/ # System monitoring (CPU, memory, temp)
│ ├── security/ # JWT & API key auth
│ ├── logger/ # Structured logging (Zap)
│ ├── plugin/ # Plugin system
│ └── subflow/ # Nested flow support
├── pkg/nodes/
│ ├── core/ # Inject, debug, function, switch, template, delay...
│ ├── gpio/ # PIR, HC-SR04, LED, relay, button, sensors
│ ├── network/ # HTTP request/webhook, FTP, CSV/JSON parsers
│ ├── database/ # SQLite, PostgreSQL, MySQL, MongoDB, Redis, InfluxDB
│ ├── messaging/ # Email, Telegram, Slack, Discord
│ ├── ai/ # OpenAI, Anthropic, Ollama
│ ├── industrial/ # Modbus, OPC-UA, BACnet, CAN Bus, PROFINET
│ ├── wireless/ # BLE, Zigbee, Z-Wave, LoRa, NFC, RF433, IR
│ ├── storage/ # S3, Google Drive, Dropbox, OneDrive, SFTP
│ └── dashboard/ # UI widgets (chart, gauge, table, form, button...)
├── web/ # React + TypeScript frontend (Vite)
├── configs/ # Default configuration
├── deploy/ # Systemd service files
└── docker-compose.yml

REST API

Base URL: /api/v1

Endpoint	Method	Description
`/flows`	GET, POST	List / create flows
`/flows/:id`	GET, PUT, DELETE	Get / update / delete flow
`/flows/:id/start`	POST	Start flow execution
`/flows/:id/stop`	POST	Stop flow
`/flows/:id/nodes`	GET, POST	List / add nodes
`/flows/:id/connections`	GET, POST	List / add connections
`/node-types`	GET	List all 150+ node types
`/executions`	GET	Execution history
`/resources/stats`	GET	CPU, memory, disk stats
`/system/info`	GET	System info, temperature, uptime
`/modules`	GET	Installed modules
`/modules/install`	POST	Install a module
`/health`	GET	Health check

WebSocket:/ws (logs, debug, execution events), /ws/terminal (interactive shell)

Roadmap

See the open issues for a full list of proposed features and known issues.

Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or pull requests — all contributions help make EdgeFlow better.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd		cmd
configs		configs
deploy		deploy
internal		internal
modules		modules
pkg		pkg
sample-workflows		sample-workflows
scripts		scripts
tests		tests
web		web
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
build.config.yaml		build.config.yaml
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
edgeflow-linux-arm64		edgeflow-linux-arm64
go.mod		go.mod
go.sum		go.sum

Navigation Menu

Uh oh!

Repository files navigation

EdgeFlow Platform

About

Features

Quick Start

Prerequisites

Run Locally

Docker

Raspberry Pi

Tech Stack

Node Categories

Build Profiles

Configuration

Roadmap

Contributing

Community

License

About

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

EdgeFlow Platform

About

Features

Quick Start

Prerequisites

Run Locally

Docker

Raspberry Pi

Tech Stack

Node Categories

Build Profiles

Configuration

Roadmap

Contributing

Community

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages