actual README

The project's README from github.com/actualbudget/actual. As one markdown file: README.md.

Actualbudget

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.

Installation

There are four ways to deploy Actual:

  1. One-click deployment via PikaPods (~2.00 $/month) - recommended for non-technical users
  2. Managed hosting via Fly.io (~1.50 $/month)
  3. Self-hosted by using a Docker image
  4. 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:

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 :+1: 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.

Translation status

Repo Activity

Alt

Sponsors

Thanks to our wonderful sponsors who make Actual Budget possible!

Deploys by Netlify Built with Depot Docker GitHub Anthropic

actual (actualbudget/actual)

Searching Database…

29.6K ·GitHub
Что это такое?Actual Budget — это локальное приложение для личных финансов, построенное вокруг метода конвертного бюджетирования. Оно полностью бесплатно и с открытым исходным кодом, написано на NodeJS и синхронизирует ваши изменения между устройствами.
Это десктопное приложение, которое я устанавливаю, или сервер, который я где-то запускаю?И то и другое: есть скачиваемые локальные приложения для Windows, Mac и Linux, а также компонент-сервер синхронизации, чтобы один и тот же бюджет был доступен вам на всех устройствах.
Как его запустить?Четыре способа развернуть: в один клик на PikaPods (рекомендуется для тех, кто не разбирается в технике), управляемый хостинг на Fly.io, самостоятельное размещение через Docker-образ или скачивание локального десктопного приложения.
Нужно ли что-то устанавливать перед использованием?Для обычного использования — ничего: локальные приложения самодостаточны, а для самостоятельного размещения нужен только Docker. Чтобы участвовать в разработке, потребуется NodeJS 22.18+ с Yarn 4.
Сколько это стоит — хостинг платный?Само приложение полностью бесплатно и с открытым кодом, без подписок. Платный только управляемый хостинг: примерно $2 в месяц на PikaPods и $1,50 в месяц на Fly.io — самостоятельное размещение через Docker и локальные приложения бесплатны.
Где на самом деле хранятся мои финансовые данные?Прежде всего на вашем own устройстве — приложение работает локально, а синхронизация лишь переносит изменения между устройствами, так что при самостоятельном размещении всё остаётся на инфраструктуре, которую контролируете вы.
Что такое конвертное бюджетирование — метод, на котором построен Actual?Actual создан вокруг подхода конвертного бюджетирования. В README есть ссылка на документ, объясняющий эту идею, а сообщество предлагает руководство Starting Fresh для тех, кто только начинает знакомиться с бюджетированием.
Я пользуюсь другим приложением для бюджета — могу перейти и сохранить свои данные?Да — сообщество поддерживает руководство Migration специально для тех, кто переходит с других приложений для бюджетирования, а также руководство Starting Fresh, если вы предпочитаете начать с нуля.
Нужен ли сервер, если я пользуюсь только одним устройством?Нет — локальные приложения работают целиком на вашем устройстве, а сервер синхронизации нужен только для переноса изменений между устройствами, когда их используется несколько.
На чём построен Actual внутри?NodeJS с фронтендом на TypeScript. Репозиторий разделён на loot-core (ядро приложения, работающее на любой платформе), desktop-client (десктопный интерфейс) и desktop-electron (десктопное приложение).
Size
642.3 MB
Stars
29.6K
Age
4y
Commits · 90 Days