「オープンソース」タグの記事が6件件あります

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 バージョン3は2024年中頃にリリースされ、人気のプレーンテキスト会計ツールにとって重要なアーキテクチャの進化を示します。ユーザーの元帳ファイルとの下位互換性は維持しつつ、基盤となる構造と付随するツールは大幅に変更されました。以下に Beancount v3 の新機能をまとめます。

よりモジュラーでスリムなアーキテクチャ​

Beancount v3 で最も重要な変更は、よりモジュラーなエコシステムへの移行です。以前はコアに統合されていた主要な機能が、別々の独立したプロジェクトとして分離されました。これにより Beancount のコアは軽量化され、個々のコンポーネントに対する開発がより集中できるようになりました。

現在は別パッケージとして提供されている主要コンポーネントは次のとおりです：

• beanquery: 元帳ファイル用の強力な SQL ライクなクエリツールが、現在は独立したパッケージとなっています。
• beangulp: データインポートフレームワークの新しい拠点で、従来の beancount.ingest モジュールに代わります。
• beanprice: 商品や株式の価格取得専用ツールです。

この分離により、ユーザーは従来のバージョン2で使用していたフル機能を維持するために、beancount 本体に加えてこれらのパッケージをインストールする必要があります。

コマンドラインツールとワークフローの変更​

新しいモジュラーアーキテクチャを反映し、コマンドラインツールにいくつか顕著な変更があります：

• bean-report は廃止: このツールは削除されました。ユーザーはレポート作成に bean-query（beanquery パッケージ）を使用することが推奨されます。
• 新しいインポーター・ワークフロー: bean-extract と bean-identify コマンドはコアから削除されました。beangulp を用いた新しいアプローチはスクリプトベースです。ユーザーは銀行明細など外部ソースからのデータインポートを処理するために、独自の Python スクリプトを作成します。

構文と機能の強化​

コアとなる会計原則は変わりませんが、Beancount v3 は構文にいくつかの柔軟性を導入しています：

• 通貨コードの柔軟化: 以前は通貨名の長さや文字種に制限がありましたが、これが緩和され、1文字の通貨シンボルもサポートされるようになりました。
• 取引フラグの拡張: 取引のフラグとして A から Z までの任意の大文字を使用でき、より細かい分類が可能になりました。

重要なのは、これらの変更は下位互換性があるため、既存の Beancount v2 の元帳ファイルは変更なしでそのまま使用できます。

C++ リライトとパフォーマンス​

Beancount の長期的な目標の一つは、パフォーマンスクリティカルなコンポーネントを C++ でリライトすることでした。この作業は進行中ですが、Beancount v3 の最初のリリースには C++ ベースのコアは 含まれていません。したがって現時点では v3 のパフォーマンスは v2 と同等です。C++ のコードは将来の統合に向けて別の開発ブランチに残されています。

v2 から v3 への移行​

ほとんどのユーザーにとって、Beancount v2 から v3 への移行は比較的簡単です：

1. 元帳ファイル: .beancount ファイルに変更は不要です。
2. インストール: pip を使用して beanquery や beangulp などの新しい別パッケージをインストールする必要があります。
3. インポーター・スクリプト: カスタムインポーターがある場合、 新しい beangulp API を使用するように更新する必要があります。主にインポーターが継承する基底クラスの変更と、いくつかのメソッドシグネチャの調整が必要です。
4. Fava: Beancount の人気ウェブインターフェースである Fava は v3 に対応するように更新されています。シームレスな体験のために、最新バージョンの Fava を使用してください。

要するに、Beancount v3 はプロジェクトのアーキテクチャをスリム化し、長期的によりモジュラーで保守・拡張しやすい基盤リリースです。特にデータインポート周りでユーザーのワークフローにいくつかの調整が必要ですが、この強力な会計ツールの将来の開発に向けた土台を築きます。

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リソースリスト、ユーザー体験およびコミュニティレポート

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 でサポートします :)

プライバシーは私たちのDNA、文化、価値観の核です。私たちはシステム全体でお客様のデータ保護にコミットしています。

そして本日、Beancount モバイルをオープンソース化することを発表できることを嬉しく思います。これはコードが公開されていますことを意味し、誰でも検証できます。このレベルの透明性は、アプリのセキュリティと、データの取り扱いに関する安心感の両方を保証します。

オープンソースは、市場でのお客様により多くの選択肢と多様なソリューションを提供します。私たちは優れたオープンソースプロジェクトの上に Beancount.io を構築しており、将来的にシステムの可能な限り多くのモジュールをオープンソース化したいと考えています。そして Beancount モバイルはこの旅の始まりにすぎません :)

お金の流れが分からなければ、ビジネスを舵取りできません。 正確な帳簿は、推測を洞察に変えます。 (Investopedia)

すべての事業主、フリーランサー、スタートアップ創業者は、やがて同じ現実に直面します。財務の混乱は成長の殺し屋です。キャッシュフローの全体像が見えなければ、盲目的に飛び回ることになります。では、コードに対して持つのと同じ精度とコントロールで財務を管理できたらどうでしょうか。プレーンテキストファイルで動作する強力なオープンソース会計システム、Beancount が登場します。

このガイドでは、簿記の基本を順を追って解説し、Beancount を使って堅牢で軽量、かつ透明性の高い財務ワークフローを構築する方法を示します。

簿記とは？​

簿記は、事業が行うすべての財務取引を体系的かつ継続的に記録することです。収益、費用、資産（所有物）、負債（負っているもの）を日々追跡する discipline です。

Beancount の世界では、これらの記録は専用ソフトに閉じ込められません。シンプルで人間が読めるプレーンテキストファイルに保存されます。このアプローチにより、Git などのツールで財務履歴をバージョン管理でき、ソフトウェアプロジェクトと同様に管理できます。すべてのエントリは、二重仕訳のバランス規則に従い、自動的にチェックされ、常に正しい帳簿が保たれます。 (beancount)

なぜ重要なのか​

綿密な簿記は、単なる事務的な整理ではなく、戦略的優位性です。

• 税務の自信： 税シーズンになると、整った記録が最強の味方になります。IRS は所得と控除の明確な書類を求めます。適切に管理された元帳があれば、自信を持って申告でき、監査の可能性を大幅に短縮できます。 (IRS)
• 意思決定の鋭さ： 価格は十分か？特定のサービス契約は本当に利益を生んでいるか？サブスクリプション費用は暴走していないか？損益計算書や貸借対照表といった財務諸表は、価格漏れやコストの逸脱、キャッシュフローの穴を明らかにし、経営者や投資家に賢明な選択に必要なデータを提供します。 (Investopedia)
• 資金調達の容易さ： 貸し手や投資家は感覚で決めません。資金を振り込む前に財務諸表の提出を求めます。整った帳簿があれば、数秒で貸借対照表や損益計算書を生成でき、プロフェッショナリズムと財務健全性を示せます。 (Investopedia)
• 不正・エラーの警告： 銀行明細と帳簿の定期的な照合は、ミスに対する第一線の防御です。このシンプルな習慣により、重複請求や銀行エラー、詐欺行為を早期に発見し、重大な問題になる前に対処できます。 (IRS)

7 ステップのプレーンテキスト設計図​

始める準備はできましたか？以下の手順で、Beancount を基盤とした簿記システムをゼロから構築します。

1. 事業用口座と個人用口座を分離する​

これは絶対に譲れない最初のステップです。専用の事業用当座預金口座を開設し、必要に応じて事業用クレジットカードも取得します。資金を混同すると会計が悪夢になり、個人と事業の負債ラインが曖昧になります。正確な控除と法的保護のために、クリーンな分離は必須です。 (Small Business Administration)

Beancount では、open ディレクティブで口座の存在を宣言します：

; 口座のオープニングバランス
2025-07-22 open Assets:Bank:Business   USD
2025-07-22 open Assets:Bank:Personal   USD

2. 簿記システムを選択する​

Beancount は 二重仕訳 手法を採用しています。これは何世紀にもわたる会計の金字塔です。原則はシンプルです：すべての取引は少なくとも二つの口座に影響します。ある口座からの借方には、必ず別の口座への貸方が対応します。このシステムの魔法は、すべての口座の合計が常にゼロにバランスすることです。Beancount はこの規則を自動的に強制するため、タイプミスや論理エラーは即座にフラグが立ちます。バランスが取れない帳簿は存在できません。 (beancount)

3. 会計基準を決める​

主に次の二つから選択します：

• 現金主義： 収入は現金が入ったとき、費用は支払ったときに記録します。シンプルでキャッシュフローを直接反映します。
• 発生主義： 収入は「稼いだ」時点（例：請求書を送ったとき）に、費用は「発生した」時点（例：請求書を受け取ったとき）に記録します。特に成長中の企業にとって、財務の実態とパフォーマンスをより正確に把握できます。 (Investopedia)

以下は発生主義取引の例です。請求書を送った時点で収入を Assets:AccountsReceivable に計上し、クライアントが支払ったら現金を銀行口座に移動します。

; 発生主義例：請求書発行、後で入金
2025-07-22 * "Design invoice #101"
  Assets:AccountsReceivable     3000.00 USD
  Income:Design

2025-08-15 * "Client pays invoice #101"
  Assets:Bank:Business          3000.00 USD
  Assets:AccountsReceivable

4. ツールスタックを組む​

Beancount の魅力は、ミニマリストでモジュラーな構造です。コアスタックは次の通りです：

• エディタ + Git： 好きなテキストエディタで取引を記録し、Git でバージョン管理することで、すべての変更履歴を監査可能にします。
• bean-report / bean-balance / Fava： bean-report などのコマンドラインツールや、見た目が美しいウェブインターフェース Fava が即座に財務諸表やダッシュボード、強力なフィルタリング機能を提供します。
• インポーター： コミュニティが構築した豊富なインポーターが、CSV、Plaid、Stripe、PayPal などの API から銀行フィードに接続し、データ入力の多くを自動化します。

5. すべての取引にカテゴリを付ける​

整理された「勘定科目表」は、洞察に満ちたレポートの土台です。事業に合ったカテゴリを階層的に定義し、取引を記録するたびに細かく分類します。

2025-07-30 * "AWS monthly bill"
  Expenses:Hosting:AWS       124.50 USD
  Assets:Bank:Business
  tag: "ops"

この例では、費用は Expenses:Hosting:AWS に明確に分類されています。tag: "ops" を付与することで、主要カテゴリに関係なく「運用費用」だけを抽出するレポートが作れます。 (IRS)

6. 原本書類を安全に保管する​

IRS はデジタルコピーの領収書や請求書を喜んで受け入れます。紙の領収書はスキャンし、メール請求書は Google Drive や Dropbox などのクラウドフォルダに転送します。その後、Beancount エントリにメタデータとして直接リンクを貼ります。これにより、完全に閉じた自己完結型の記録が完成します。

; 領収書画像をメタデータでリンク
2025-07-18 * "Team lunch"
  Expenses:Meals              85.10 USD
  Assets:Bank:Business
  receipt: "receipts/2025-07-18-team-lunch.jpg"

7. 簿記を習慣化する​

継続は力なり。先延ばしにすると簿記はストレスフルで時間がかかる作業になります。毎週または毎月の「Bean-day」を設定し、取引のインポート、口座の照合、財務レポートの確認を行いましょう。このシンプルなルーティンが、四半期ごとの慌ただしい作業を、短時間で完了できるビジネスヘルスチェックに変えます。 (IRS)

DIY とプロの支援​

• DIY： 取引量が予測可能なフリーランサーや小規模事業者にとって、Beancount を使った DIY アプローチは非常に効果的です。チャート・オブ・アカウントの妥当性確認や全体の方向性を確かめるために、税理士と一度だけ相談するのが賢明です。
• プロのレビュー： 事業が拡大し取引が複雑化したり、コンプライアンスリスクが高まったりした場合は、定期的にプロのブックキーパーや会計士にレビューしてもらう価値があります。Beancount は真実の情報源として使い続け、必要なレポートだけをエクスポートして提供すれば OK です。

クイックスタートチェックリスト​

• 事業用と個人用の銀行口座を分離する。
• Beancount のスターターレポジトリをクローンし、accounts.bean に口座を定義する。
• 現金主義か発生主義かを選び、徹底する。
• 銀行（CSV）、Stripe、PayPal などのインポーターを設定してデータ入力を自動化する。
• すべての取引にタグと明確な説明文を付ける。
• 週次または月次で元帳を銀行明細と照合する。
• Fava または bean-report を使って月次の損益計算書、貸借対照表、キャッシュフロー報告書を生成する。
• .bean ファイルを定期的にバックアップする（Git + オフサイトストレージ）。

さらに読む​

• IRS Publication 583 — Starting a Business & Keeping Records
• Beancount Documentation — Language & Command-Line Tools

始める準備はできましたか？ Beancount をインストールし、最初のエントリをコミットして、スプレッドシートの曖昧さからプレーンテキストの明快さへと移行しましょう。ハッピー・ビーンズキーピング！