Skip to content

ViperHTTP

ViperHTTP Logo

Blazing-fast async HTTP server for MicroPython on ESP32
Native C core + FastAPI-style Python API

What is ViperHTTP?

ViperHTTP is a high-performance HTTP server stack designed for ESP32 microcontrollers. It splits work across both ESP32 cores — a native C runtime handles parsing, routing, and static serving on Core 0, while MicroPython runs your application logic on Core 1 with a familiar, FastAPI-style developer API.

Key Features

  • :zap: 10x Performance

    Native C parser, router, and static server with zero-copy parsing and compile-time buffer limits.

  • :electric_plug: WebSocket

    Real-time bidirectional communication with connection manager, rooms, and broadcast.

  • :lock: HTTPS + HTTP/2

    TLS encryption, HPACK header compression, and stream multiplexing.

  • :shield: Security Stack

    Sessions, CSRF tokens, auth backends, trusted host validation, and rate limiting.

  • :satellite: OTA Updates

    SHA256-verified over-the-air firmware updates with progress tracking.

  • :wrench: FastAPI-Style DX

    Decorators, Depends(), typed parameters, router groups, and middleware chain.

Quick Start

import network
import viperhttp

wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("SSID", "PASSWORD")
while not wlan.isconnected():
    pass

app = viperhttp.ViperHTTP(title="Device API", version="1.0.0")

@app.get("/hello")
def hello():
    return {"message": "Hello from ESP32!"}

app.run(port=8080, wifi=False)

Documentation

Section Description
Getting Started WiFi setup, first route, testing
API Reference Complete configuration and API surface
Features Overview of all features
Middleware Middleware chain and built-in middleware
Authentication Auth backends and session-based auth
WebSocket Real-time communication guide
Security Security features and best practices
Responses JSON, streaming, SSE, templates
OTA Updates Firmware update lifecycle

Architecture

Description
Bridge & IPC Dual-core communication and request dispatch
Parser Contract HTTP parser specification and limits
Performance Benchmarking methodology and regression testing

Build & Run

Description
Build and Flash Firmware compilation and flashing
Operations Device operations checklist
Examples Runnable example applications