ruseon-core

README

RUSEON Core

Edge Video Infrastructure & AI Data Pipeline
Cloud-Native, High-Performance Video Data Platform

Read this in other languages: English, Русский.

---

RUSEON Core (Community Edition) is a state-of-the-art Enterprise Video Data Platform engineered in Go. Designed for cloud-native and edge environments, it provides zero-copy RTSP-to-HLS transmuxing, high-performance fMP4 archiving, and a seamless pipeline for AI video analytics.

Built for scale, RUSEON Core delivers massive throughput with minimal resource footprint, making it the ideal foundation for enterprise CCTV networks, smart cities, and AI data pipelines.

🚀 Key Features

• ⚡ Zero-Copy Transmuxing: Ultra-low latency bridging from RTSP to HLS directly in RAM. Bypasses intermediate transcoding for maximum efficiency.
• 🛡 Cloud-Native Resilience: Built-in Thundering Herd protection and robust OOM management to safely handle thousands of concurrent streams.
• 📦 High-Performance Archiving (fMP4): Continuous, gapless recording into fragmented MP4. Optimized for edge storage and rapid cloud synchronization.
• ⏪ Advanced Timeshift Pipeline: Real-time HLS playback of historical data, with seamless export capabilities for AI training datasets.
• 🗄 Embedded NoSQL Engine: Powered by BadgerDB for sub-millisecond configuration states and metrics, delivering high IOPS without external dependencies.
• 🎨 Modern Observability UI: Includes a React 19 (TypeScript) Edge Dashboard with JWT auth, real-time SSE telemetry, and rich timeline visualization.

---

⚔️ Why RUSEON? (Comparison)

Unlike generic media routers or legacy transcoders, RUSEON Core is purpose-built for the Edge and AI Data pipelines. We eliminate the need for heavy FFmpeg scripts and provide a production-ready, zero-copy infrastructure right out of the box.

Feature / Capability	⚡ RUSEON Core	MediaMTX	Flussonic	FFmpeg
Zero-Copy RTSP ➔ HLS	✅ Yes (Ultra-low CPU)	✅ Yes	✅ Yes	❌ Re-encoding (High CPU)
Built-in Dashboard	✅ Yes (React 19)	❌ No UI	✅ Yes	❌ CLI only
fMP4 Archiving & Timeshift	✅ Native Support	⚠️ Basic / External	✅ Yes	⚠️ Complex Scripting
State & Metrics DB	✅ BadgerDB Embedded	❌ YAML only	✅ Proprietary DB	❌ None
Cloud-Native & Dockerized	✅ 100% Ready	✅ Yes	✅ Yes	⚠️ Requires orchestration
License & Cost	🆓 Free (MIT)	🆓 Free (MIT)	💰 Expensive ($$$)	🆓 Free (GPL)
Primary Focus	Enterprise Edge, CCTV, AI	Simple Stream Routing	IPTV / Telecom	Media Transcoding

The RUSEON Advantage: Stop managing raw FFmpeg processes or building custom UIs over barebones routers. RUSEON gives you an Enterprise-grade pipeline — complete with a database, persistent archiving, and a modern dashboard — in a single, lightweight Go binary.

---

🏗 Architecture & AI Data Pipeline

RUSEON Core acts as the critical bridge between edge hardware and your AI / Cloud workloads.

graph LR
  subgraph Edge [Edge Devices / Cameras]
    Cam1[RTSP Stream]
    Cam2[RTSP Stream]
  end

  subgraph Engine [RUSEON Core]
    Demux[Zero-Copy Demuxer]
    Pool[Memory Pool]
    HLS[Edge HLS Muxer]
    Rec[fMP4 Storage Engine]
    DB[(BadgerDB)]
  end

  subgraph Cloud [Cloud & AI Infrastructure]
    Browser[Observability Dashboard]
    Player[Analytics Node]
    AI[AI / ML Pipeline]
  end

  Cam1 & Cam2 -->|H.264/H.265| Demux
  Demux --> Pool
  Pool --> HLS
  Pool --> Rec
  DB -.->|State & Config| Demux
  HLS -->|Live Feed| Player
  Rec -->|Dataset Export| AI
  Browser <-->|REST & SSE Telemetry| Demux

---

🏎 Quick Start

Prerequisites

• Docker (Recommended for rapid deployment)
• Go 1.23+ (For source builds)

Deploy via Docker (GHCR) 🐳

The fastest way to deploy RUSEON Core is using our official multi-arch Docker image:

docker run -d \
  -p 8080:8080 \
  -v ruseon-data:/data \
  --name ruseon-core \
  ghcr.io/RUSEGAL/ruseon-core:latest

The Enterprise Edge Dashboard will be available at http://localhost:8080.

Build from Source

For developers and contributors:

# 1. Clone the repository
git clone https://github.com/RUSEGAL/ruseon-core.git
cd ruseon-core

# 2. Build the Edge Dashboard (React)
cd web && npm install && npm run build && cd ..

# 3. Start the Core Engine
go mod tidy
go run ./cmd/server

(Default Credentials: admin / admin)

---

⚙️ Configuration

RUSEON Core requires a config.yaml file to run. By default, the engine will look for it in the current directory.

You can copy the provided config.example.yaml to get started:

cp config.example.yaml config.yaml

Example configuration:

server:
  port: 8080
  record_retention_days: 7

auth:
  username: "admin"
  password: "password123"

cameras:
  - id: "cam-01"
    url: "rtsp://admin:admin@192.168.1.100/stream"
    record: true

---

💎 Choose Your RUSEON Edition

RUSEON is built on an Open Core model. Start for free with the Community Edition, and upgrade to Pro or Enterprise when your video infrastructure scales and requires advanced B2B features.

Feature / Capability	🟢 Core (Community)	🔵 Pro	🟣 Enterprise
Zero-Copy Routing (RTSP/HLS)	✅ Yes	✅ Yes	✅ Yes
React Edge Dashboard	✅ Yes	✅ Yes	✅ Yes
fMP4 Archiving (Local)	✅ Yes	✅ Yes	✅ Yes
Max Cameras per Node	Unlimited (Hardware limit)	Unlimited	Unlimited
Advanced IAM & RBAC	❌ Basic Auth	✅ Role-based Access	✅ Role-based Access
SSO (Active Directory, OIDC, SAML)	❌ No	❌ No	✅ Yes
Infinite Cloud Archiving (S3 / Minio)	❌ No	❌ No	✅ Yes
Clustering & High Availability	❌ Single Node	⚠️ Basic Sync	✅ Global HA Cluster
Hardware / GPU Transcoding	❌ No	✅ NVENC / Intel QSV	✅ Distributed GPU
Support SLA	🌐 Community (GitHub)	📧 Email Support	🚀 24/7 Dedicated SLA
License / Pricing	Free (MIT)	Pay per Camera	Custom Enterprise

Ready to scale? Contact our Sales Team to request a trial key for RUSEON Enterprise and unlock SSO, S3 storage, and Clustering.

---

🤝 Contributing

We believe in the power of open-source and welcome contributions from the community. Whether it's a bug report, new feature, or documentation improvement, please see our Contributing Guidelines to get started.

Please ensure your commits follow the Conventional Commits specification.

📄 License

RUSEON Core (Community Edition) is distributed under the MIT License.