OSS TanbouSign in with GitHub

Compose maintainable Ruby applications from focused router, action, view, database, and asset components

About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
6,422
Primary language
Ruby
License
MIT
Repository last updated
Oct 5, 2026
On this page

Overview

Hanami is a full-stack Ruby web framework focused on maintainability. Router, Action, View, DB, Assets, and related capabilities are split into single-purpose libraries, while this repository provides the application glue. The current version is 3.0.2, and Hanami 3 requires Ruby 3.3 or newer.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Key features

Compose focused Router, Action, View, and DB components instead of one monolithic framework layer

HTTP routing, Rack actions, views and templates, database relations and repositories, migrations, and asset management are provided through separate libraries that can be used independently or together in a full Hanami application.

Sources: [2]

Use slices and providers to separate application boundaries and dependencies

Hanami applications can isolate components and configuration by slice and register dependencies through providers. The 3.0 line also expands integrations for mailers, i18n, structured and tagged logging, and database logging.

Sources: [5]

Best fit

Fits long-lived Ruby backends and modular monoliths that value explicit boundaries

Hanami suits teams that prefer explicit component boundaries and dependency management and want to organize web, API, database, and supporting components by application domain.

Sources: [2][5]

Before adoption

Hanami 3 requires Ruby 3.3+ and upgrades span multiple coordinated gems

Version 3.0.0 raised the minimum Ruby version to 3.3. Because the framework is assembled from Router, Action, View, DB, and other gems, upgrades should review the changelogs of those components as well as the main framework. Unreleased development includes in-process code reloading, so production should pin released versions.

Sources: [4][5]

Official sources

  1. [1]hanami/hanami — GitHub repository(2026-10-06)
  2. [2]Hanami — README(2026-10-06)
  3. [3]Hanami — version source(2026-10-06)
  4. [4]Hanami — hanami.gemspec(2026-10-06)
  5. [5]Hanami — CHANGELOG(2026-10-06)
  6. [6]Hanami — MIT License(2026-10-06)
Supplemental curator note

Hanami is full-stack while keeping component boundaries explicit. Hanami 3 requires Ruby 3.3 or newer, and Router, Action, View, DB, and related components evolve as separate gems, so upgrades should review their changes together.

Try it in 3 steps

  1. 1

    Get the source

    git clone --depth 1 https://github.com/hanami/hanami.git
  2. 2

    Enter the repository

    cd hanami
  3. 3

    Check the official steps

    Continue with the commands in the README Installation, Quick Start, or Getting Started section.

    find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
Check the official README

Growth

Growth trends · Last 30 days

6,422 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
12
Open PRs
8

Development activity is still being collected.

Built with

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

GitHub Topics

  • hanami
  • ruby
  • web
  • web-application
  • api
  • ruby-application
Stars
6,422
Forks
554
Watchers
176
Open issues
24
Contributors
164
Owner type
Organization
Primary language
Ruby
License
MIT
Repository last updated
Oct 5, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?