A local-first financial planning application for Monte Carlo retirement simulations, tax optimization, and AI-powered strategic advice.
Disclaimer: This system is for organizing information and exploring scenarios. Always consult licensed financial advisors, CPAs, and attorneys for actual decisions.
- Monte Carlo Simulations — 10,000-run projections with granular tax modeling
- AI Strategic Advisor — Personalized guidance via Gemini, Claude, OpenAI, and Local LLMs (Ollama, LM Studio).
- Tax Optimization — Roth conversion windows, withdrawal sequencing, RMD planning
- Income Stream Modeling — Pensions, Social Security, rental income with survivor benefits
- Real-time Dashboard — Adjust parameters and see immediate impact on success rates
- Roadmap & Life Events — Strategic planning for major life changes
- Action Item Tracking — Convert AI recommendations into executable tasks
# Install local git hooks (recommended)
./bin/setup-git-hooks
# Configure AI features (optional)
./bin/setup-api-keys
# Install/start RPS on macOS/Linux
./bin/install-app
# Open http://127.0.0.1:5137On Windows PowerShell:
.\bin\install-app.ps1Runs RPS via Docker + Redis, bound to 127.0.0.1 only:
docker compose up -dThen open http://127.0.0.1:5137.
On first boot, the container will:
- generate required secrets (persisted in the
rps_dataDocker volume) - run migrations
- seed the
demoaccount (login:demo/Demo1234)
You can also use the helper:
./bin/install-app- Docker Desktop (Windows/macOS) or Docker Engine + Compose v2 (Linux)
- Optional:
cloudflared(only needed for./bin/manage tunnel)
| Command | Description |
|---|---|
./bin/start |
Start RPS (Docker Compose + Redis) |
./bin/install-app |
Install Docker if needed, pull the RPS image, and start the Docker runtime |
.\bin\install-app.ps1 |
Windows PowerShell installer that installs Docker Desktop if needed and starts RPS |
./bin/docker-setup |
Compatibility wrapper for ./bin/install-app |
./bin/check-env-consistency |
Verify dev/prod dependency config is aligned |
./bin/check-no-secrets |
Scan tracked files for secret-like tokens |
./bin/check-repo-hygiene |
Block committing generated/local artifacts |
./bin/check-quality-gates |
Run CI-equivalent quality gates locally |
./bin/test [args...] |
Run full pytest suite (auto-creates ./venv if missing) |
./bin/release-gate |
Run local + production pre-deploy checks (recommended) |
./bin/setup-git-hooks |
Enable local pre-push hook checks (.githooks) |
sudo RPS_DOCKER_MODE=rootless ./bin/deploy-docker |
Deploy latest main to production (rootless Docker Compose) |
./bin/manage stop |
Stop the application |
./bin/manage status |
Check system health |
./bin/manage backup |
Backup SQLite database |
./bin/restore |
Restore from backup archive |
./bin/backup-data |
Create data-only backup |
./bin/backup-system |
Create system/config backup |
./bin/setup-backup-timer |
Configure scheduled automated backups |
./bin/bump-version <x.y.z> "<notes>" |
Update release version + cache-busting metadata |
./bin/manage tunnel |
Create secure public URL |
Use TBPD for releases:
- Test:
./bin/release-gate - Bump:
./bin/bump-version <x.y.z> "<notes>" - Push:
git push origin main - Deploy:
sudo RPS_DOCKER_MODE=rootless ./bin/deploy-docker
| Layer | Technology |
|---|---|
| Backend | Python/Flask with SQLite |
| Frontend | Vanilla JS, ES6 modules, Chart.js |
| AI | Multi-provider (Gemini, Claude, OpenAI, Local LLMs) |
| Storage | Local SQLite (data/planning.db) |
| Security | AES-256-GCM encryption, bcrypt, rate limiting |
- Quick Start Guide
- Developer Guide
- Admin System
- Deployment
- Portable Docker Install
- Security
- Backup & Restore
The following variables are used for system-level configuration or testing. User API keys should be configured via the Web UI for security.
| Variable | Purpose |
|---|---|
GEMINI_API_KEY |
Google Gemini API access (Fallback/Test) |
ANTHROPIC_API_KEY |
Claude API access (Fallback/Test) |
SECRET_KEY |
Flask session encryption |
ENCRYPTION_KEY |
Data encryption (required in production) |
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
Version: 3.10.16 | Last Updated: 2026-06-29