🥯 Bagels - TUI Expense Tracker
Powerful expense tracker that lives in your terminal.
Bagels expense tracker is a TUI application where you can track and analyse your money flow, with convenience oriented features and a complete interface.
Why an expense tracker in the terminal? I found it easier to build a habit and keep an accurate track of my expenses if I do it at the end of the day, instead of on the go. So why not in the terminal where it's fast, and I can keep all my data locally?
✨ Features
Some notable features include:
- Accounts, (Sub)Categories, Splits, Transfers, Records
- Templates for Recurring Transactions
- Add Templated Record with Number Keys
- Clear Table Layout with Togglable Splits
- Transfer to and from Outside Tracked Accounts
- "Jump Mode" Navigation
- Less and Less Fields to Enter per Transaction, Powered by Transactions and Input Modes
- Insights
- Customizable Keybindings and Defaults, such as First Day of Week
- Label, amount and category filtering
- Spending plottings / graphs with estimated spendings
- Budgetting tool for saving money and limiting unnecessary spendings
📦 Installation
Recommended: By UV
Bagels can be installed via uv on MacOS, Linux, and Windows.
uv is a single Rust binary that you can use to install Python apps. It's significantly faster than alternative tools, and will get you up and running with Bagels in seconds.
You don't even need to worry about installing Python yourself - uv will manage everything for you.
Unix / MacOS:
# install uv (package manager):
curl -LsSf https://astral.sh/uv/install.sh | sh
# restart your terminal, or run the following command:
source $HOME/.local/bin/env # or follow instructions
# install bagels through uv
uv tool install --python 3.13 bagels
uv can also be installed via Homebrew, Cargo, Winget, pipx, and more. See the installation guide for more information.
Windows:
# install uv:
winget install --id=astral-sh.uv -e
# then follow instructions to add uv to path
uv tool install --python 3.13 bagels
By Brew
brew install bagels
By Pipx
pipx install bagels
By Conda
conda install -c conda-forge bagels
By X-CMD
x install bagels
🥯 Usage:
bagels # start bagels
bagels --at "./" # start bagels with data stored at cd
bagels locate database # find database file path
bagels locate config # find config file path
It is recommended, but not required, to use "modern" terminals to run the app. MacOS users are recommended to use Ghostty, and Windows users are recommended to use Windows Terminal.
To upgrade with uv:
uv tool upgrade bagels
↔️ Migration
Please read the migration guide for migration from other services.
🛠️ Development setup
git clone https://github.com/EnhancedJax/Bagels.git
cd Bagels
uv run pre-commit install
mkdir instance
uv run bagels --at "./instance/" # runs app with storage in ./instance/
# alternatively, use textual dev mode to catch prints
uv run textual run --dev "./src/bagels/textualrun.py"
uv run textual console -x SYSTEM -x EVENT -x DEBUG -x INFO # for logging
Please use the black formatter to format the code.
🗺️ Roadmap
- Budgets (Major!)
- More insight displays and analysis (by nature etc.)
- Daily check-ins
- Pagination for records on monthly and yearly views.
- Importing from various formats
Backlog:
- "Processing" bool on records for transactions in process
- Record flags for future insights implementation
- Code review
- Repayment reminders
- Add tests
- Bank sync
Attributions
1 maintainer
Release files for Bagels 0.3.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bagels-0.3.12.tar.gz | 3.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bagels-0.3.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.8 MB
Release files / bagels-0.3.12.tar.gz
| Download URL | bagels-0.3.12.tar.gz |
|---|---|
| Size | 3.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3ebd4a727ddd62450528676a1ce3e475f92bd36edfed5f9c0b110bb24592608
|
|
BLAKE2b-256 checksum How to use checksums |
6e04e19a99e357221cb41e1e2f0352172e282ac8195fa2418b776345497fb260
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.19
|
Release files / bagels-0.3.12-py3-none-any.whl
| Download URL | bagels-0.3.12-py3-none-any.whl |
|---|---|
| Size | 167.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
533bf416be2b1c60230352762dc04222c9b68f293eba879f1350514451d216af
|
|
BLAKE2b-256 checksum How to use checksums |
242eaa99364cf180c499e02cc4f9d44b5ad35aadd5bf1957f8f035bd41dc235c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.19
|
