wifi-densepose-api

REST and WebSocket API layer for the WiFi-DensePose pose estimation system.

Overview

wifi-densepose-api provides the HTTP service boundary for WiFi-DensePose. Built on axum, it exposes REST endpoints for pose queries, CSI frame ingestion, and model management, plus a WebSocket feed for real-time pose streaming to frontend clients.

Status: This crate is currently a stub. The intended API surface is documented below.

Planned Features

• REST endpoints -- CRUD for scan zones, pose queries, model configuration, and health checks.
• WebSocket streaming -- Real-time pose estimate broadcasts with per-client subscription filters.
• Authentication -- Token-based auth middleware via tower layers.
• Rate limiting -- Configurable per-route limits to protect hardware-constrained deployments.
• OpenAPI spec -- Auto-generated documentation via utoipa.
• CORS -- Configurable cross-origin support for browser-based dashboards.
• Graceful shutdown -- Clean connection draining on SIGTERM.

Quick Start

// Intended usage (not yet implemented)
use wifi_densepose_api::Server;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let server = Server::builder()
        .bind("0.0.0.0:3000")
        .with_websocket("/ws/poses")
        .build()
        .await?;

    server.run().await
}

Planned Endpoints

Related Crates

License

MIT OR Apache-2.0