GitHubのトレンドを眺めていたら、we-promise/sure が Daily の7位に入っていました。スターは12,485で、その日だけで1,079増えています。中身は個人向けの家計簿アプリで、言語は Ruby(Rails)、ライセンスは AGPL-3.0。ログイン画面の下には「FOSS Sure (community fork of Maybe Finance)」と出ていました。
自分は家計簿アプリを選ぶとき、まず「銀行の明細を CSV で入れられるか」を見ます。手入力は3日で飽きるので。海外製のアプリは日本の明細でつまずくことが多いんですが、Sure の取り込み画面には円のような小数のない通貨向けの数値形式が用意されていました。それなら、日本の銀行明細っぽい CSV を実際に食わせてみよう、というのが今回の動機です。
試した環境(Docker を使わない手順をコンテナの中で)
README には、セルフホストするなら Docker のガイドを読んでね、と書いてあります。一方で「Local Development Setup」の節には bin/setup と bin/dev で立てる手順もあって、必要なものは Ruby・PostgreSQL・Redis の3つと書かれています。今回は後者を、使い捨ての Docker コンテナ(ruby:3.4.9-bookworm。リポジトリの .ruby-version が 3.4.9)の中でそのまま実行しました。手元の PC には何も入れていません。対象は main の 426fefe(2026-11-10 のコミット)です。
# apt で PostgreSQL・Redis・Node を入れる(52秒)
$ apt-get install -y postgresql redis-server nodejs npm socat
psql (PostgreSQL) 15.19 (Debian 15.19-0+deb12u1)
Redis server v=7.0.15
v18.20.4 # node
ruby 3.4.9 (2026-03-11 revision 76cca827ab) +PRISM [x86_64-linux]
# README の手順そのまま(clone は3秒)
$ cp .env.local.example .env.local
$ bin/setup
Bundler 2.6.9 is running, but your lockfile was generated with 2.6.7. Installing Bundler 2.6.7 and restarting using that version.
Bundle complete! 102 Gemfile dependencies, 311 gems now installed.
== Building design tokens ==
added 3 packages, and audited 4 packages in 765ms
tokens → app/assets/tailwind/sure-design-system/_generated.css (234 variables, 61 dark overrides, 38 utilities)
== Preparing database ==
Created database 'sure_development'
Run the following command to create demo data: `rake demo_data:default`
# → 終了コード 0、81秒(apt から数えて140秒)
$ rake demo_data:default
📊 Generated approximately 8613 transactions
Entries total: 8620
Trade entries: 526 (✅)
Txn categorization: 87.7% (>=75% ✅)
🎉 Demo data ready in 69.29s
# → コマンド全体では76秒
拍子抜けするくらいすんなり通りました。gem は311個で、入れ終わった後の /usr/local/bundle は578MBあります。
ひとつ気をつけたいのが Node です。README の Requirements には書かれていないんですが、bin/setup を読むと途中で npm install と npm run tokens:build を呼んでいます(上のログの「Building design tokens」の部分)。自分は先に読んでいたので Node を入れてから走らせました。入れずに走らせたらどうなるかは試していません。
bin/dev は foreman で web(Puma)・Tailwind の監視・Sidekiq の3つを立ち上げます。Puma は Listening on http://127.0.0.1:3000 と 127.0.0.1 でしか待ち受けないので、コンテナの外のブラウザから開くために socat で中継しました。README の user@example.com / Password1! でログインすると、デモの家族のダッシュボードが「Welcome back, Jack」で迎えてくれます。
起動ログで気になったのは Sidekiq 側の警告です。[SECURITY] ActiveRecord Encryption is NOT configured. と出て、API キーや銀行連携のトークン、個人情報が UNENCRYPTED at rest(暗号化されずに保存される)と書かれていました。開発用の手順なので当然といえば当然ですが、本物の明細を入れるなら、警告にあるとおり bin/rails db:encryption:init で鍵を作ってから使うべきですね。
銀行明細っぽい CSV を6通り取り込んでみる
用意したのは、日付・内容・金額の3列だけの CSV です。日付は 2026/11/01 の形、金額は "-8,420" のようにカンマ区切りで、支出をマイナスにしました。取り込み先は円建ての口座です。
取り込みの設定は画面でもできますが、条件をそろえて何度も回したかったので、rails runner から取り込み処理(TransactionImport)を直接呼びました。1ケースにつき1プロセスで、毎回新しい口座に入れています。
# run_case.rb(抜粋)
imp = family.imports.create!(
type: "TransactionImport", account: acct,
raw_file_str: File.binread(path), # 画面からアップロードしたときと同じくバイト列のまま渡す
date_col_label: "日付", amount_col_label: "金額", name_col_label: "内容",
date_format: "%Y/%m/%d", number_format: "1,234", # "1,234" は円など小数なし通貨向けの形式
signage_convention: "inflows_positive", amount_type_strategy: "signed_amount"
)
imp.generate_rows_from_csv
imp.publish if imp.rows.all?(&:valid?)
# ↑ 列名を "日付" と手で書いているのが、あとで自分の足を引っかける。
# 画面のプルダウンのように見出しの実物(imp.csv_headers)から選ぶ形にしておくのが無難
結果はこうなりました。「判定」は、Sure が文字コードの推定に使っている rchardet の答えと確信度です。
| CSV | 判定(確信度) | 有効な行 | 結果 |
|---|---|---|---|
| UTF-8(全角の摘要) | utf-8(0.99) | 8 / 8 | 取り込み完了。金額は ¥498・¥8,420 などと表示 |
| UTF-8 BOM 付き・列名を手書き | UTF-8(1.0) | 0 / 8 | 全行 Date is required。取り込まれない |
| UTF-8 BOM 付き・見出しの実物で対応付け | UTF-8(1.0) | 8 / 8 | 取り込み完了 |
| Shift_JIS(全角の摘要・8行) | SHIFT_JIS(0.963) | 8 / 8 | UTF-8 に正しく変換されて取り込み完了 |
| Shift_JIS(全角の摘要・40行) | SHIFT_JIS(0.99) | 40 / 40 | 同上 |
| Shift_JIS(半角カナの摘要・8行) | SHIFT_JIS(0.333) | 8 / 8 | 取り込み完了。ただし摘要が文字化け |
2行目は自分のミスです。Excel で保存した UTF-8 の CSV には先頭に BOM(目に見えない3バイト)が付くことがあって、見出しが "日付" になります。列名を "日付" と手で書いたせいで日付の列が見つからず、全行が Date is required で止まりました。見出しの実物をそのまま渡せば8行とも通ったので、画面のプルダウンから列を選ぶ普通の使い方なら当たらないはずです(画面からの BOM 付きの取り込みは今回試していません)。ここは好みが分かれるところですが、自動化するなら列は名前ではなく見出しの実物から選ぶほうが安全ですね。
正直なところ、Shift_JIS は全滅するだろうと思っていました。ところが全角の明細はどちらもきちんと変換されて、円の金額も "-8,420" が −8,420 円として入りました。問題は最後の1行、半角カナです。
半角カナの明細だけが化けた理由
半角カナ版は、摘要を セブンイレブン シブヤテン や キユウヨ カ)サンプルシヨウジ のように書いただけで、ほかは同じです。振込名義などが半角カナで並ぶ明細は珍しくないので、ここが通るかどうかは大事なんですよね。
CASE sjis_hw bytes=291 rchardet="SHIFT_JIS" confidence=0.333
STORED_LINE1 "“ú•t,“E—v,‹ŕŠz"
STORED_LINE2 "2026/11/01,ľĚŢݲÚĚŢÝ ĽĚŢÔĂÝ,\"-498\""
ROWS count=8 valid=8
PUBLISHED status=complete entries=8 sum=-146602.0
entry 2026-11-01 "ľĚŢݲÚĚŢÝ ĽĚŢÔĂÝ" amount=498.0 money=¥498
rchardet は「SHIFT_JIS」と正しく当てているのに、確信度が0.333しかありません。そして見出しも摘要も化けたまま、8行とも有効扱いで取り込みが complete まで進んでいます。日付と金額は ASCII なので正しく読めてしまい、どこにもエラーが出ないんです。
どこで分かれたのかは app/models/import.rb を読むとすぐ分かりました。
# Common encodings to try when UTF-8 detection fails
# Windows-1250 is prioritized for Central/Eastern European languages
COMMON_ENCODINGS = [ "Windows-1250", "Windows-1252", "ISO-8859-1", "ISO-8859-2" ].freeze
# (ensure_utf8_encoding の中)
if detected_encoding && confidence > 0.75
self.raw_file_str = raw_file_str.force_encoding(detected_encoding).encode("UTF-8", invalid: :replace, undef: :replace)
else
try_common_encodings # 上の4つを順に試し、最初に「正しいバイト列」とみなせたもので変換する
end
確信度が0.75を超えないと、せっかく当たった SHIFT_JIS の答えは捨てられて、欧州向けの4つを順に試す流れに入ります。半角カナは Shift_JIS では1バイトの文字なので、先頭の Windows-1250 で読んでも「正しいバイト列」に見えてしまう。本当に Windows-1250 で読まれたのかは、同じ1行を4通りに読み直して確かめました。
Windows-1250 valid=true -> 2026/11/01,ľĚŢݲÚĚŢÝ ĽĚŢÔĂÝ,"-498"
Windows-1252 valid=true -> 2026/11/01,¾ÌÞݲÚÌÞÝ ¼ÌÞÔÃÝ,"-498"
ISO-8859-1 valid=true -> 2026/11/01,¾ÌÞݲÚÌÞÝ ¼ÌÞÔÃÝ,"-498"
CP932 valid=true -> 2026/11/01,セブンイレブン シブヤテン,"-498"
Sure に保存された行は、1行目の Windows-1250 の読み方と完全に一致しました。ľ や Ě は Windows-1252 では出てこない文字なので、取り違えようがありません。
画面で見ると、違いは一目瞭然です。

左が全角の Shift_JIS、右が半角カナの Shift_JIS を取り込んだ口座です(見出しの帯は自分で足しました)。金額の −¥15,000 や緑の ¥285,000、日付は左右で同じなのに、右は AMAZON.CO.JP 以外の摘要がすべて化けています。合計も日付も合っているので、件数と金額だけ見て確認していたら、たぶん気づかないまま使い続けていたと思います。
試してみての所感
Docker を使わない手順でも、bin/setup 81秒・デモデータ76秒で、8,620件入りのデモの家族まで立ちました。円の口座に "1,234" 形式・YYYY/MM/DD の明細を入れる分には、UTF-8 でも全角の Shift_JIS でも素直に入ります。日本の明細を入れる下地は、思っていたよりずっとできていました。
自分が使うなら、銀行からダウンロードした CSV は取り込む前に必ず UTF-8 にします(iconv -f CP932 -t UTF-8 など)。コードを読む限り、正しい UTF-8 なら文字コードの推定そのものに回らないので、半角カナでも化けないはずです。ただ、半角カナを UTF-8 にした版は今回試していないので、そこはまだ「はず」の段階です。
様子見なのは為替まわりです。デモの家族はドル建てで、そこに円の口座を足したので、画面には「Missing historical data」の案内が出ていました。rails runner で確かめると為替レートは0件で、円からドルへの換算は Couldn't find exchange rate from JPY to USD on 2026-11-11 で失敗します。家族ごと円建てにして使うのか、為替の取得元を設定するのかは、本気で使う前にもう一度試すつもりです。暗号化の鍵の設定もそのときに。
文字コードの推定が外れたときに、黙って欧州向けに読むのではなく「この CSV は何の文字コードですか」と聞いてくれる形だと、日本の利用者としてはうれしいんですけどね。もっと良い方法があったら教えてください。