ncorn 1.0.1

ASGI web server for FastAPI applications

Features

• Fast Performance - Built on asyncio for high performance
• ASGI Compatible - Full ASGI interface support for FastAPI
• Production Ready - Rate limiting, request validation, slowloris protection
• Multi-Worker - Support for multiple worker processes
• Auto-Reload - Development mode with file watching
• Clean Logging - Beautiful uvicorn-style console output
• Security - Header validation, body size limits, IP rate limiting

Security Features

• Max Body Size - Limits request body to prevent DoS attacks
• Header Validation - Validates HTTP headers and rejects invalid requests
• Slowloris Protection - Timeout for header and body reads
• IP Rate Limiting - Limits requests per IP address

Installation

pip install ncorn

Quick Start

ncorn example_app:app

With custom host and port:

ncorn example_app:app --host 0.0.0.0 --port 8080

Multiple workers:

ncorn example_app:app --workers 4

Auto-reload on file changes:

ncorn example_app:app --reload

Configuration

Create a config file:

ncorn config

This creates ncorn.cnf with default settings. You can edit this file and ncorn will use these settings by default.

Example configuration:

{
    "host": "127.0.0.1",
    "port": 8000,
    "workers": 1,
    "reload": false,
    "max_body_size": 16777216,
    "header_timeout": 30.0,
    "rate_limit_requests": 100,
    "rate_limit_window": 60.0
}

Command line options override config file settings.

Example FastAPI App

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI(title="Example App")

class Item(BaseModel):
    name: str
    price: float
    tax: float | None = None

@app.get("/")
async def root():
    return {"message": "Hello from ncorn!"}

@app.get("/health")
async def health():
    return {"status": "healthy"}

@app.post("/items")
async def create_item(item: Item):
    total = item.price + (item.tax or 0)
    return {"name": item.name, "total": total}

Run it:

ncorn example_app:app

License

MIT License - see LICENSE file for details.