Kemal - Fast, Effective, Simple Web Framework for Crystal

Build web applications and APIs with minimal code. 3.8k+ ⭐, 5M+ downloads since 2015.

---

Quick Start

1. Create a new project

   crystal init app my-app
   cd my-app
   

2. Add Kemal to shard.yml

   dependencies:
     kemal:
       github: kemalcr/kemal
   

3. Write your app - replace src/my-app.cr with:

   require "kemal"
   
   get "/" do
     "Hello World!"
   end
   
   get "/api" do |env|
     env.response.content_type = "application/json"
     {status: "ok"}.to_json
   end
   
   Kemal.run
   

4. Install dependencies and run

   shards install
   crystal run src/my-app.cr
   

Visit http://localhost:3000 - done in under a minute. 🚀

---

Why Kemal?

---

Key Features

• 🚀 High-performance by default - Built on Crystal with a thin abstraction layer
• 🌐 Full REST & HTTP support - All HTTP verbs with a straightforward routing DSL
• 🔌 WebSocket & real-time - First-class WebSocket support
• 📦 JSON-first APIs - Native JSON handling
• 🗄️ Static assets - Serve files efficiently from the same application
• 📝 Template engine - Built-in ECR template engine
• 🔒 Composable middleware - Logging, auth, rate limiting, metrics
• 🎯 Ergonomic request/response - Simple params, headers, cookies via context
• 🍪 Session management - Production-ready via kemal-session

---

Performance

Kemal is built on Crystal. It compiles to native code and starts instantly.

No JVM, no Node, no Ruby VM. Just a native binary.

---

How Kemal compares

---

Philosophy

Kemal aims to be a simple, fast and reliable foundation for building production-grade web applications and APIs in Crystal.

• Simple core, powerful building blocks - The core is intentionally simple. Most power comes from Crystal and middleware, not hidden magic.
• Performance as a baseline - Crystal's native speed means high performance is the default. Kemal keeps abstractions thin.
• Minimal assumptions, maximum flexibility - No forced ORM, template engine, or project layout. Choose your own tools.
• Batteries within reason - Ships with essentials (routing, middleware, templates, static files) while keeping advanced concerns in separate shards.

---

Learning Resources

• 📚 Official Documentation
• 💻 Example Applications
• 🚀 Kemal Guide
• 💻 Kemal By Example
• 💬 Community Chat

---

FAQ

Is Kemal production ready?

Yes. Kemal has been used in production since 2015 with 5M+ downloads.

Does Kemal support WebSocket?

Yes, built-in. No extra dependencies needed.

Can I build a REST API with Kemal?

Yes. JSON handling is built-in. Return hashes or JSON directly from routes.

Does Kemal support the HTTP QUERY method?

Yes. QUERY (RFC 10008) is a safe, idempotent method that carries the query in the request body instead of the URL:

query "/search" do |env|
  q = env.params.json["q"]? # or env.params.body for form-encoded queries
  search_products(q).to_json
end

before_query / after_query filters and Kemal::Router#query work like every other verb. A QUERY request that has a body but no Content-Type header is rejected with 400 per the RFC.

Does Kemal work with any ORM?

Yes. You can use any Crystal ORM or database library. No forced dependencies.

How is Kemal different from Sinatra / Flask / Express?

Kemal compiles to a native binary with Crystal. You get C-like performance, type safety, and single-binary deployment. Sinatra and Flask are interpreted. Express runs on Node's event loop.

---

Sponsors

If Kemal helps you or your company, consider sponsoring. Your support helps me maintain Kemal and build the Crystal ecosystem full time.

Corporate

Marsus

Crystal Champions

Fatih Kadir Akın

Backers

Supporters

---

Contributing

We love contributions! Please read our Contributing Guide.

Security

To report a security vulnerability, please see our Security Policy.

---

Acknowledgments

Special thanks to Manas for their work on Frank.

---

License

MIT