ruseon-core

README

RUSEON Core

High-Performance Video Data Infrastructure
RTSP → HLS/WebRTC/Archive without transcoding

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

---

RUSEON Core is a high-performance video data infrastructure platform tailored for IP cameras. Operating entirely on the principle of transmuxing rather than transcoding, RUSEON Core repackages video data (H.264/H.265) into formats like HLS or WebRTC directly in RAM.

This zero-allocation approach ensures minimal CPU usage and massive scalability, making it the ideal edge bridge between CCTV hardware and your AI or Cloud workloads.

🚀 Key Features

• Zero-Allocation Transmuxing: RTSP to HLS and WebRTC without transcoding, directly in RAM for extreme performance.
• Smart Archive: Crash-resilient fMP4 recording with advanced Linux kernel I/O optimizations (sync_file_range, FADV_DONTNEED).
• AI Metadata Pipeline: Direct gRPC ingestion of AI insights (like bounding boxes), delivered via WebRTC DataChannel and HLS WebVTT with zero CPU burn.
• WebRTC/WHEP: Sub-second latency live streaming powered by Pion WebRTC.
• Event-Driven & IoT: Webhooks with circuit breaker and MQTT with a lock-free buffer for reliable integration.
• Production-Ready: Prometheus metrics, structured JSON logging, chaos-tested, and built-in pprof.

Read more about Features

🏗 Architecture & Data Flow

RUSEON uses a highly efficient Ring Buffer architecture. Video frames ingested via RTSP are stored once and referenced by all outbound streams (HLS, WebRTC) and the recording module, avoiding redundant memory copying.

flowchart TD
    CAMERA["IP Camera<br/>RTSP"] -->|TCP / UDP| CORE["RUSEON Core"]

    CORE --> RING["Ring Buffer"]

    RING --> HLS["HLS Muxer"]
    RING --> WEBRTC["WebRTC / WHEP"]
    RING --> RECORDER["fMP4 Recorder"]
    RING --> AI["AI Pipeline"]

    HLS --> BROWSER["Browsers / Players"]
    WEBRTC --> CLIENTS["Low-Latency Clients"]
    RECORDER --> ARCHIVE["Disk Archive"]
    AI --> API["gRPC / Webhooks"]

Explore System Design

🏎 Quick Start

1. Launch via Docker

The fastest way to deploy RUSEON Core is using our official Docker image. On the first run, the system will generate an admin password and print it to the console.

docker run -p 8080:8080 -v data:/app/data -v recordings:/app/recordings ghcr.io/rusegal/ruseon-core:latest

(Copy the generated admin password from the terminal logs!)

2. Access the Dashboard

Open your browser and navigate to http://localhost:8080. Log in with username admin and the generated password.

3. Add a Camera via API

You can easily manage streams dynamically via the REST API without restarting the server:

curl -X POST http://localhost:8080/api/cameras \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -d '{"id":"cam1","url":"rtsp://user:pass@192.168.1.100:554/stream","record":true}'

Read the full Quick Start Guide

📊 Performance

RUSEON Core is designed for maximum throughput and low latency. Real-world performance is typically bound by Network I/O and Disk IOPS. CPU is rarely the bottleneck due to efficient Go concurrency and zero-allocation memory management.

View Performance Benchmarks

📖 Documentation

The official VitePress documentation is the single source of truth for RUSEON Core:

• Getting Started
• Configuration
• Architecture
• Streaming
• Archive & Recording
• API Reference
• Deployment
• Troubleshooting

⚙️ Deployment & Configuration

RUSEON Core supports Docker, Docker Compose, and bare-metal binary deployments. Configuration can be managed via config.yaml for startup parameters, while cameras and streams are managed dynamically via the embedded BadgerDB and exposed via REST API.

Read Deployment Guide

⚠️ Known Limitations

RUSEON Core is purpose-built for efficient video routing and archiving. It operates entirely on transmuxing, which means it does not transcode video. If your cameras output formats that browsers do not natively support (e.g., H.265 in some environments), you may encounter playback issues unless handled client-side or transcoded externally.

See all Known Limitations

💎 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 like SSO, Scalable Cloud Archiving (S3), and High Availability Clustering.

Ready to scale? Contact our Sales Team: rusegal.dev@yahoo.com

📄 License

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