3 posts tagged with "financial tools"

Beancount version 3, released in mid-2024, marks a significant architectural evolution for the popular plain-text accounting tool. While it maintains backward compatibility for user ledger files, the underlying structure and accompanying tools have undergone substantial changes. Here’s a breakdown of what’s new in Beancount v3.

A More Modular and Streamlined Architecture​

The most significant change in Beancount v3 is the move to a more modular ecosystem. Several key functionalities that were previously bundled with the core have been spun off into separate, independent projects. This makes the core of Beancount leaner and allows for more focused development on individual components.

The key components that are now separate packages include:

• beanquery: The powerful SQL-like query tool for your ledger files is now in its own package.
• beangulp: This is the new home for the data importing framework, replacing the former beancount.ingest module.
• beanprice: A dedicated tool for fetching prices of commodities and stocks.

This separation means that users will need to install these packages in addition to beancount itself to retain the full functionality they were used to in version 2.

Changes to Command-Line Tools and Workflows​

Reflecting the new modular architecture, there are some notable changes to the command-line tools:

• bean-report is gone: This tool has been removed. Users are now encouraged to use bean-query (from the beanquery package) for their reporting needs.
• New Importer Workflow: The bean-extract and bean-identify commands have been removed from the core. The new approach with beangulp is script-based. Users will now create their own Python scripts to handle the importing of data from external sources like bank statements.

Syntax and Feature Enhancements​

While the core accounting principles remain the same, Beancount v3 introduces some welcome flexibility to its syntax:

• More Flexible Currency Codes: The previous restrictions on the length and characters for currency names have been relaxed. Single-character currency symbols are now supported.
• Expanded Transaction Flags: Users can now use any capital letter from A to Z as a flag for transactions, allowing for more granular categorization.

Importantly, these changes are backward-compatible, so your existing Beancount v2 ledger files will work without any modifications.

The C++ Rewrite and Performance​

One of the long-term goals for Beancount has been a rewrite of its performance-critical components in C++. While this work is ongoing, the initial release of Beancount v3 does not include the C++-based core. This means that for now, the performance of v3 is comparable to v2. The C++ code remains in a separate development branch for future integration.

Migrating from v2 to v3​

For most users, the migration from Beancount v2 to v3 is relatively straightforward:

1. Ledger Files: No changes are needed for your .beancount files.
2. Installation: You will need to install the new, separate packages like beanquery and beangulp using pip.
3. Importer Scripts: If you have custom importers, you will need to update them to use the new beangulp API. This mainly involves changing the base class your importers inherit from and adjusting some method signatures.
4. Fava: The popular web interface for Beancount, Fava, has been updated to be compatible with v3. Ensure you have the latest version of Fava for a seamless experience.

In essence, Beancount v3 is a foundational release that streamlines the project's architecture, making it more modular and easier to maintain and extend in the long run. While it requires some adjustments to user workflows, especially around data importing, it sets the stage for the future development of this powerful accounting tool.

We're excited to announce the launch of Beancount.io's completely revamped website! After months of careful development and feedback from our amazing community, we've created a more intuitive, comprehensive, and resourceful hub for all your plain-text accounting needs.

A Fresh New Look​

Our rebranded homepage reflects our commitment to clarity and simplicity—the very principles that make plain-text accounting so powerful. With a clean, modern design that emphasizes usability, we've made it easier than ever to find exactly what you need. The new visual identity better represents our mission: making accounting accessible and transparent for everyone from hobbyists to financial professionals.

Expanded Documentation & Tutorials​

We've significantly expanded our documentation and tutorial sections to support users at every level:

• Getting Started Guide: A completely revamped onboarding experience for newcomers to plain-text accounting
• Interactive Tutorials: Step-by-step walkthroughs with real-world examples
• Advanced Topics: Detailed documentation on complex accounting scenarios, customizations, and integrations
• Command Reference: Comprehensive explanations of every command and option within Beancount
• Troubleshooting: Common issues and their solutions, contributed by our community experts

Each tutorial has been carefully crafted to take you from concept to implementation with practical examples you can apply to your own books immediately.

Resources for Better Accounting​

Beyond just explaining how to use Beancount, we've added resources to help you become better at accounting itself:

• Accounting Principles Library: Learn fundamental concepts like double-entry bookkeeping, accrual vs. cash accounting, and proper categorization
• Financial Reporting Templates: Ready-to-use templates for common reports like income statements, balance sheets, and cash flow statements
• Tax Preparation Guides: Country-specific resources to help with year-end tax preparation using Beancount data
• Industry-Specific Setups: Example configurations for freelancers, small businesses, and personal finance
• Community Showcase: Real-world examples (with sensitive data removed) showing how others organize their accounting systems

What's Next?​

This website refresh is just the beginning. We're committed to continually improving the Beancount experience based on your feedback. Coming soon:

• Additional integration tutorials for popular financial services
• Renovate beancount mobile apps
• More localized content for international users
• Expanded community forum for knowledge sharing
• Regular webinars on advanced accounting topics

We'd love to hear what you think about the new site! Share your feedback through our community channel.

Happy accounting!

The Beancount.io Team

We are thrilled to announce that as of May 1st, 2023, we will be reintroducing the free plan for new customers. This decision comes after making significant improvements to our platform and optimizing our resources in order to better serve all of our customers, both free and paid.

The free plan has always been an essential part of our vision to provide an accessible and user-friendly service for everyone. We believe that the changes we've made over the past months will allow us to deliver an even better experience for our users while maintaining the quality of service for our Pro plan customers.

New customers who register after May 1st, 2023, will have access to the Free plan.

Your support and loyalty have been instrumental in making this reintroduction of the free plan financially possible. It is through your contributions that we have been able to invest in our infrastructure and support systems, ensuring that we can continue to deliver the high-quality service you expect while also expanding access to our platform for new users. Your commitment to our vision has helped us grow and evolve, and we are truly grateful for your ongoing partnership. Together, we are building a thriving community and empowering users from all walks of life to achieve their goals.

If you have any questions or concerns, please don't hesitate to reach out to us. We are always here to listen to your feedback and address any issues you may have. Thank you for your continued support, and we look forward to providing you with the best service possible.