Swiftpack.co - hummingbird-project/hummingbird as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by hummingbird-project.
hummingbird-project/hummingbird 1.0.0-alpha.1
Lightweight, flexible HTTP server framework written in Swift
⭐️ 238
🕓 1 week ago
iOS tvOS linux macOS iOS
.package(url: "https://github.com/hummingbird-project/hummingbird.git", from: "1.0.0-alpha.1")


Lightweight, flexible server framework written in Swift.

Hummingbird consists of three main components, the core HTTP server, a minimal web application framework and the extension modules.


HummingbirdCore contains a Swift NIO based HTTP server. You will find the code for it in the hummingbird-core repository. The HTTP server is initialized with a object conforming to protocol HBHTTPResponder which defines how your server responds to an HTTP request. The HTTP server can be extended to support TLS and HTTP2 via the HummingbirdTLS and HummingbirdHTTP2 libraries also available in the hummingbird-core repository.

HummingbirdCore can be used separately from Hummingbird if you want to write your own web application framework.


Hummingbird is a lightweight and flexible web application framework that runs on top of HummingbirdCore. It is designed to require the minimum number of dependencies: swift-backtrace, swift-log, swift-nio, swift-nio-extras, swift-service-lifecycle and swift-metrics and makes no use of Foundation.

It provides a router for directing different endpoints to their handlers, middleware for processing requests before they reach your handlers and processing the responses returned, support for adding channel handlers to extend the HTTP server, extending the core HBApplication, HBRequest and HBResponse classes and providing custom encoding/decoding of Codable objects.

The interface is fairly standard. Anyone who has had experience of Vapor, Express.js etc will recognise most of the APIs. Simple setup is as follows

import Hummingbird

let app = HBApplication(configuration: .init(address: .hostname("", port: 8080)))
app.router.get("hello") { request -> String in
    return "Hello"
try app.start()

Hummingbird Extensions

Hummingbird is designed to require the least number of dependencies possible, but this means many features are unavailable to the core libraries. Additional features are provided through extensions. The Hummingbird repository comes with a HummingbirdFoundation library that contains a number of features that can only really be implemented with the help of Foundation. This include JSON encoding/decoding, URLEncodedForms, static file serving, and cookies.

Extensions provided in other repositories include

Extension Description
HummingbirdAuth Authentication framework and various support libraries
HummingbirdCompress Request decompression and response compression (uses CompressNIO)
HummingbirdFluent Interface to the Vapor database ORM (uses FluentKit)
HummingbirdRedis Interface to Redis (uses RediStack)
HummingbirdWebSocket Adds support for WebSocket upgrade to server
HummingbirdMustache Mustache templating engine
HummingbirdLambda Run hummmingbird inside an AWS Lambda


You can find reference documentation and user guides for Hummingbird here. The hummingbird-examples repository has a number of examples of different uses of the library.


Stars: 238
Last commit: 1 week ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

v1.0.0 Alpha 1
1 week ago

Major version changes

  • Add ServiceLifecycleProvider which allows you to pass in a lifecycle to the HBApplication, or create a new one. PR #142 from @slashmo
  • Remove backLog and tcpNoDelay configuration settings when using Network framework
  • Stop exporting so many symbols from dependencies.
  • Move XCTTestingSetup outside of HBApplication

Minor version changes

  • Add new XCT test setup .asyncTest for testing code using Swift Concurrency. PR #144
  • Add HBRequest.CollateBody which can be used in middleware to collate the request body. PR #147
  • Make HBApplication.Persist.driver public

Patch version changes

  • Use NIOLock instead of Lock. PR #143

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics