【ITニュース解説】HisaabMate
2026年10月19日に「Dev.to」が公開したITニュース「HisaabMate」について初心者にもわかりやすく解説しています。
ITニュース概要
HisaabMateは、ローカルで動作するAI(Ollama+Gemma)を活用し、作業記録からクライアントや作業時間を自動抽出・整理するツールだ。データが外部に送られないためプライバシーが保たれ、オフラインでも使える。フリーランスが請求書作成や時間管理を効率化し、計上漏れを防ぐのに役立つ。
ITニュース解説
HisaabMateは、フリーランスのシステムエンジニアや開発者が日々の作業記録を効率的に管理し、請求書作成を支援するツールだ。特に、英語とヒンディー語が混じった「Hinglish」で書かれたメモから、請求可能な作業時間やクライアント名を自動で抽出し、構造化されたデータに変換する点に特徴がある。多くのフリーランスが抱える、手書きやチャットアプリに散らばったメモを手作業で表計算ソフトに入力する手間や、請求漏れの課題を解決することを目指している。
このシステムの基本的な仕組みは、ユーザーが入力した作業メモ(手書きのメモを撮った写真からテキストに変換したもの、テキストファイル、テキスト形式のPDFなど)をStreamlitというPython製のウェブアプリケーションフレームワークで作られたUIに取り込むことから始まる。取り込まれたデータは、まず「サニタイズ」という処理で不要な情報が除去され、安全な形に整えられる。次に、このデータを「抽出エンジン」が解析し、日付、作業時間、クライアント名、作業カテゴリ、そして請求可能かどうかといった項目を識別する。
抽出エンジンの中心には、二つの異なる技術が組み合わされている。一つは、Googleが開発した軽量な大規模言語モデル(LLM)であるGemma 3の「gemma3:1b」というモデルを、Ollamaというフレームワークを通じてローカル環境で動かす方法だ。Ollamaは、ローカルにインストールされたAIモデルとアプリケーションの間の通信を管理し、Gemmaモデルが特定の形式(JSONスキーマと呼ばれる、データの構造を定義するルール)で出力を生成するように制御する。これにより、「1 ghanta」(1時間)や「dedh ghanta」(1.5時間)といったHinglishの表現を正確な分数に変換したり、「billable nahi」(請求不可)といったフラグを自動で設定したりできる。もう一つは、Ollamaがオフラインであったり、より高速な処理が必要な場合に備えた「確定的なHinglish正規表現パーサー」だ。これは、正規表現という特定の文字パターンを検索するルールを使って、ISO形式の日付やHinglishの期間、クライアント名などをアプリ内で直接抽出する。これにより、インターネット接続がなくてもアプリが常に機能し続ける「オフラインフォールバック」が実現されている。抽出されたデータは、Pythonコードによって日付やクライアント名、作業時間などが適切であるか検証される。
ユーザーは、Neobrutalist Data Editorという独特なデザインのデータ編集画面で、抽出されたデータを直接確認し、必要に応じて手動で修正したり、行を追加したり削除したりできる。このUIは、Space Groteskなどの特定のフォントや、2pxの太い境界線、影付きのデザインで視覚的に整理され、@st.cache_dataという機能を使うことで、データの再描画が高速に行われるように工夫されている。最終的に、データは「North-Star Audit Tracker」で監査準備状況が示され、クライアント別やカテゴリ別のグラフで作業時間の内訳を可視化できる。そして、数式インジェクション対策が施された安全なCSVファイルとしてエクスポートしたり、クライアントに送るための請求書メモを自動生成したりする機能も備わっている。
技術スタックには、前述のGemma 3 (gemma3:1b)とOllamaの他に、PDFファイルの読み込みにはpypdfが、メモリ内でファイルを扱うためにBytesIOが使われている。特に、ユーザーがアップロードするテキストファイルやPDFは、セキュリティとプライバシー保護のため、全てPCのメモリ上で処理され、ファイルシステムには一切保存されない。これにより、外部へのデータ流出のリスクをなくし、NDA(秘密保持契約)の順守を徹底している。また、5MBのファイルサイズ制限や30ページのPDF制限、画像のみのPDF検出といった「ガードレール」を設けることで、不正なファイルや処理負荷の高いファイルのアップロードを防いでいる。HisaabMateの品質と信頼性を確保するため、21個ものユニットテストとヘッドレスUIテストが開発されており、スキーマ検証やデータフレームのNaN(欠損値)処理、数式インジェクション対策、PDFガードレール、UIワークフロー全体がオフラインで自動的に検証されている。
このHisaabMateの設計思想の根底には、「オープンイノベーション」という考え方がある。一つ目の大きな利点は、100%のクライアントプライバシーとNDAコンプライアンスだ。クラウド上のAIサービスを利用すると、作業メモの内容(未公開機能やセキュリティ修正の詳細、実際のクライアント名など)が外部に送信され、プライバシー侵害やNDA違反のリスクがある。しかしHisaabMateは、GemmaモデルがユーザーのPC上でローカルに動作し、ファイルもメモリ内で処理されるため、いかなる機密情報も外部に漏れることなく安全に管理できる。二つ目は、ゼロパーリクエストAPIコストである。クラウドAPIを利用するサービスは、リクエストごとに費用が発生し、それが月額課金モデルの要因となる。HisaabMateはローカルモデルを利用するため、追加の利用料が一切かからず、無料で提供したり、買い切り型のツールとして提供したりすることが可能になる。これは、フリーランスにとって大きな経済的メリットとなる。三つ目は、ベンダーロックインからの解放とバイリンガル制御だ。クラウドAPIはモデルの廃止、料金体系の変更、Hinglishのような混合言語への不十分な対応といった問題があるが、オープンなモデルと制御ルールを使うことで、ユーザーは必要に応じて他のローカルモデル(例:gemma3:4b、qwen2.5など)に自由に切り替えたり、完全にオフラインで作業したりできる柔軟性を持つ。
開発においては、Gemmaモデルによる自然言語からの情報抽出(src/ollama_client.py)と、Pythonによる確定的な財務データ検証(src/worklog.py)という役割の厳密な分離に重点が置かれた。また、Streamlitのデータエディタで新しい行を追加した際に、NaNや浮動小数点数が混入するバグ(例:90分が90.0となる)を、データサニタイズ関数と整数への変換で解決するといった、細かな実装の工夫も行われた。そして、オフラインHinglishフォールバックパーサーと21項目に及ぶテストスイートの構築も、開発エージェントとの協力によって実現した。
HisaabMateを最初に使ったユーザーの一人である、別のフリーランスの学生は、このツールによって請求可能な作業時間が2時間以上増えたと報告している。彼はこれまでWhatsAppのメッセージで作業を追跡し、月末に手動でスプレッドシートに転記していたが、HisaabMateを使うことで、Hinglishのメモを貼り付けるだけで、請求可能なクライアントタスクと管理作業を自動で区別できるようになった。特に「Audit Readiness bar」(監査準備度バー)と、ワンクリックで作成できるMarkdown形式の「Invoice Memo」(請求書メモ)を高く評価している。彼は、他の月額課金サービスには興味がないが、クライアントプライバシーを保護し、失われた請求可能時間を回復できるローカルデスクトップツールであれば、少額の一括払いを喜んで行うだろうと述べた。
このHisaabMateは、ローカルで動作するGoogleのgemma3:1bモデルを主要な抽出エンジンとして活用し、JSONスキーマと組み合わせることで、Hinglishと英語の混在する作業メモから構造化されたタイムシートの草稿を生成する点が高く評価され、「Best Use of Gemma」賞を受賞した。これは、クラウドに依存せず、ユーザーのプライバシーとコスト効率を重視したAIアプリケーション開発の成功例を示している。