「Fava」タグの記事が7件件あります

Beancount で元帳がプレーンテキストで管理されているなら、月末締めは高速で監査可能です。プロセスはスプレッドシートや電卓に追われる慌ただしい作業である必要はありません。このガイドは、Beancount とそのウェブインターフェースである Fava 向けに、バランスアサーション、スマートインポート、軽量チェックを中心とした、シンプルで再現可能なプロセスをまとめています。

手間のかからない締めのチェックリストは以下の通りです：

1. 取引明細を集め、すべての生データ取引をインポートする。
2. 支払先、説明、メタデータを正規化する。
3. 現金、銀行、クレジット口座すべてを balance アサーションで照合する。
4. 振替および口座間移動を照合する。
5. 投資の価格を更新し、評価額を検証する。
6. 元帳に文書（領収書、請求書）を添付または参照する。
7. 損益および差異チェックのためにクエリとダッシュボードを実行する。
8. 必要に応じて発生主義の仕訳や調整を記録する。
9. 自動チェックで元帳を検証する。
10. 月次をコミット、タグ付け、アーカイブする。

1. 基本ルールを設定し（再利用する）​

一貫した締めは安定した基盤から始まります。勘定科目表と重要な Beancount オプションは中央で宣言し、ほとんど変更しないようにします。operating_currency や documents のようなオプションは、レポートやインポートが毎回予測可能に動作することを保証します。

Tip: オプションファイルを「インフラ」として扱いましょう。変更すると数値の計算方法が変わる可能性があります。Git で慎重にバージョン管理してください。

2. すべてをインポートし、以後手入力は不要​

データインポートの自動化は、帳簿締めの速度を最大限に向上させます。Beancount の強力なインポートツールとコミュニティが作成したインポーターを使用して、銀行フィード、クレジットカードの CSV/OFX ファイル、証券データ、給与レポートを取り込みましょう。

目標は、バランスの取れた仕訳を生成するワンコマンドインポートで、レビューとコミットだけが必要です。これにより、エラーや遅延の主な原因である手動データ入力が不要になります。

3. 支払先とメタデータを事前に正規化​

クリーンなデータは信頼できるデータです。インポート時に支払先、ナレーション、タグを標準化し、検索、ルール、レポートが月々正確に保たれるようにします。

Beancount のプラグインシステムにより、ファイル読み込み時に軽量な変換や検証を追加できます。これはカスタムの一貫性チェックを強制したり、組み込みの noduplicates プラグインで重複取引を問題になる前にフラグ付けするのに最適です。

4. balance アサーションで照合​

ステートメントがあるすべての口座（当座預金、普通預金、クレジットカード）について、Beancount の balance ディレクティブを使って期末残高をアサートします。このシンプルな行が、手動の目視チェックを正確な自動テストに変えます。

2025-01-01 balance Assets:Cash 1000 USD

残高はその日の 開始時 にチェックされるため、月末ステートメントには 次月の 1 日目を使用するのが最も簡単です。Beancount の計算残高がアサーションと合わない場合、正確なエラーと調査開始日が表示されます。常に真実のソース（取引）を最初に修正し、無理に照合を「強制」しないでください。

5. 口座間振替を照合​

すべての振替が取引の両側に記録されていることを確認します。例えば、当座預金からクレジットカードへの支払いは、両方の口座に反映されるべきです。振替の不一致は照合の頭痛の種となります。

pad ディレクティブは、口座を初期設定する際の過去の開始残高を設定するために のみ 使用します。これは設定ツールであり、月末の差異を修正するための照合用の棒ではありません。

6. 投資のポジションと価格を検証​

正確な純資産を把握するには、投資や外貨の最新の市場価値が必要です。Beancount の price ディレクティブを使って、締め日の時点の価値を記録しましょう。

2025-01-01 price AAPL 150 USD

多くのツールが自動でこれらの価格を取得できます。更新後にバランスシートや純資産レポートを再実行すれば、評価額の変化が確認できます。

7. 領収書と原本書類を添付​

取引を原本書類にリンクさせ、クリーンな監査証跡を保ちましょう。メインの Beancount ファイルで documents オプションを使用して、領収書や請求書のアーカイブを指し示します。

option "documents" "/path/to/documents"

ファイル名を日付で付ける（例：2025-08-13.vendor.receipt.pdf）と、Beancount と Fava が自動的に検出・リンクし、取引ごとにワンクリックで領収書を表示できます。

8. Fava と BQL で月次をレビュー​

高速なフィードバックループは重要です。Fava を使って財務を視覚的に確認しましょう。チャートやレポートは、カテゴリ別の支出分析、収入トレンドのチェック、異常の瞬時把握に最適です。

より正確なチェックには Beancount Query Language (BQL) を使用します。例えば、以下のクエリは 2025 年 8 月の全支出を順位付けして集計します。

SELECT account, SUM(position) AS amount
FROM balances
WHERE account ~ 'Expenses:'
  AND date >= '2025-08-01' AND date < '2025-09-01'
GROUP BY account
ORDER BY amount DESC;

9. 発生主義の仕訳と調整を記録​

発生主義会計を使用している場合、月末の調整を明示的な日付付き取引として記録します。未受領の光熱費などの未払費用、前払費用の償却、収益認識などが該当します。簡潔かつナレーションで十分に文書化し、将来のレビュー時に理解しやすくしましょう。

10. 検証、タグ付け、アーカイブ​

月次を確定する前に、構造的整合性の最終チェックを実行します：

beancount -f -x -X -p -t -v -c -e -l -i -m -r -s -w -y -z -A -B -C -D -E -F -G -H -I -J -K -L -M -N -O -P -Q -R -S -T -U -V -W -X -Y -Z

このコマンドは、残高不一致や未開設口座への参照、その他一般的なエラーを検出します。指摘された問題はすべて修正してください。

すべてが正しいことを確認したら、Git などのバージョン管理システムに明確なメッセージとタグ（例：close-2025-08）でコミットします。最後に銀行明細をアーカイブし、月次をロックしたとみなします。

カスタマイズ可能なシンプルな締めスクリプト​

これらのステップのほとんどはシンプルなシェルスクリプトで自動化できます。締め作業を単一の再現可能なコマンドに変換しましょう。

#!/bin/bash
# Example Beancount close script
beancount -f myfile.beancount import statements.csv
beancount -f myfile.beancount balance Assets:Cash
beancount -f myfile.beancount price AAPL 150 USD
beancount -f myfile.beancount query "SELECT ..."
git add myfile.beancount
git commit -m "Month close for August 2025"
git tag close-2025-08

なぜこの方法が機能するのか​

このプロセスが高速かつ信頼できるのは、いくつかの基本原則に基づいているからです：

• アサーションで、目視ではなく: balance ディレクティブは照合を正確な自動チェックに変えます。
• 決定的な入力: 自動インポーターと正規化されたメタデータにより、元帳は再現可能で一貫性が保たれます。
• 探索可能なデータ: Fava と BQL は結果を検証し、外れ値を即座に掘り下げる強力なツールを提供します。
• 監査可能な変更: 調整はプレーンテキストのジャーナルエントリであり、数か月・数年後でも簡単にレビュー・理解できます。

良い月末締めは主に物流です。Beancount を使えば、インポート、アサート、価格設定、クエリ、コミットという短くスクリプト化可能な儀式に変えられます。ワークフローを安定させておけば、財務が複雑化しても締めは高速なままです。

Beancount.io エコシステムに大幅な強化をもたらす公式統合 beancount-dashboard を発表できることを嬉しく思います。この強力な新機能により、Fava にリッチでインタラクティブな可視化が直接組み込まれ、財務ストーリーを明快で魅力的、かつ実行可能な形で把握できるようになります。

beancount-dashboard とは？​

beancount-dashboard は、Beancount のウェブインターフェースである Fava 用のオープンソースプラグインです。プレーンテキストの財務データを動的かつ洞察に満ちたダッシュボードに変換し、財務ヘルスの把握や意思決定をこれまで以上に容易にします。

プラグインが提供する主な可視化例：

• 📊 包括的な資産ビュー: 純資産ラインチャートで資産推移を追跡し、詳細な ポートフォリオ追跡でパフォーマンスを監視、資産配分の円グラフで分布を可視化。
• 💰 収入・支出分析: 正確な 月次平均でキャッシュフローを把握し、カテゴリ別に支出を分解、前年比分析で習慣の変化を確認。
• ✈️ 旅行費管理: 年間の旅行費用を追跡し、目的地別の支出パターンを分析して次回旅行の予算策定に活用。
• 🔄 サンキー図: 収入源、口座、支出カテゴリ間の資金の流れをインタラクティブに可視化。
• 📈 財務予測: 過去データを活用して目標設定と将来の財務軌道をプロジェクション。

beancount-dashboard を統合した理由​

この統合は Beancount コミュニティにとって画期的で、以下の 4 つの重要なメリットを提供します。

1. ユーザー体験の向上​

Beancount は堅牢な複式簿記を基盤としていますが、生データは圧倒的です。beancount-dashboard プラグインは複雑な元帳を直感的な可視化に変換し、財務管理を誰でもアクセスしやすく、魅力的にします。

2. より良い財務意思決定​

ビジュアルダッシュボードは、トレンドの特定、予算の最適化、目標の追跡、先を見据えた計画を容易にし、データを消化しやすい形で提示します。

3. プロフェッショナルレベルの分析​

Apache ECharts によるエンタープライズクラスの分析力が指先に。インタラクティブチャート、カスタムビュー、リアルタイム更新により最新取引を即座に反映。レスポンシブデザインであらゆるデバイスでシームレスに利用可能です。

4. オープンソースの卓越性​

Beancount と beancount-dashboard は共にオープンソースの理念にコミット。データ処理の 透明性、プライバシー（データは自分のインフラに留まる）を保証し、活発で革新的な コミュニティ の支援を受けられます。

実際のメリット​

さまざまなユーザーに即時かつ具体的な効果をもたらします。

個人財務向け​

• 予算管理: 毎月の支出先を正確に把握。
• 貯蓄目標: 緊急資金、旅行、リタイアメントなどへの進捗を可視化。
• 投資モニタリング: ポートフォリオのパフォーマンスと資産配分を綿密に監視。

中小企業向け​

• キャッシュフロー管理: 事業の流動性を監視し、キャッシュフローパターンを把握。
• 費用分析: 部門、プロジェクト、ベンダー別に事業コストを分析。
• 財務計画: 歴史データを活用して予算策定と予測の精度を向上。

ファイナンシャルアドバイザー向け​

• クライアント向けプレゼン: プロフェッショナルで分かりやすい財務レポートを作成。
• ポートフォリオ分析: 包括的な資産配分とパフォーマンス追跡を実施。
• コンプライアンス: 監査・報告に必要な詳細かつアクセスしやすい記録を保持。

財務生活を変革する準備はできましたか？​

beancount-dashboard の力で、財務管理に必要なすべてのツールが手に入ります。

1. beancount.io にアクセス
2. 無料アカウントを作成 して Beancount エコシステム全体にアクセス。
3. すでに何千人ものユーザー が自信を持って財務を管理しています。

フィードバックを募集しています​

プラットフォームの改善に向け、皆様の洞察は非常に重要です。ダッシュボード成功事例、機能要望、バグ報告 をぜひ共有してください。コミュニティフォーラム、GitHub Issues、SNS で Beancount.io チームとつながれます。

活気あるコミュニティへ参加​

他の Beancount ユーザーとダッシュボード設定を共有し、専門家から学び、知識を貢献しましょう。新機能の情報をいち早く受け取り、財務管理の未来を共に形作ってください。

この統合は大きな前進です。Beancount の堅牢な会計エンジンと beancount-dashboard の強力な可視化を組み合わせ、オープンソースかつプライバシー重視のエンタープライズグレード分析を提供します。

財務トラッキングを革命的に変えたいですか？ 今すぐ beancount.io に登録し、beancount-dashboard の力を体感し、共に財務管理の未来を築きましょう！

Beancountのコア機能と哲学​

Beancountは、プレーンテキストファイルを使用して取引を記録する、オープンソースの複式簿記会計システムです。その核心において、Beancountはあなたの台帳を、シンプルで厳格な文法によって定義された_データセット_として扱います。すべての財務イベント（取引、勘定開設、商品価格など）はテキストファイル内のディレクティブ（指示）であり、Beancountはこれを解析してエントリーのインメモリデータベースに変換します。この設計により、複式簿記の原則が強制されます。つまり、すべての取引は勘定間で借方と貸方のバランスが取れていなければなりません。その結果、バージョン管理、検査、クエリが容易な、非常に透明性が高く監査可能な台帳が生まれます。

哲学 – 正確性とミニマリズム: Beancountの設計は、データの整合性とシンプルさを優先しています。その作成者であるMartin Blaisは、Beancountがユーザーが間違いを犯すことを前提とした「悲観的」なものであると述べており、そのため追加のチェックと制約を課しています。たとえば、Beancountは一度も追加されていない資産の削除を許可せず（負の株式保有や現金残高を防ぐ）、使用前にすべての勘定が開設されていることを強制できます。Ledgerの「仮想」または自動的にバランスが取られる転記の概念は欠けています。これは、完全にバランスの取れたエントリーを強制するための意図的な選択です。Beancountは、基本的な複式簿記が提供する以上のクロスチェックを行い、事実上**「正確性に徹底的にこだわる」**姿勢をとっています。この慎重なアプローチは、「自分自身をあまり信用していない」ユーザーや、ソフトウェアにエラーを検出してほしいと考えるユーザーにアピールします。

最小限のオプション、最大限の一貫性: Ledgerの無数のコマンドラインフラグやチューニングオプションとは対照的に、Beancountはミニマリズムを選択しています。グローバルオプションは非常に少なく、台帳ファイル外で取引のセマンティクスを変更するものはありません。会計に影響を与えるすべての設定（商品の取得原価計算方法や記帳の前提など）は、ファイル内のディレクティブまたはプラグインを介して行われ、レポートの生成方法に関わらず、同じファイルを読み込むと常に同じ結果が生成されることを保証します。この設計は、Ledgerの多くの調整項目とそれらの間の微妙な相互作用の複雑さを回避します。Beancountの哲学は、会計ツールは入力ファイルからレポートまでの一貫した安定した決定論的なパイプラインであるべきだというものです。これは、台帳をプログラムで順次処理できるディレクティブの順序付きストリームとして扱うことで実現されます。Ledgerが特別な構文として扱うもの（期首残高や価格ステートメントなど）でさえ、Beancountのデータモデルでは第一級のディレクティブであり、これがシステムを非常に拡張性の高いものにしています。

プラグインとクエリ言語による拡張性: BeancountはPythonで実装されており、処理パイプラインにカスタムロジックを注入するためのフックを提供します。ユーザーは、取引のストリーム上で動作するPythonのプラグインを作成できます（たとえば、カスタムルールを強制したり、自動エントリーを生成したりするため）。これらのプラグインはファイルが処理される際に実行され、ソースを変更することなくBeancountのコア機能を効果的に拡張します。Beancountには、台帳を分析するための強力なクエリ言語（SQLに触発されたもの）も含まれています。bean-queryツールは、解析された台帳をデータベースとして扱い、分析クエリを実行できます。たとえば、カテゴリ別に費用を合計したり、特定の受取人のすべての取引を抽出したりできます。Beancount 3.xでは、このクエリ機能はスタンドアロンのbeanqueryパッケージに移動しましたが、ユーザーの観点からは、依然としてSQLライクなクエリを介して柔軟なレポート作成が可能です。

プレーンテキストとバージョン管理: プレーンテキスト会計ツールとして、Beancountは_ユーザーコントロール_とデータの永続性を重視しています。台帳は単なる.beancountテキストファイルであり、どのテキストエディタでも編集できます。これは、あなたの全財務履歴が人間が読める形式で保存され、Gitや他のVCSに入れて変更を時系列で追跡できることを意味します。ユーザーはしばしば、すべての編集の監査証跡を維持するために（変更を説明するコミットメッセージと共に）Beancountファイルをバージョン管理下に置きます。このアプローチは、会計データ、特に個人や小規模ビジネスの財務は、透明で「将来も利用可能」であるべきだというBeancountの哲学と一致しています。つまり、独自のデータベースにロックされるべきではないということです。Martin Blais自身の言葉を借りれば、Beancountはコミュニティのためにシンプルで、永続的で、無料であるように作られた「愛情のこもった労働」です。それは2007年頃に最初に開発され、主要な書き直し（v1からv2、そして2024年のv3）を経て、ミニマリズムと正確性というコア哲学を維持しながら設計を洗練させてきました。

Beancountエコシステムのツール、プラグイン、拡張機能​

Beancountエコシステムは、コアの台帳機能を強化する豊富なツール、プラグイン、拡張機能のセットを成長させてきました。これらは、データのインポート、台帳の編集、レポートの表示、特殊な会計機能の追加をカバーしています。以下に、Beancountの世界における主要なコンポーネントとアドオンの概要を示します：

データインポートユーティリティ（インポーター）​

実用的な使用において最も重要なニーズの一つは、銀行、クレジットカード、その他の金融機関から取引をインポートすることです。Beancountはこの目的のためにインポートフレームワークとコミュニティ提供のインポートスクリプトを提供しています。Beancount 2.xでは、組み込みモジュールbeancount.ingest（bean-extractやbean-identifyなどのコマンドを含む）がPythonでインポータープラグインを定義し、ダウンロードした明細書に適用するために使用されていました。Beancount 3.xでは、これはBeangulpという外部プロジェクトに置き換えられました。Beangulpはbeancount.ingestから進化した専用のインポーターフレームワークであり、現在Beancount 3.0の取引インポートを自動化するための推奨方法となっています。これにより、外部ファイル（CSVやPDF明細書など）を読み取り、Beancountのエントリーを出力するPythonスクリプトやコマンドラインツールを作成できます。この新しいアプローチは、インポートロジックをBeancountのコアから切り離します。たとえば、古いbean-extractコマンドはv3で削除され、代わりにインポートスクリプト自体がBeangulpのCLIインターフェースを介して取引を生成します。

コミュニティによって提供された、さまざまな銀行やフォーマットに対応する既製のインポーターが数十も存在します。中国のAlipayやWeChat Payから、ヨーロッパの各種銀行（Commerzbank, ING, ABN AMROなど）、ChaseやAmexのような米国の銀行まで、世界中の金融機関向けのインポータースクリプトがあります。これらの多くは公開リポジトリ（多くはGitHub上）やbeancount-importersのようなパッケージに集められています。例えば、Tarioch Beancount Toolsプロジェクト（tariochbctools）は、スイスや英国の銀行向けのインポーターを提供し、暗号資産取引のインポートも処理します。別の例としてLazy Beancountは、一般的なインポーター（Wise, Monzo, Revolut, IBKRなど）のセットをパッケージ化し、簡単な自動化のためのDockerベースのセットアップを提供します。どの銀行や金融サービスを利用していても、誰かがそのためのBeancountインポーターを書いている可能性があります。そうでなくても、Beangulpのフレームワークを使えば自分で書くことができます。Pythonの柔軟性により、インポーターはCSV/Excelファイルの解析、OFX/QIFダウンロードの処理、さらにはAPIのスクレイピングを行い、標準化されたBeancount形式で取引を出力できます。

編集とエディタ統合​

Beancountの台帳は単なるテキストであるため、ユーザーは好みのテキストエディタやIDEを活用して管理することがよくあります。エコシステムは、この体験をよりスムーズにするためのエディタサポートプラグインを提供しています。多くの人気エディタには、シンタックスハイライト、勘定科目名の自動補完、リアルタイムのエラーチェックを追加する拡張機能があります：

• Emacs Beancount-Mode: Emacsのメジャーモード（beancount-mode）が利用可能で、.beancountファイルの編集をサポートし、シンタックスカラーリングやBeancountのチェッカーとの統合などの機能を提供します。バックグラウンドでbean-checkを実行することもでき、編集中に台帳のエラー（バランスの取れていない取引など）がフラグ付けされます。
• VS Code拡張機能: VSCode MarketplaceにあるBeancount拡張機能は、Visual Studio Codeユーザーに同様の利便性を提供します。シンタックスハイライト、金額の桁揃え、勘定科目/受取人の自動補完、さらにはファイル保存時のオンザフライでの残高チェックをサポートしています。Favaとの統合も可能で、VSCode内からFavaのWebインターフェースを起動できます。
• Vim、Atom、その他のエディタ用にもプラグインやモードが存在します。例えば、Beancount用のTree-sitter文法があり、これは現代のエディタでシンタックスハイライトを強化し、FavaのWebベースのエディタコンポーネントでも採用されました。要するに、あなたの編集環境が何であれ、コミュニティはBeancountファイルの編集を便利でエラーのないものにするためのプラグインを提供している可能性が高いです。

従来のエディタ以外での迅速な取引入力のために、Bean-addやモバイルアプリのようなツールもあります。_Bean-add_は、プロンプトやワンライナーで新しい取引を追加できるコマンドラインツールで、日付や勘定の提案を処理します。モバイルでは、Beancount Mobileというプロジェクトが、外出先で取引を入力するためのシンプルなインターフェースを提供します（例えば、携帯電話から現金の購入を記録するなど）。さらに、メッセージングを通じて取引を記録するためのBeancount Telegram Botも存在します。取引詳細を含むメッセージを送信すると、ボットがそれを台帳ファイルにフォーマットします。

Webフロントエンドと可視化ツール​

(Fava) Favaのウェブインターフェースは、Beancount用のインタラクティブなダッシュボードを提供し、勘定科目と残高のテーブルと共に、可視化（ここではカテゴリ別の費用のツリーマップとして表示）を伴う損益計算書などのレポートを特徴としています。

Beancountの代表的なフロントエンドは、モダンなWebインターフェースであるFavaです。Favaは、あなたのBeancountファイルを読み取り、ブラウザでリッチなインタラクティブ体験を生成するローカルWebアプリとして動作します。貸借対照表、損益計算書、時系列の純資産、ポートフォリオ保有状況、パフォーマンスチャート、予算など、豊富なレポート一式を標準で提供します。ユーザーはしばしば、他のプレーンテキスト会計ツールよりもBeancountを選ぶ大きな理由としてFavaを挙げます。たった一つのコマンド（fava ledger.beancount）で、テキストの代わりにグラフやテーブルで財務状況を閲覧できます。Favaは次のような機能をサポートしています：勘定のドリルダウン、受取人やタグによる取引のフィルタリング、クエリエディタ（Beancountクエリを実行し、ブラウザで結果を確認できる）、さらには台帳用の統合されたWebベースのエディタまで。非常に使いやすく、視覚的なインターフェースを好む人々にとってプレーンテキスト会計を身近なものにしています。

内部的には、FavaはPython（バックエンドはFlask）とJavaScript（フロントエンドはSvelte）で書かれています。独自のリリースサイクルを持ち、活発にメンテナンスされています。特筆すべきは、FavaがBeancountの開発に追随している点です。たとえば、Fava 1.30ではBeancount v3のサポートが追加され、内部で新しいbeanqueryおよびbeangulpパッケージを使用するように切り替わりました。（古い台帳のためにBeancount 2も引き続きサポートしています。）Favaの使いやすさへの注力には、Webエディタでの自動補完や、ダークモードとレスポンシブなチャートを備えた洗練されたUIなどが含まれます。また、Fava-GTKという派生プロジェクトもあり、これはネイティブアプリの感触を好むGNOME/LinuxユーザーのためにFavaをデスクトップアプリケーションとしてパッケージ化したものです。

Fava以外にも、他の可視化・分析オプションが存在します。Beancountのデータはテーブルとしてエクスポートまたはクエリできるため、ユーザーはJupyterノートブックやPandasのようなツールをカスタム分析に活用することがよくあります。例えば、あるユーザーは、カスタムレポートを準備するためにクエリインターフェース経由でBeancountからPandasのDataFrameにデータを引き出す方法を説明しています。特定のレポート用のコミュニティ提供スクリプトもあります。例えば、ポートフォリオ配分分析ツールや、支出対純資産の工程管理図などです。しかし、ほとんどの人にとって、Favaはコードを書かなくても十分すぎるほどのレポート機能を提供します。さらには拡張機能もサポートしており、新しいレポートページやチャートをFavaに追加するPythonファイルをドロップインできます。注目すべき拡張機能は、Fava内でエンベロープ予算管理を行うためのfava-envelopeです。全体として、FavaはBeancountエコシステムの中心的な可視化ハブとして機能しています。

コマンドラインユーティリティとスクリプト​

Beancountには様々なCLIツールが付属しています（特に古いv2ブランチに多く、一部はv3で整理されました）。これらのツールは、台帳ファイルを操作してチェックしたり、テキストやHTMLで特定のレポートを生成したりします：

• bean-check: ファイルの構文エラーや会計エラーをチェックするバリデータ。bean-check myfile.beancountを実行すると、不均衡、勘定の欠落、その他の問題が警告され、ファイルがエラーフリーであれば何も出力されません。
• bean-format: ソースコードにコードフォーマッタをかけるように、数値をきれいな列に揃えて台帳を整えるフォーマッタ。これにより、ファイルがクリーンで読みやすくなります。
• bean-query: 台帳に対してBeancountのクエリ言語を実行するための対話型シェルまたはバッチツール。カスタムの表形式レポートを作成するために使用できます（例：bean-query myfile.beancount "SELECT account, sum(amount) WHERE ..."）。
• bean-report: （v2の）多機能レポートジェネレータで、定義済みのレポート（貸借対照表、損益計算書、試算表など）をコンソールやファイルに出力できます。例えば、bean-report file.beancount balancesは勘定残高を出力します。（実際には、これらのテキストレポートの多くはFavaのより優れた表示に取って代わられています。）
• bean-web / bean-bake: localhostでレポートを提供したり、静的なHTMLファイルとして「ベイク」したりする古いWebインターフェース。これらはFavaが人気になる前に主に使用されていました。bean-webは、bean-reportが生成できるのと同じレポートの基本的なWebビューを提供していました。Beancount 3では、bean-webは削除されました（Favaが推奨されるWebフロントエンドとなり、優れた体験を提供するため）。
• bean-example: サンプルの台帳ファイルを生成するユーティリティ（新規ユーザーがBeancountエントリーのテンプレートを見るのに便利）。
• bean-doctor: 台帳や環境の問題を診断できるデバッグツール。

Beancount v3の時点で、これらのツールの多くがコアプロジェクトから移動されたことは注目に値します。コアのBeancountパッケージは効率化され、クエリエンジンやインポーターのようなツールはメンテナンスを容易にするために別々のパッケージ（beanquery, beangulpなど）に分割されました。例えば、bean-queryの機能は現在、別途インストールされるbeanqueryツールによって提供されます。ユーザーの観点からは、機能は引き続き利用可能ですが、モジュール化されただけです。Arch LinuxコミュニティはFavaを更新する際にこの変更に注目しました：FavaパッケージはBeancount 3.xをサポートするためにbeanqueryとbeangulpへの依存関係を追加しました。このモジュール化アプローチにより、コミュニティの他の人々がBeancountのリリースサイクルとは独立してこれらの補助ツールに貢献することも可能になります。

Beancountプラグインと拡張機能​

Beancountエコシステムの際立った強みはプラグインシステムです。Beancountファイルにplugin "module.name"という行を追加することで、台帳処理中に実行されるカスタムPythonロジックを組み込むことができます。コミュニティはBeancountの機能を拡張するために多くのプラグインを作成しました：

• データ品質とルール: 例として、複数の勘定を含む方程式をアサートできるbeancount-balexpr（例：資産A + 資産B = 負債X）、勘定を閉鎖する際に自動的に残高アサーションを挿入してゼロになることを保証するbeancount-checkclosedがあります。ファイル内の取引が日付順にソートされていることを保証するプラグイン（autobean.sorted）もあり、順序が違うエントリーを検出します。
• 自動化: beancount-asset-transferプラグインは、勘定間で現物移管のエントリーを生成できます（取得原価を維持したままブローカー間で株式を移動するのに便利）。別のautobean.xcheckは、Beancount台帳を外部の明細書と相互チェックして不一致を見つけます。
• 繰り返し取引と予算: Akuukisによる**「repeat」または補間プラグインは、繰り返し取引を定義したり、年間の費用を月々に分割したりすることができます。予算管理については、fava-envelope拡張機能（Fava経由で使用）がプレーンテキストでのエンベロープ予算管理手法をサポートします。また、Frank DaviesによるMiniBudget**もあります。これは、個人や小規模ビジネスの予算管理を支援するためにBeancountに触発された小さなスタンドアロンツールです。
• 税務とレポート: 税務会計を支援するプラグインもあります。例えば、キャピタルゲインを自動的に短期と長期に分類するものなどです。別のプラグイン（Justus Pendletonによるfincen_114）は、外国口座を持つ米国納税者向けのFBARレポートを生成し、Beancountデータが規制報告にどのように活用できるかを示しています。
• コミュニティプラグインリポジトリ: beancount-plugins（Dave Stephensによる）のようなキュレーションされたプラグインセットがあり、減価償却エントリーなどに焦点を当てています。また、beancount-plugins-zack（Stefano Zacchiroliによる）には、ディレクティブのソートなどの様々なヘルパーが含まれています。

プラグインに加えて、Beancountを取り巻く他のユーティリティツールは特定のニーズに対応しています。例えば、beancount-blackは、Blackコードフォーマッタに似た自動フォーマッタですが、Beancount台帳ファイル用です。前述のように、チャット経由で取引を追加するためのBeancount Bot（Telegram/Mattermost）や、macOSですばやくファイルに取引を追加するためのAlfredワークフローがあります。Pintoという名前のツールは、対話的な入力（強化版bean-addのようなもの）を備えた「超強化された」CLIを提供します。他のシステムから移行する人のために、コンバータも存在します（YNAB2Beancount、CSV2Beancount、GnuCash2Beancount、Ledger2Beancount） 。 要約すると、Beancountエコシステムは非常に広範です。以下の表1は、いくつかの主要なツールと拡張機能をその役割とともにリストアップしたものです：

Ledger、hledger、および類似システムとの比較​

Beancountは、プレーンテキスト複式簿記会計ツールのファミリーに属しており、その中でもLedger CLI（John Wiegley's Ledger）とhledgerが有名です。これらのシステムはすべて、プレーンテキストの台帳ファイルと複式簿記という中心的な考えを共有していますが、構文、哲学、エコシステムの成熟度において異なります。以下の表は、Beancount、Ledger、hledgerの主な違いを強調しています：

要約すると、Beancountは厳格さ、プラグインベースの拡張性、そしてユーザーフレンドリーなWebインターフェースで差別化を図っています。Ledgerは、コマンドライン純粋主義者や究極の速度を必要とする人々に好まれる、古典的で非常に柔軟なツールであり続けています（LedgerのC++エンジンは巨大なファイルでも非常に高速です）。hledgerは中間的な立場を提供します – Ledgerの機能の多くを備えつつ、もう少し構造化されており、公式にサポートされた（シンプルではあるが）Web UIがあります。3つすべてがプレーンテキスト会計の利点（監査可能性、Gitによるバージョン管理、プレーンデータ）を共有していますが、Beancountのエコシステム（特にFava）は、近年、平均的なユーザーにとってよりアクセスしやすくしたと言えるでしょう。一方、Ledger/hledgerユーザーは、セットアップの相対的なシンプルさ（Python不要）と長年証明された安定性を好むことがあります。最終的に、どれを選ぶかは個人の好みに帰着します：厳格な正確性と豊富なエコシステムを重視する人はBeancountに傾くことが多く、一方、リーンでターミナル中心のツールを求める人はLedgerやhledgerに固執するかもしれません。

Beancountの利用シナリオ​

Beancountは、個人の財務追跡だけでなく、（場合によっては）小規模ビジネスの会計にも使用できるほど多機能です。どちらのシナリオでも、中核となる複式簿記のアプローチは同じですが、規模や具体的な慣行は異なる場合があります。

個人の財務​

多くのBeancountユーザーは、個人または家庭の財務を管理するためにBeancountを使用しています。Beancountでの典型的な個人財務設定には、当座預金や普通預金、クレジットカード、投資、ローン、収入カテゴリ（給与、利子など）、費用カテゴリ（家賃、食料品、娯楽など）の勘定が含まれるかもしれません。ユーザーは日々の取引を手動で記録する（領収書、請求書などを入力する）か、前述のインポーターツールを使用して銀行の明細書からインポートします。Beancountが個人の財務にもたらす利点には、次のようなものがあります：

• 統合と分析: すべての取引を、数年間の財務履歴を表す単一のテキストファイル（または一連のファイル）に保存できます。これにより、長期的なトレンドを簡単に分析できます。Beancountのクエリ言語やFavaを使えば、「過去5年間で旅行にいくら使ったか？」や「月平均の食料品費はいくらか？」といった質問に数秒で答えることができます。あるユーザーは、Beancountに切り替えた後、_「財務データ（支出、寄付、税金など）の分析は、FavaまたはデータをクエリしてPandasのようなツールを使用することで些細なことになった」_と述べています。本質的に、あなたの台帳は意のままにクエリできる個人の財務データベースになります。
• 予算管理と計画: Beancountは予算管理システムを強制しませんが、実装することは可能です。一部のユーザーは、予算勘定を作成したり、fava-envelopeプラグインを使用したりして、エンベロープ予算管理を行っています。他のユーザーは、定期的なレポートを使用して支出を目標と比較するだけです。プレーンテキストであるため、Beancountを外部の予算管理ツールやスプレッドシートと統合するのは簡単です（データをエクスポートするか、クエリからCSV出力を使用する）。
• 投資と純資産の追跡: Beancountは、取得原価と市場価格の堅牢な処理のおかげで、投資の追跡に優れています。株式や暗号資産などの売買を原価の詳細と共に記録し、Pricesディレクティブを使用して市場価値を追跡できます。Favaは、時系列の純資産チャートや資産クラス別のポートフォリオ内訳を表示できます。これは個人の資産管理にとって非常に有用です – MintやPersonal Capitalのような商用ツールが提供するものと同様の洞察を、完全に自分の管理下で得ることができます。多通貨対応も組み込まれているため、外貨や暗号資産を保有している場合、Beancountはそれらを追跡し、レポート用に変換できます。
• 照合と正確性: 個人の財務では、銀行の明細書との照合がしばしば伴います。Beancountでは、残高アサーションやドキュメント機能を使用して定期的に勘定を照合できます。たとえば、毎月balance Assets:Bank:Checking <日付> <残高>というエントリーを追加して、台帳が月末の銀行明細と一致することを確認できます。bean-checkツール（またはFavaのエラー表示）は、一致しない場合に警告します。あるユーザーは、すべての勘定の月次照合を行っており、それが「異常な活動を捉えるのに役立つ」と述べています – これはBeancountが促進する良い個人財務の衛生習慣です。
• 自動化: 技術に詳しい個人は、Beancountで個人財務ワークフローの大部分を自動化しています。インポーター、cronジョブ、そしておそらく少しのPythonを使用することで、たとえば、毎日銀行の取引が取得され（一部はOFXやAPIを使用）、ルールによって分類されてBeancountファイルに追加されるようなシステムをセットアップできます。時間が経つにつれて、あなたの台帳はほとんどが自動更新され、必要に応じてレビューと調整を行うだけになります。Hacker Newsのあるコミュニティメンバーは、3年後にはBeancountの帳簿が「95%自動化」されたと共有しました。このレベルの自動化は、Beancountのプレーンテキストのオープン性とスクリプト機能のおかげで可能です。

個人の財務ユーザーは、データの完全な所有権（閉鎖される可能性のあるクラウドサービスへの依存がない – たとえばMintが廃止されたことへの懸念）と、すべてのデータを統合したときの洞察の深さから、スプレッドシートやアプリよりもBeancountを選ぶことがよくあります。学習曲線は簡単ではありません – 基本的な会計とBeancountの構文を学ぶ必要があります – が、公式ドキュメントやコミュニティのチュートリアルのようなリソースが新規参入者を助けます。一度設定してしまえば、多くの人が、常に明確で信頼できる財務状況の全体像を持つことに安心感を見出します。

小規模ビジネス会計​

小規模ビジネス（または非営利団体、クラブなど）でBeancountを使用することは、個人での使用ほど一般的ではありませんが、確かに可能であり、成功している例もあります。Beancountの複式簿記フレームワークは、実際には企業会計を支えるシステムと同じですが、専用の会計ソフトウェアが提供する高レベルの機能（請求書モジュールや給与計算統合など）の一部が欠けています。Beancountが小規模ビジネスの文脈でどのように適合するかは次のとおりです：

• 総勘定元帳と財務諸表: 小規模ビジネスは、Beancountファイルを総勘定元帳として扱うことができます。銀行口座、売掛金、場合によっては在庫の資産勘定、クレジットカード、ローン、買掛金の負債勘定、所有者資本の資本勘定、売上やサービスの収益勘定、そしてすべての事業費用の費用勘定を持つことになります。この台帳を維持することで、Beancountのレポートやクエリを使用して、いつでも損益計算書と貸借対照表を作成できます。実際、Beancountの組み込みレポートやFavaは、会計原則に完全に準拠した貸借対照表と損益計算書を数秒で生成できます。これは、小規模な事業が収益性、財政状態、キャッシュフローを評価するのに十分です（キャッシュフロー計算書は直接組み込まれていませんが、少しクエリをかければ導き出せるため）。
• 請求書と売掛金、買掛金: Beancountには組み込みの請求書発行システムはありません。ユーザーは通常、外部で請求書を処理し（例：Wordや請求書アプリで作成）、その結果をBeancountに記録します。たとえば、請求書を発行すると、売掛金を借方に、収益を貸方に記録するエントリーを作成します。支払いがあれば、現金/銀行を借方に、売掛金を貸方に記録します。こうして、売掛金勘定の残高を見ることで、未回収の売掛金を追跡できます。請求書（買掛金）についても同様です。専門の会計ソフトウェア（リマインダーを送信したり、メールと統合したりするかもしれない）よりも手作業が多くなりますが、完全に実行可能です。一部のユーザーは、Beancountで請求書を管理し、未払いの請求書を見逃さないようにするためのテンプレートやワークフローを共有しています（たとえば、メタデータやカスタムクエリを使用して未払い請求書をリストアップするなど）。
• 在庫または売上原価: 製品を販売するビジネスでは、Beancountは在庫の購入と販売を追跡できますが、規律ある入力が必要です。Inventoryと原価計算機能を使用するかもしれません：在庫を購入すると資産勘定が増加し（アイテムに原価が付加される）、それを販売すると原価が費用（COGS）に移動し、収益が記録されます。Beancountはロットの一致を要求するため、正しい原価で在庫を適切に減少させることを強制し、これにより、正しく行われれば粗利益計算が正確であることが保証されます。ただし、自動化されたSKU追跡などはなく、すべて財務レベル（数量と原価）での管理です。
• 給与計算と複雑な取引: Beancountは給与取引（給与費用、源泉徴収税など）を記録できますが、これらの数値を計算するのは外部または別のツールで行い、結果をBeancountに記帳することになります。非常に小規模なビジネス（例えば従業員1〜2人）では、これは管理可能です。たとえば、給与期間ごとに賃金、源泉徴収税、事業主税費用、支払現金などを分割した単一の仕訳を記録します。これを手動で行うことは、QuickBooksの仕訳入力で行うのと似ています – どの勘定に計上すべきかの知識が必要です。
• 複数ユーザーと監査: ビジネス環境での課題の一つは、複数の人が帳簿にアクセスする必要がある場合や、会計士がレビューする必要がある場合です。Beancountはテキストファイルなので、リアルタイムでの複数ユーザー対応ではありません。しかし、ファイルをGitリポジトリでホストすることで、コラボレーションが可能になります：各人が編集してコミットし、差分をマージできます。
• 規制遵守: 税務申告やコンプライアンスのために、Beancountのデータを使用して必要なレポートを生成できますが、カスタムクエリやプラグインが必要になる場合があります。インド政府のコンプライアンス報告用のコミュニティプラグインや、FinCEN FBAR報告用のプラグインの例を見ました。これは、努力すれば、Beancountが特定の報告要件を満たすように適合させられることを示しています。要件がシンプルな管轄区域（現金主義会計、または基本的な発生主義）の小規模ビジネスは、確かにBeancountで帳簿を維持し、税務申告用の財務諸表を作成できます。しかし、減価償却スケジュールや償却などの機能は、独自のエントリーを書くか、プラグインを使用する必要があるかもしれません（Dave Stephensの減価償却プラグインがその自動化を助けます）。一部の会計ソフトウェアのように「資産を減価償却する」をクリックするGUIはありません。減価償却を取引としてエンコードします（ある意味、これにより謎が解けます – すべてが検査できるエントリーです）。

実際には、多くの技術志向の小規模ビジネスオーナーが、QuickBooksの利便性よりもコントロールと透明性を好む場合、Beancount（またはLedger/hledger）を使用しています。Redditの議論では、取引量が限られている標準的な小規模ビジネス会計では、Beancountは問題なく機能すると指摘されました。制限要因は通常、快適さのレベルです – ビジネスオーナー（またはその会計士）がテキストベースのツールに慣れているかどうか。一つの利点はコストです：Beancountは無料ですが、会計ソフトウェアは小規模ビジネスにとって高価になることがあります。一方、公式サポートの欠如とDIYの性質は、ビジネスオーナーであり、かつ技術に多少詳しい人に最も適していることを意味します。プログラミングスキルを持つフリーランサーや個人事業主にとって、Beancountはクラウド会計サービスに頼らずに財務を管理するための魅力的な選択肢となり得ます。

ハイブリッドアプローチも可能です：一部の小規模ビジネスは、請求書や給与計算に公式のシステムを使用し、定期的にデータをBeancountにインポートして分析やアーカイブを行っています。こうすることで、両方の長所を得ることができます – 日常業務のコンプライアンスと容易さ、そして統合された洞察のためのBeancountのパワーです。

要約すると、Beancountは、ユーザーが商用ソフトウェアが自動化することを手動で管理する意欲があれば、小規模ビジネス会計を処理できます。それは高度な透明性を保証します – あなたは帳簿を自分で書いているので、深く理解できます – そして、勤勉なユーザーにとっては、完璧な帳簿を作成できます。個人ユーザーとビジネスユーザーの両方が、Beancountの中核的な強みから恩恵を受けます：信頼性の高い会計エンジン、完全な監査証跡、そして（スクリプトとプラグインを介して）独自のシナリオに適応する柔軟性です。家庭の予算を追跡する場合でも、スタートアップの財務を管理する場合でも、Beancountはそれを正確かつオープンに行うためのツールキットを提供します。

コミュニティと開発活動​

Beancountには熱心なコミュニティがあり、その開発の歴史はオープンソースでニッチながらも情熱的な性質を反映しています。以下に、そのコミュニティ、メンテナー、関連プロジェクトに関する主要なポイントを挙げます：

• プロジェクトのメンテナンス: Beancountの主要な作者はMartin Blaisで、彼は2007年頃にプロジェクトを開始し、複数のバージョンを通じてそれを導いてきました。開発は長い間、大部分が一人での努力でした（コミュニティからのパッチの貢献を除く）。Martinの哲学は、「まず自分にとって、そして他の人にとっても、最もシンプルで、最も永続的な方法で役立つ」会計ツールを作ることでした。この個人的な動機が、プロジェクトを愛情のこもった労働として継続させました。2025年現在、Martin Blaisは依然としてリードメンテナーですが（彼の名前はコミットに現れ、メーリングリスト/イシュートラッカーで質問に答えています）、Beancountを取り巻くエコシステムには、それぞれのプロジェクトで他の多くの貢献者がいます。

• GitHubとリポジトリ: ソースコードはGitHubのbeancount/beancountリポジトリでホストされています。プロジェクトはGPL-2.0ライセンスで、長年にわたり modest な数の貢献者を引きつけてきました。2024年半ばに、Beancount Version 3が新しい安定版ブランチとして正式にリリースされました。このリリースは、いくつかのコンポーネントを分割したことが含まれます。例えば、beangulpリポジトリ（インポーター用）とbeanqueryリポジトリ（クエリツール用）は、現在beancount GitHub組織の一部であり、やや独立してメンテナンスされています。メインのBeancountリポジトリは、コアの会計エンジンとファイルパーサーに焦点を当てています。2025年現在、BeancountのGitHubは活発なイシュー議論と一部の進行中の開発を示しています – 量は多くありませんが、イシューやプルリクエストが少しずつ寄せられ、バグ修正や機能の洗練のために時折更新が行われています。

• Favaの開発: WebインターフェースであるFavaは、別のプロジェクトとして始まりました（Dominic Aumayrによって作成され、2016年に著作権が登録されました）。独自の貢献者コミュニティを持ち、これもGitHubのbeancount/favaで公開されています。Favaのメンテナーと貢献者（近年の例ではJakob Schnetz, Stefan Otteなど）は、インターフェースを積極的に改善しており、数ヶ月ごとにリリースがあります。FavaのGitterチャット（Favaのドキュメントにリンクあり）とGitHubイシュートラッカーは、ユーザーと開発者が新機能やバグについて議論する場所です。プロジェクトは貢献を歓迎しており、CHANGELOGのメモが複数のコミュニティメンバーのPRに感謝していることからも明らかです。FavaがBeancountの開発と密接に連携していること（Beancount v3と新しいbeanquery構文への迅速なサポート追加など）は、両プロジェクト間の良好な協力関係を示しています。

• メーリングリストとフォーラム: Beancountには公式のメーリングリストがあります（以前はGoogle Groupsにあり、「Beancount」というタイトル、または一般的なLedgerリストで議論されることもありました）。このメーリングリストは知識の宝庫です – ユーザーは特定のシナリオをモデル化する方法について質問したり、バグを報告したり、ヒントを共有したりします。Martin Blaisはメーリングリストで詳細な説明と共に返信することで知られています。加えて、より広範なプレーンテキスト会計コミュニティと大きく重なっています。Ledger CLIメーリングリストではBeancountに関する質問もよく取り上げられ、plaintextaccounting.orgのフォーラムやsubreddit r/plaintextaccountingではBeancountのトピックが頻繁に登場します。これらのプラットフォームのユーザーは、比較、個人のセットアップの共有、新規参入者の支援などを行っています。コミュニティの全体的な雰囲気は非常に協力的です – BeancountユーザーはしばしばLedgerユーザーを助け、その逆もまた然りで、これらのツールがすべて同様の目標を持っていることを認識しています。

• チャットグループ: メーリングリストの他に、Plaintext Accounting Slack/Discord（コミュニティ主催）やFava Gitterのようなチャットチャネルがあります。これらはより非公式で、リアルタイムに助けを得たり、機能について議論したりする方法です。例えば、特定の銀行のインポーターがあるかどうかSlackで尋ねることができます。Matrix/IRCチャネルも存在します（歴史的にはIRCの#ledgerや#beancount）。主流のソフトウェアのコミュニティほど人口は多くありませんが、これらのチャネルには知識豊富な人々がおり、難解な会計の質問に答えてくれることがよくあります。

• 貢献者と主要なコミュニティメンバー: Beancountコミュニティでは、いくつかの名前が際立っています：

  • “Redstreet” (Red S): 多くのプラグイン（beancount-balexpr, sellgainsなど）を書き、しばしばサポートを提供する多作な貢献者。彼らはまた、インポータースクリプトのセットと、明細書を取得するためのbean-downloadというツールを維持しています。
  • Vasily M (Evernight): いくつかのインポーターフレームワークやbeancount-valuationのようなプラグインの作者であり、投資に関するFavaへの貢献もあります。
  • Stefano Zacchiroli (zack): Emacs用のbeancount-modeと独自のプラグインリポジトリを作成したDebian開発者。彼は学術的な場でもプレーンテキスト会計を提唱しています。
  • Simon Michael: 主にhledgerのリーダーですが、Beancountを含むplaintextaccounting.orgを運営しています。この相互交流が、BeancountをLedger/hledgerユーザーの注目を集めるのに役立ちました。
  • Frank hell (Tarioch): 特にヨーロッパの機関向けの主要なインポーターと価格取得ツールのセットであるTarioch Beancount Toolsの貢献者。
  • Siddhant Goel: Beancountについてブログを書いているコミュニティメンバー（例えば、v3への移行ガイド）で、いくつかのインポーターを維持しています。彼のブログ投稿は多くの新規ユーザーを助けてきました。

  これら多くの人々がコード、ドキュメント、フォーラムでのヘルプを提供し、比較的小規模ながらもエコシステムを活気あるものにしています。

• GitHubの統計とフォーク: BeancountのGitHubリポジトリは、数百のスター（関心を示す）とフォークを集めています。Beancount自体の著名なフォークは稀です – 「Beancountだが機能X付き」というようなよく知られた分岐フォークはありません。代わりに、ユーザーが何か違うものを望んだとき、彼らはプラグインを書くか、別のツール（hledgerなど）を使用するかのどちらかであり、Beancountをフォークすることはしませんでした。hledgerはLedgerの一種のフォーク（Beancountではない）と考えることができ、Beancount自体はLedgerのアイデアを独自に再考したものですが、Beancountのリポジトリ内に大きな分裂プロジェクトはありません。コミュニティは一般的にメインリポジトリの周りに集まり、コードベースを断片化する代わりにプラグインインターフェースを介して拡張してきました。これはおそらく、Martin Blaisが外部からの貢献にオープンであり（彼のドキュメントには外部の貢献とモジュールを認めるセクションさえあります）、プラグインアーキテクチャがほとんどの新機能のためにフォークを維持する必要をなくしたためでしょう。

• コミュニティリソース: コミュニティによって作成された、Beancountを学び、使用するための高品質なリソースがいくつかあります：

  • GitHub Pages上のBeancountドキュメント（およびMartinが維持しているソースのGoogle Docs） – 会計の理論とBeancountがそれをどのように実装しているかを含め、非常に包括的です。
  • 数多くのブログ投稿や個人的なメモ – LWN.netには「Counting beans… with Beancount」という記事があり、多くの個人ブログ（Awesome Beancountの「Blog Posts」セクションにリストされている）が経験やヒントを共有しています。これらは知識を構築し、新規ユーザーを引きつけるのに役立ちます。
  • トークとプレゼンテーション: Beancountはミートアップやカンファレンスで発表されてきました（例えば、Python/Beancountで財務を管理するに関するPyMunich 2018のトーク）。このようなトークはツールをより広い聴衆に紹介し、しばしばHacker Newsのようなフォーラムで関心を呼び起こします。

• 注目すべき関連プロジェクト: Favaの他に、Beancountに関連するいくつかの他のプロジェクトには独自のコミュニティがあります：

  • Plain Text Accountingサイト – Simon Michaelによって維持されており、すべてのそのようなツールに関する情報を集約し、人々がBeancountを含む様々なツールの使用法を共有するフォーラムがあります。
  • 金融ツールとの統合: 一部のユーザーはBeancountをビジネスインテリジェンスツールやデータベースと統合しています。例えば、あるGoogle Groupsのスレッドでは、カスタム関数を介してPostgreSQLとBeancountデータを使用する詳細が述べられています。主流ではありませんが、これはBeancountの能力を押し広げる（例えば、非常に大規模なデータセットや組み込みを超える複雑なクエリを扱う）コミュニティの実験精神を示しています。

要約すると、Beancountのコミュニティは、大規模なオープンソースプロジェクトのコミュニティよりも小さいものの、非常に熱心で知識が豊富です。プロジェクトは着実な改善の流れと非常に役立つサポートチャネルを享受しています。協力的な精神（インポーターの共有、プラグインの作成、質問への回答）は、2025年の新規参入者が会計システムをセットアップする際に、広範な先行作業とコミュニティの知恵に頼ることができることを意味します。開発はエコシステムの意味で活発です – Favaのリリース、プラグイン開発など – たとえコアの変更が時折であってもです。エコシステムの成長（数十のツールがリストされたAwesome Beancountリストが証明するように）は、Beancountをますます有能にする健全なコミュニティを物語っています。

最近の開発と今後の機能​

2025年現在、Beancountエコシステムは過去数年間で大きな発展を遂げており、将来の機能強化に関する議論も進行中です。以下に、注目すべき最近の開発と、今後の展望をいくつか紹介します：

• Beancount 3.0リリース（2024年）: Beancount 2.xが長らく標準であった後、バージョン3が2024年半ばに正式にリリースされました。これは、v3がコードベースの簡素化と近代化を意味するため、大きな節目となりました。Martin Blaisは、v3をシステムをさらに「再整理し、簡素化する」機会として構想していました。当初は大規模な書き直しと考えられていましたが、実際にはユーザーにとってのアップデートはそれほど破壊的ではありませんでした。主な変更は_内部的_なものでした：新しいパーサー、いくつかのパフォーマンス改善、そしてオプションのコンポーネントのコアからの抽出です。リリースは段階的に行われました（v3は2022年からベータ版でしたが、2024年7月までに推奨される安定版となりました）。Siddhant Goelのようなユーザーは、2.xから3.xへの移行は「ほとんど何事もなく」、ワークフローの変更はわずかだったと報告しています。

• モジュール化 – ツールの別パッケージへの移動: Beancount 3の大きな変更点の一つは、かつてモノリシックなリポジトリにあった多くのツールがスピンオフされたことです。例えば、bean-queryは現在beanqueryパッケージによって提供され、beancount.ingestはbeangulpパッケージに置き換えられました。bean-extractやbean-identifyのようなコマンド（インポート用）は、コアのBeancountから削除されました。代わりに、インポートにはスタンドアロンのスクリプトを使用するという哲学です。これは、v3にアップグレードすると、中央のbean-extract設定ファイルを持つのではなく、beangulpをインストールし、インポータースクリプト（各インポーターは基本的に小さなプログラム）を実行することを意味します。同様に、クエリはbeanqueryを介して実行され、これはBeancountコアとは独立してインストールおよび更新できます。このモジュール化アプローチは、メンテナンスを容易にし、コミュニティの貢献を促進するために設計されました。また、Beancountのコアをスリム化し、コアが純粋に解析と会計ロジックに集中できるようにし、付随的な機能は別々に進化できるようにしました。ユーザーの観点からは、アップグレード後、コマンドを調整する必要があります（例えば、beanqueryからbean-queryを使用するか、これを抽象化してくれるFavaを使用するなど）。Favaの変更履歴はこれらの変更を明確に記述しています：Favaは現在beanqueryとbeangulpに依存しており、Beancount 3と2でインポートワークフローを異なる方法で処理します。

• パフォーマンスの向上: パフォーマンスは、Beancountの設計を再検討する動機の一つでした。v3計画（Martinの「V3の目標」ドキュメントに概説）には、パーサーの最適化と、おそらく読み込みプロセスをより速く、より少ないメモリ消費にするものが含まれていました。2025年までに、これらの改善の一部は実現しました。逸話的に、非常に大きな台帳（数万の取引、または多くの株式取引）を持つユーザーは、最新バージョンでパフォーマンスが向上したと報告しています。例えば、「マイクロ投資取引」を扱っていてパフォーマンス問題に直面していたユーザーがGoogle Groupでこれらの懸念を表明しました – この種のフィードバックがv3に影響を与えた可能性があります。新しいパーサーはより効率的で、より明確な方法で書かれており、将来的には拡張される可能性があります。さらに、Fava 1.29は、台帳が変更された際の応答性を向上させるために、より効率的なファイル監視メカニズム（watchfilesライブラリを使用）に移行しました。将来的には、コミュニティは大規模な台帳をより迅速に処理するために増分解析（すべてを再処理するのではなく、ファイルの変更部分のみを再処理する）を探求するかもしれません – これはドキュメントで「Beancountサーバー/増分記帳」のアイデアとして示唆されていました。

• 投資追跡機能の強化: 投資とポートフォリオのレポートを改善するための継続的な作業が行われています。例えば、平均取得原価法対FIFOの扱いは詳細に議論されました。Beancountはロットマッチングを強制しますが、一部のユーザーは特定の管轄区域で平均原価を好みます。原価計算の記帳をより柔軟にするための提案と議論が存在します（おそらくプラグインまたはオプションを介して）。2025年現在、平均原価への組み込みスイッチはありませんが、v3の基礎（記帳の再設計）により、プラグインが実装しやすくなっています。税金を最小限に抑えるためにどのロットを売却すべきかを提案できるコミュニティプラグイン「Gains Minimizer」がリリースされ、投資周りで構築されている高度なツールの種類を示しています。Favaも、ポートフォリオサマリー拡張機能（収益率計算付き）などの機能を追加しました。今後の機能としては、この領域でさらに多くのものが期待できます：おそらく自動化されたポートフォリオリバランシングの提案やリスク分析で、これらはBeancountデータを読み取る外部ツールとして提供される可能性が高いです（データはすべてそこにあるため）。

• 新しいプラグインと拡張機能: プラグインエコシステムは継続的に成長しています。最近の注目すべき追加には以下があります：

  • 予算報告ツール – FavaのUIを使用しない場合のためのシンプルなCLI予算レポーターなど。
  • 暗号化とセキュリティ – Favaをオンラインでホストし、台帳を保存時に暗号化できるfava-encryptセットアップが導入され、財務をセルフホストする懸念に対処しました。
  • 生活の質を向上させるプラグイン – autobean-format（ファイルを解析して再出力することで、より多くのコーナーケースを処理できる新しいフォーマッタ）や、エディタへのbeancheck統合（Emacsのflymake）など。

  将来的には、コミュニティはプラグインを通じてギャップを埋め続けるでしょう。例えば、より多くの税関連プラグインが見られるかもしれません（一部のユーザーはウォッシュセールの計算や特定の地方税レポートのようなもののためのスクリプトを共有しています）。

• 可能性のある今後の機能: イシュートラッカーやメーリングリストでの議論に基づくと、いくつかのアイデアが視野に入っています（保証されているわけではありません）：

  • 時間解像度: 現在、Beancountは取引の日付のみを追跡し、タイムスタンプはありません。時間（株式取引や同日取引の順序付けのため）を追加することについての質問がありました。Martin Blaisは、物事をシンプルに保つために、日以下のタイムスタンプはスコープ外であると明示的に決定しました。これはすぐには変わらないでしょう – したがって、今後のバージョンではおそらく時間解像度は追加されず、時間が必要な場合はナレーションや勘定に組み込むというスタンスを維持するでしょう。
  • GUI編集機能の強化: Favaは継続的に編集能力を向上させています。よりフル機能のWebエディタ（自動提案、おそらく新規取引のためのフォームベースのエントリー）の可能性があります。Favaのエディタでtree-sitterを使用する基礎は築かれました。Favaは単なるビューアではなく、より強力なエディタになり、多くのタスクでテキストエディタを開く必要性を減らすかもしれません。
  • より良い複数台帳サポート: 一部のユーザーは複数のBeancountファイルを維持しています（異なるエンティティ用、または個人用とビジネス用を分けるため）。現在、ファイルのインクルードは可能ですが、制限がありました（インクルードされたファイル内のプラグインなど）。最近、外部台帳を安全にインクルードするためのプラグインautobean.includeが作成されました。将来的には、複数ファイル設定の第一級サポートが見られるかもしれません – おそらく複数のファイルを持つBeancount「プロジェクト」の概念（これはVSCode拡張機能のbeancount.mainBeanFile設定のような機能によって示唆されています）。これは、複数エンティティの簿記を実行している人や、台帳をモジュール化したい人を助けるでしょう。
  • リアルタイムまたは増分計算: 台帳が大きくなるにつれて、レポートを迅速に再計算する能力が重要になります。実行し続け、取引が変更されると結果を更新するBeancountサーバーのアイデアがあります。これはFavaの最適化として、またはエディタプラグインがクエリできるデーモンとして現れるかもしれません。おそらく将来のFavaリリースでは、巨大な台帳に対してUIをよりレスポンシブにするために、継続的に実行されるBeancountプロセスを活用するでしょう。
  • ファンド会計 / 非営利団体の機能: Beancountでのファンド会計に関する機能強化提案がありました。非営利団体には（制限付き資金対非制限資金のような）会計ニーズがあり、これらはBeancountのタグや勘定階層でモデル化できる可能性があります。議論はまだ組み込み機能には至っていませんが、より多くの非営利団体がBeancountを採用すれば、これが新しい能力（おそらく文書化されたベストプラクティスやファンド残高追跡用のプラグイン）を推進するかもしれません。

• 長期的な展望: Martin Blaisは、Beancountの将来は、コアをよりエンジン的なものにし、より多くの機能をプラグインに移行させることにあると示唆しました。これは私たちが見ているもの（v3でのモジュール化）と一致しています。したがって、哲学的な意味での「今後の機能」はより大きな拡張性です – おそらくプラグインが新しいディレクティブタイプを定義したり、制御された方法で構文を拡張したりすることさえ可能にするかもしれません。そうなれば、Beancountのコアは比較的小さく安定したままで、エコシステムがほとんどの新機能をアドオンとして提供することになります。これにより、プラグインマーケットプレイスや、ユーザーが選べるようにプラグインのより中央集権的なリストが生まれるかもしれません（Awesome Beancountリストはその始まりです）。

結論として、2025年のBeancountエコシステムは活発で進化しています。Beancount 3.0のリリースは最近の大きな出来事であり、プロジェクトの基盤が将来にわたって堅固であることを保証しました。パフォーマンス、ツール、ユーザビリティ（特にFavaを介して）の改善は、参入障壁を下げ続けています。Beancountはある程度の専門知識を必要とするツールであり続けますが、これらの開発のおかげで、数年前よりもはるかにアクセスしやすくなっています。今後の機能は、コア哲学への抜本的な変更ではなく、体験の洗練 – より速いパフォーマンス、より良い統合、そして特殊な拡張機能 – に焦点を当てるでしょう。コミュニティの軌道は、Beancountがプレーンテキスト会計の中心として成熟し続け、複式簿記の厳格な力と現代のソフトウェアの利便性のバランスをとることを示唆しています。あるユーザーがHacker Newsで冗談めかして言ったように、プレーンテキスト会計はあなたの財務を理解する上で「超能力」を与えてくれます – そして、Beancountの最近および将来の改善は、それらの超能力を誰もがより簡単に使いこなせるようにすることを目指しています。

情報源: Beancountドキュメントおよびリポジトリ、Favaドキュメント、Martin Blaisによる「A Comparison of Beancount and Ledger」、Awesome Beancountリソースリスト、ユーザー体験およびコミュニティレポート

Beancount は、開発者やファイナンス好きに愛される二重仕訳会計システムで、シンプルさが魅力です。しかし、Fava（Beancount のウェブインターフェース）で、より細かい制御や高速なナビゲーションを求めるユーザーには、カスタムサイドバーリンクと SQL クエリがワークフローを次のレベルへ引き上げます。

このガイドでは、以下を実現する方法を紹介します。

• Fava のサイドバーにクイックアクセスリンクを追加する
• 高度なフィルタリングと分析のために SQL クエリを使用する
• 月次レビューや異常検知のためにワークフローをカスタマイズする

なぜ Fava をカスタマイズするのか？​

Fava はすでに美しい Ledger 表示インターフェースですが、ジャーナルが大きくなるにつれて、ショートカットやスマートクエリの必要性も高まります。

解決できる課題​

• 時間範囲を何度も手動で指定する手間
• ネストされた勘定科目を横断する取引のフィルタリング
• マイナス残高や異常を迅速に検出したい

✨ カスタムサイドバーリンク​

まずは、シンプルなサイドバーショートカットで日々の作業を改善しましょう。これらのリンクは Fava の左サイドバーに表示され、今月の取引や先月の収入といったフィルタビューへ直接ジャンプできます。

Beancount ファイルに以下の行を追加します。

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

動作概要​

• Current Month：現在の月にフィルタされた取引ビューを開く
• Last Month：前月に即座にジャンプ（月末レビューに最適）
• Clear All：フィルタをリセットし、全エントリを再表示

これらのショートカットにより、手動で時間を入力する手間が省け、Fava の操作感がより流動的かつパーソナライズされます。

🔍 カスタム SQL クエリ​

さらに深い洞察が必要な場合は、Fava の SQL インターフェースが非常に強力です。以下は、特定パターンにマッチする勘定科目の マイナス残高 をすべて抽出するクエリ例です。異常取引のフラグ付けに最適です。

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
  AND account   '.*:BCM:.*'
  AND date >= DATE(2021,12,9)
  AND date < DATE(2022,1,9)

クエリの構成要素​

• account '.*:BCM:.*'：名前に :BCM: を含む勘定科目をフィルタ
• number(units(position)) < 0：マイナス残高（例：予算超過）を検出
• 日付条件で 1 カ月間に絞り込み

活用例​

• 重複経費や誤った仕訳のエラー検出
• 特定ベンダーやカテゴリの監査
• 予算策定のための実用的インサイト抽出

🛠 プロのコツ：リンクとクエリを組み合わせる​

Fava ではカスタムクエリへの直接リンクは作れませんが、以下の手順で月次レビュー習慣を構築できます。

1. 「Current Month」リンクでレビューを開始
2. 別ペインで保存済みクエリタブを開く
3. まずフィルタを適用し、次にクエリで詳細分析

この組み合わせにより 異常を早期に捕捉 し、Ledger のクリーンさを維持 できます。

最後に​

Beancount はミニマル設計ですが、こうした小さな拡張で効率は飛躍的に向上します。予算の見直し、奇妙な残高のデバッグ、クリック数の削減など、カスタムリンクと SQL クエリは「パワー」を増し「摩擦」を減らします。

ボーナス：もし Fava のカスタムレポート を利用しているなら、個人のファイナンス習慣に合わせたダッシュボードも構築可能です。

さあ、コントロールを手に入れましょう！

まずは小さく始めてみてください。 「Current Month」リンクを追加し、次に自分だけのクエリを作成。将来の自分が感謝するはずです。

もっとこうしたヒントが欲しいですか？ ニュースレターに登録するか、Beancount.io で他のレシピを探索してください。

MIT ライセンスのオープンソースソフトウェア Fava をバージョン 1.19 にアップグレードしました。前回の更新以降の変更点は以下の通りです：

• v1.19 (2021-05-18)
  • conversion と interval オプションから default-page オプションへ移行
  • オプション invert-income-liabilities-equity を追加
  • CodeMirror 6 にアップグレード
  • ブルガリア語翻訳を追加
  • その他の小さな改善とバグ修正
• v1.18 (2021-01-16)
  • 小規模な改善とさまざまなバグ修正を数件実施。

ワクワクしていますか？ 今すぐ以下でお試しください https://beancount.io/ledger/

ご質問がありますか？ https://t.me/beancount でサポートします :)

償却は支払いを時間にわたって多数の分割払いに分散させます。beancount.io では、プラグイン fava.plugins.amortize_over を使用してこれを実現できます。

償却を使用しない場合、例えば 6 ヶ月間の自動車保険に 600 ドルかかるとします。この費用は特定の日付の一回限りの費用として記録しなければなりません。

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto


2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

しかし、償却を使用すれば、ファイルの先頭に plugin "fava.plugins.amortize_over" を記述し、取引に amortize_months: 6 を指定することで、費用を 6 ヶ月にわたって配分できます。

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

そしてジャーナルでは、取引が 6 件のポスティングに分割されていることが確認できます。

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am

セキュアで高性能なオンラインサービスを維持することは、一度きりの作業ではありません。新機能の開発だけでなく、既存機能の刷新にも継続的な努力が必要です。

古くなったソフトウェアは、顧客をセキュリティ脆弱性のリスクにさらします。このリスクをどう減らすか？一方では、セキュリティ研究者と積極的に協力し、予期せぬ問題を発見・解決しています。もう一方では、上流ソフトウェアの最新バージョンを定期的にマージしています。

本日は、Beancount.io に加えた改善点をいくつかご紹介できることを嬉しく思います。

1. サーバーをアップグレードし、サービス速度を最大30%向上させました。サービスの可用性も大幅に改善されました。
2. MIT ライセンスのオープンソースソフトウェアである Fava をバージョン 1.17 に更新しました。さまざまなバグを修正し、多くの新機能を追加しています。

ワクワクしていますか？ 今すぐ以下からお試しください: https://beancount.io/ledger/

ご質問がありますか？ 私たちはこちらでサポートします: https://t.me/beancount :)