Monido
<p align="center">
<img src="docs/assets/logo.svg" width="64" height="64" alt="Monido logo">
</p>
<h1 align="center">Monido</h1>
<p align="center">
Track your net worth and cash flow — on your own or as a family. Self-hosted, entered by hand, no bank connections.
</p>
<p align="center">
<a href="https://github.com/stanislav-petryashov/monido/actions/workflows/docker.yml"><img src="https://img.shields.io/github/actions/workflow/status/stanislav-petryashov/monido/docker.yml?branch=master&label=CI" alt="CI"></a>
<a href="https://github.com/stanislav-petryashov/monido/releases/latest"><img src="https://img.shields.io/github/v/release/stanislav-petryashov/monido" alt="Latest release"></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/stanislav-petryashov/monido" alt="License: MIT"></a>
</p>
<p align="center">
<a href="https://demo.monido.dev">Live demo</a> · <a href="#quick-start">Quick start</a> · <a href="#documentation">Docs</a> · <a href="#contributing">Help build Monido</a> · <a href="https://github.com/stanislav-petryashov/monido/releases">Releases</a>
</p>
<p align="center">
<img src="docs/assets/screenshot.png" width="100%" alt="The Overview page in the light and the dark theme">
</p>
## Why Monido?
For people who want to understand their money month by month, on their own or together with a family.
- **Keep control of your data.** Run it on your own server, keep the database and backups, and choose which optional integrations to enable.
- **See the whole family's finances.** Bring accounts, investments, property and loans into one view, with amounts grouped by owner and currency.
- **Understand progress without connecting a bank.** Enter monthly balances and, optionally, income and expenses to see how your net worth and goals change. Daily transaction entry is not required.
## Features
- **Net worth and cash flow:** monthly history, asset allocation, income and expense categories, and savings rates. Track balances alone or include cash flow.
- **Monthly updates:** an autosaving Close month wizard; only closed months enter the dashboard's calculations.
- **Loans and property:** property valuations, loan schedules and early-payment comparisons.
- **Goals and financial independence:** progress, forecasts, alternative scenarios and explanations of the calculations.
- **Financial health:** indicators, their thresholds and the numbers behind them; incomplete data stays visible.
- **Optional Claude and Telegram integrations:** statement-assisted entry, financial questions, family proposals and reminders. The Advisor requires Telegram sign-in and HTTPS; these services are not needed for the core dashboard. Its MCP server is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.stanislav-petryashov/monido) as `io.github.stanislav-petryashov/monido`.
- **Built for self-hosting:** one Docker container and SQLite database, backups and restore, change history with supported undo operations, multiple currencies, English and Russian, light and dark themes.
## Worked examples
Explore [seven household finance use cases](docs/use-cases/README.md): wealth across currencies, net worth after debts, monthly savings, emergency reserves, savings goals, family decisions with the Advisor, and closing a month from bank statements through Claude. Each example includes fictional data, verification results and limits.
## Quick start
Want to look first? [Try the demo](https://demo.monido.dev): a fictional family, a private copy for 15 minutes, nothing to install. The sign-in screen shows the demo password. Changes affect only your temporary copy.
The demo does not include the Claude Advisor or Telegram reminders, and database downloads are disabled. Those features are available in your own installation. Please use fictional data in the demo.
You need Docker with Docker Compose v2.24 or newer (Linux, or Docker Desktop on macOS). In a new folder:
```bash
mkdir family-finance && cd family-finance
curl -fsSLO https://raw.githubusercontent.com/stanislav-petryashov/monido/master/docker-compose.yml
docker compose up -d
```
Open http://127.0.0.1:8080 within 15 minutes and set the family password. Manage Password or Telegram sign-in in the web UI; server settings (port, address) go in an optional `.env` ([`.env.example`](.env.example), [the full guide](docs/deploy-docker.md#installation)). To update: `docker compose pull && docker compose up -d`. Something not working? [Troubleshooting](docs/deploy-docker.md#troubleshooting).
The data is kept in a Docker volume named after the folder (`family-finance_data`); `docker compose down -v` would delete it, so never add `-v`.
## Documentation
- [User guide](docs/user-guide.md): the pages, the monthly update and the settings.
- [Configuration](docs/configuration.md): environment variables, sign-in modes and optional integrations.
- [Deployment](docs/deploy-docker.md): Docker, HTTPS behind a reverse proxy, updates and backups, the public demo.
- [Development](docs/development.md): running from source, the commands and the screenshots.
- [Architecture](docs/architecture.md): the code map, the data model and how-tos.
- [Finance rules](docs/finance-rules.md): how each metric is calculated and judged.
- [Database schema](docs/schema.md): the current tables and compatibility rules.
- [Design system](docs/design-system.md): tokens, components and rules for the interface.
- [Maintaining](docs/maintaining.md): the first public release and cutting a release.
## Contributing
Help make Monido useful to more households. Contributions can be code, clearer documentation, translation fixes, accessibility improvements, calculation checks or reports from a real self-hosted installation.
Start with [CONTRIBUTING.md](CONTRIBUTING.md) for setup and contribution guidelines. [Open an issue](https://github.com/stanislav-petryashov/monido/issues/new/choose) to report a problem or discuss an idea before a larger change. Interested in helping maintain an area over time? Tell us which part you use and would like to work on.
If the project is useful to you, a star or sharing it with someone who needs it is welcome too.
## Security
Login, sessions, throttling, the Content-Security-Policy and how to report a vulnerability privately: [SECURITY.md](SECURITY.md).
## License
[MIT](LICENSE).
TDQS
Scored across 20 tools
Most tools have clearly distinct purposes, and the descriptions explicitly differentiate overlapping paths such as save_account_lines vs. preview_statement and preview_proposal vs. propose_to_family. There is still some potential confusion between the many preview/commit and save/statement tools, but the boundaries are documented.
Tool names are consistently snake_case and almost all follow a verb_noun pattern: get_*, list_*, preview_*, commit_*, save_*, evaluate_*, propose_*, revise_*, withdraw_*. The only minor deviation is propose_to_family, but the overall convention remains predictable.
Twenty tools is slightly high, but the domain is genuinely broad: family overview, proposals, evaluations, statement filing, month closing, loans, and categories. Each tool appears to serve a specific workflow rather than duplicating another.
The surface covers the core advisory lifecycle: inspect family finances, evaluate purchases and goals, draft and manage proposals, file statements, close months, and add categories or loans. Minor gaps remain around editing/deleting existing goals, loans, or categories, but these may be intentional site-managed operations.