Hanami 3.0.2とは？保守しやすいRuby Webフレームワーク

ページ内ナビ

概要

Hanamiは保守性を重視したfull-stack Ruby web frameworkです。Router、Action、View、DB、Assetsなどを単一目的のlibraryとして分離し、このrepositoryがそれらをapplicationとして結び付けます。現在のversionは3.0.2で、Hanami 3系はRuby 3.3以上を要求します。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：2026-10-06

主な特徴

Router・Action・View・DBを独立componentとして組み合わせる

HTTP routing、Rack action、view/template、database relation/repository/migration、asset管理を別libraryとして構成し、必要なcomponentだけを組み合わせられます。full-stack構成でも各層の責務を分離しやすい設計です。

出典：[2]

sliceとproviderで大きなapplicationを境界ごとに分割する

Hanami applicationはslice単位でcomponentや設定を分離でき、providerを通じてdependencyを登録・起動できます。3.0系ではmailer、i18n、structured/tagged logging、DB logging等の統合も強化されています。

出典：[5]

向いている用途

長期保守するRuby backendや境界を明示したmodular monolithに向く

Railsより明示的なcomponent境界やdependency managementを重視し、Web、API、DB、background componentをapplication domainごとに整理したいRuby projectに適します。

出典：[2][5]

導入前の確認

Hanami 3系はRuby 3.3+。複数gemのversionとupgrade境界をまとめて確認する

3.0.0でRuby 3.3以上が必須になり、framework全体はRouter、Action、View、DB等の複数gemで構成されます。upgrade時はhanami本体だけでなく各componentのCHANGELOGも確認してください。Unreleasedではin-process code reload等も進行中なのでproductionではreleased versionを固定するのが安全です。

出典：[4][5]

参考にした公式資料

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

編集部からの補足

full-stackでありながらcomponent境界を明示しやすい点が特徴です。Hanami 3系はRuby 3.3以上が必須で、Router/Action/View/DB等は別gemとして進化するため、upgradeではframework本体だけでなく各componentの変更も確認してください。

3ステップで試す

1
ソースを取得
git clone --depth 1 https://github.com/hanami/hanami.git
2
リポジトリへ移動
cd hanami
3
公式手順を確認
READMEのInstallation / Quick Start / Getting Startedにある公式コマンドを続けて実行してください。
find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit

公式READMEで確認

成長

成長の推移 · 直近30日

6,422 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit（直近30日）: 12
Open PR: 8

開発アクティビティを蓄積中です。

Built with

Ruby

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHubで見る

GitHub Topics

hanami
ruby
web
web-application
api
ruby-application

Stars: 6,422
Forks: 554
Watchers: 176
Open Issues: 24
Contributors: 164
所有者種別: Organization
主要言語: Ruby
ライセンス: MIT
リポジトリ最終更新: 2026/10/05