Skip to content

Welcome to Wiverno

Wiverno is a lightweight WSGI framework for building fast and flexible Python web applications.

Why Wiverno?

  • 🚀 Fast: Built on WSGI with minimal overhead
  • 🎯 Simple: Clean and intuitive API
  • 📦 Lightweight: Minimal dependencies, maximum performance
  • 🔧 Flexible: Easy to extend and customize
  • 🐍 Modern Python: Built for Python 3.12+

Features

  • Simple routing system - Define routes with decorators
  • Request/Response handling - Clean abstractions for HTTP requests
  • Template engine integration - Built-in Jinja2 support via Templator
  • Class-based views - BaseView for better code organization
  • Development server - Hot-reload during development
  • CLI tools - Command-line interface for common tasks

Quick Example

from wiverno.main import Wiverno

app = Wiverno()

@app.get("/")
def index(request):
    return "Hello, World!"

Save this as run.py and run:

wiverno run dev

Visit http://localhost:8000 to see your app in action!

Getting Started

  • Quick Start

Get up and running in minutes with our quick start guide.

Quickstart

  • User Guide

Learn the core concepts and features of Wiverno.

Read the Guide

  • API Reference

Detailed documentation of all classes and functions.

API Docs

  • Contributing

Want to contribute? Check out our development guide.

Development

Installation

Install Wiverno using pip:

pip install wiverno

Or install from source:

git clone https://github.com/Sayrrexe/Wiverno.git
cd Wiverno
pip install .

For development:

pip install -e ".[dev]"

Community

License

Wiverno is licensed under the MIT License.