🌍 Try it live → — no install needed. (Free tier: the first visit after a quiet spell may take ~30s to wake.)
Estimate the money side of moving abroad. A landing page (/) offers two tools:
- Relocation calculator (
/relo) — compares cost of living, exchange rates, and projected monthly savings between two cities. - Take-home estimator (
/tax) — rough gross → net (after-tax) estimate by country.
FastAPI + server-rendered HTML. No database, no secrets, no API keys — cost data is scraped from Numbeo and FX is pulled from free public sources with automatic fallback.
Requires uv (it manages the Python 3.11+ toolchain).
uv sync
uv run uvicorn app.main:app --reload # or: ./run.shThen open http://localhost:8000.
docker build -t relo-calculator .
docker run -p 8000:8000 relo-calculator| Doc | What's in it |
|---|---|
| docs/ARCHITECTURE.md | App flow, the savings model, FX prediction (EMA blend + fallback chain), budget weights, the tax tool, data files, limitations |
| docs/TESTING.md | Test layers, coverage, how to run + pip-audit |
| docs/DEPLOYMENT.md | Free-tier hosting options, $PORT / health-check notes |
| docs/SECURITY_TEST.md | Security review — findings by CVSS band, mapped to OWASP Top 10 |
uv run pytest --cov # 172 tests, 100% coverageSee LICENSE.