Documentation | Latest releases | Get support
http-kit is a minimalist and highly efficient Ring-compatible HTTP client+server for Clojure.
It uses an event-driven architecture to support highly concurrent a/synchronous web applications, and features a simple unified API for WebSocket and HTTP long-polling/streaming.
2023-06-302.7.0: changes
See here for earlier releases.
Links below may point to the unmaintained and outdated legacy website. Efforts are underway to migrate and update info from there on the new community wiki.
-
Ring compliant: http-kit is an (almost) drop-in replacement for the standard Ring Jetty adapter. So you can use it with all your current libraries (e.g. Compojure) and middleware.
-
High performance: Using an event-driven architecture like Nginx, HTTP-kit is very, very fast. It comfortably handles tens of thousands of requests/sec on even midrange hardware. Here is another test about how it stacks up with others.
-
High concurrency: It's not only fast, but efficient! Each connection costs nothing but a few kB of memory. RAM usage grows O(n) with connections.
-
Clean, simple, small: Written from the ground-up to be lean, the entire client/server is available as a single ~90kB JAR with zero dependencies and ~3k lines of (mostly Java) code.
-
Sync or async: Synchronous is simple. Asynchronous is fast & flexible. With http-kit you get the best of both with a simple API that lets you mix & match to best fit your use case.
-
WebSockets and Comet: With great out-the-box support for both WebSockets and efficient handling of long-held HTTP requests, realtime web applications are a breeze to write.
http-kit was created by @shenfeng, but is currently being maintained by its community.
A big thank-you to the current contributors for keeping the project going! Additional contributors very welcome: please ping me if you'd be interested in lending a hand.
- Full documentation (getting started and more)
- Auto-generated API reference: Codox, clj-doc
Copyright © 2012-2023 Feng Shen and contributors.
Licensed under Apache 2.0.