monido

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in .github/workflows/docker.yml
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Track your net worth and cash flow, on your own or as a family. Self-hosted, entered by hand, no bank connections. Optional AI advisor via Claude.

README.md

English · Русский · Deutsch · Español · Français · Português · 中文

Monido logo

Monido

Track your net worth and cash flow, on your own or as a family. Self-hosted, entered by hand, no bank connections.

Latest release CI License: MIT Last commit Docker image Live demo MCP Registry

Website · Live demo · Quick start · Docs · Help build Monido · Releases

Try the live demo: a fictional family in a private copy for 15 minutes, nothing to install; the sign-in screen shows the password.

The Overview page in the light and the dark theme

Questions Monido answers

  • How much do we own, after debts? Accounts, investments, property and loans of every family member, in every currency, in one figure. Example
  • Did we get richer this year, or did prices and exchange rates move? Net worth over time, and its real growth after inflation in the currency you spend in. Example · formula
  • How much did we save ourselves, and how much grew on its own? Savings and the savings rate per month, and the growth beyond them. Example · formula
  • How long would we last without income? The emergency fund in months of spending. Example · formula
  • When do we reach our goals, and can we afford this? Goal dates from what you actually save; with the optional Claude advisor, a purchase or a loan weighed against your own numbers and sent to the family for a vote. Goals · A family decision

Quick start

You need Docker with Docker Compose v2.24 or newer (Linux, or Docker Desktop on macOS). In a new folder:

mkdir monido && cd monido
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. Server settings (port, address) go in an optional .env (.env.example, the full guide). To update: docker compose pull && docker compose up -d. Something not working? Troubleshooting.

What it needs: one container (Node and SQLite, no separate database server) for amd64 and arm64, so a Raspberry Pi or a NAS will do; under 60 MB of memory when idle (docker stats on the demo and a home installation, versions 1.2 to 1.4) and a 250 MB image.

The data is kept in a Docker volume named after the folder (monido_data); docker compose down -v would delete it, so never add -v. The demo has no Claude advisor or Telegram reminders and cannot download its database; your own installation has them.

Screens

Close month: the month's balances, income and expenses, account by account
Close month: once a month, saved as you type
Goals: what the family saves a month and when each goal is reached
Goals: dates from what you actually save, and what would move them
Financial health: indicators with their zones
Financial health: each figure with its threshold and its formula
Advisor: a family proposal with its consequences and the votes
Advisor (optional): a decision with its consequences, voted on by the family

Overview on a phone

How it works, and what it is not

Once a month the family enters each account's month-end balance and, if you want the cash-flow figures, the month's income and expenses; Close month checks that every account is filled in and then adds the month to the dashboard. Only closed months count, every figure is computed by the app from what was entered, and every formula is written down in Finance rules.

It is a good fit if you can run a container on a home server, a NAS or a VPS, the family's money sits in several banks, currencies and properties, and you want to see wealth and its direction rather than every purchase.

It is not a daily ledger, an envelope budget or a portfolio tracker with live prices, and it never connects to a bank or moves money. For a transaction-by-transaction ledger or budgets, look at Firefly III or Actual Budget; for live investment prices, at Ghostfolio.

Features

  • Net worth and cash flow: monthly history, allocation by owner, currency and asset type, income and expense categories, savings rates; balances alone are enough to start.
  • Loans and property: loan schedules, early-payment comparisons and property valuations.
  • Goals and financial independence: progress, forecasts, alternatives and the calculation behind each date.
  • Financial health: indicators with their thresholds and inputs; missing data is shown, never read as zero.
  • For the family: shared records, sign-in with a family password or per person through Telegram, rights per member, reminders and proposals in Telegram.
  • Self-hosting: backups and restore, all data exportable to CSV, change history with undo, multiple currencies, seven languages, light and dark themes.

Privacy and AI

Your data stays in the SQLite database on your server. The server itself sends out only a request for exchange rates (to Frankfurter, or to your own instance) and, once a day, the image name to check for updates (UPDATE_CHECK=off stops it); Telegram is contacted only if you turn it on. The core has no AI in it: the Claude advisor is off until you connect your own Claude account, and then your conversation and the numbers Claude asks for go to Anthropic through that account, never through the app.

Project status

Monido is young: its public history starts in November 2026, it has one maintainer, and it is released often (see Releases and the changelog). Updates keep your data: an existing database is checked on every start and never changed behind your back, and you can download a copy before updating. Five of the seven languages are machine translations awaiting review. What comes next is on the roadmap.

Where to get it

  • Docker Compose on any Linux server or Docker Desktop: see Quick start. The image is ghcr.io/stanislav-petryashov/monido (amd64 and arm64).
  • Unraid: search for Monido in Community Applications. It runs as the data folder's owner (PUID 99, PGID 100 by default).
  • PikaPods (managed hosting): not yet available. Vote for Monido to have it added.
  • Claude connector (MCP): listed in the official MCP Registry and on Glama.

Languages

The interface is in English, Russian, German, Spanish, French, Brazilian Portuguese and Simplified Chinese. The German, Spanish, French, Portuguese and Chinese texts are machine translations waiting for native speakers to review them. Corrections are welcome: see Translating.

Translation status

Translations are managed on Weblate: pick your language, fix or approve strings, and the changes come back to this repository as a pull request.

Documentation

  • Worked examples: seven household questions with fictional data, verification results and limits.
  • User guide: the pages, the monthly update and the settings.
  • Configuration: environment variables, sign-in modes and optional integrations.
  • Deployment: Docker, HTTPS behind a reverse proxy, updates and backups, the public demo.
  • Development: running from source, the commands and the screenshots.
  • Architecture: the code map, the data model and how-tos.
  • Finance rules: how each metric is calculated and judged.
  • Database schema: the current tables and compatibility rules.
  • Design system: tokens, components and rules for the interface.
  • Maintaining: the first public release and cutting a release.

Contributing

Contributions can be code, clearer documentation, translation fixes, accessibility improvements, calculation checks or reports from a real self-hosted installation.

Start with CONTRIBUTING.md for setup and contribution guidelines. Open an issue to report a problem; ask questions and discuss ideas, before a larger change too, in Discussions. Issues labelled good first issue are a small, self-contained way in. Interested in helping maintain an area over time? Tell us which part you use and would like to work on.

If Monido is useful to you, a star or a mention to someone who needs it helps the project.

Security

Login, sessions, throttling, the Content-Security-Policy and how to report a vulnerability privately: SECURITY.md.

License

MIT.

Yorumlar (0)

Sonuc bulunamadi