* [AI] Add API methods to budget a category from its templates applyCategoryTemplate runs the same budget/apply-single-template handler as the "Overwrite with template" item in a category's budget menu. getCategoryTemplateAmount runs budget/dry-run-category-template, which the budget automations editor uses for its preview. It reads the category's saved templates rather than the ones open in the editor. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> * [AI] Throw from the template dry run when the templates fail validation dryRunCategoryTemplate ignored the errors computeTemplates collects, so a category whose templates fail validation, for example with two #goal lines, was previewed as 0. It now throws with those errors. The automations editor already catches a failed dry run. getCategoryTemplateAmount rethrows the error as an APIError. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> * [AI] Return the template dry run's validation errors instead of throwing Throwing from dryRunCategoryTemplate surfaced as an internal error in the budget automations editor, for example when "Cover schedule" is picked before a schedule is chosen. The dry run now returns the errors computeTemplates collects alongside the amounts, and getCategoryTemplateAmount throws an APIError when there are any. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> * [AI] Reject category templates that fail to parse in the template API methods A #template line that fails to parse is stored as an error template, which the template runner skips, so applying could budget 0 and report success. applyCategoryTemplate and getCategoryTemplateAmount now throw with the failing lines instead. The UI's apply paths are left unchanged. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> * [AI] Format the template API test Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> * [AI] Read category templates for the template API without storing them The template preview parsed the category's note by storing its templates in goal_def first, so a read wrote to the budget. It now parses the note in memory, and applying stores the templates once, inside apply-single-template. * [AI] Type the template API test's goal_def query --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Getting Started
Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting.
If you are interested in contributing, or want to know how development works, see our contributing document we would love to have you.
Want to say thanks? Click the ⭐ at the top of the page.
Key Links
- Actual discord community.
- Actual Community Documentation
- Frequently asked questions
Installation
There are four ways to deploy Actual:
- One-click deployment via PikaPods (~2.00 $/month) - recommended for non-technical users
- Managed hosting via Fly.io (~1.50 $/month)
- Self-hosted by using a Docker image
- Local-only apps - downloadable Windows, Mac and Linux apps you can run on your device
Learn more in the installation instructions docs.
Ready to Start Budgeting?
Read about Envelope budgeting to know more about the idea behind Actual Budget.
Are you new to budgeting or want to start fresh?
Check out the community's Starting Fresh guide so you can quickly get up and running!
Are you migrating from other budgeting apps?
Check out the community's Migration guide to start jumping on the Actual Budget train!
Documentation
We have a wide range of documentation on how to use Actual, this is all available in our Community Documentation, this includes topics on Budgeting, Account Management, Tips & Tricks and some documentation for developers.
Contributing
Actual is a community driven product. Learn more about contributing to Actual.
Code structure
The Actual app is split up into a few packages:
- loot-core - The core application that runs on any platform
- desktop-client - The desktop UI
- desktop-electron - The desktop app
More information on the project structure is available in our community documentation.
Feature Requests
Current feature requests can be seen here. Vote for your favorite requests by reacting 👍 to the top comment of the request.
To add new feature requests, open a new Issue of the "Feature Request" type.
Translation
Make Actual Budget accessible to more people by helping with the Internationalization of Actual. We are using a crowd sourcing tool to manage the translations, see our Weblate Project. Weblate proudly supports open-source software projects through their Libre plan.
Sponsors
Thanks to our wonderful sponsors who make Actual Budget possible!
