Wallos is an open-source, self-hostable web application designed for personal subscription management, offering an alternative to spreadsheets and paid financial software. It targets individuals seeking better control over their recurring expenses and financial habits, providing features for tracking, categorization, multi-currency support, and notifications.

How It Works

Wallos is built as a PHP web application, utilizing a SQLite database for data storage. It leverages external APIs for currency conversion (Fixer API) and optionally for AI-powered recommendations (ChatGPT, Gemini, Ollama). The application includes a suite of cron jobs for automated tasks like updating payment dates, exchange rates, and sending notifications. Its architecture emphasizes data privacy through self-hosting and offers extensive customization options for categories, currencies, and themes.

Quick Start & Requirements

• Baremetal: Requires NGINX or Apache, PHP 8.2 with curl, dom, gd, imagick, intl, openssl, sqlite3, zip modules. Cron jobs are essential for core functionality.
• Docker: docker run -d --name wallos -v /path/to/config/wallos/db:/var/www/html/db -v /path/to/config/wallos/logos:/var/www/html/images/uploads/logos -e TZ=Europe/Berlin -p 8282:80 --restart unless-stopped bellamy/wallos:latest
• Docker Compose: Configuration provided in the README.
• Demo: Available at https://demo.wallosapp.com/ with credentials demo/demo.

Highlighted Details

• AI Recommendations integration with ChatGPT, Gemini, or local Ollama.
• Supports multiple notification methods including Discord, Telegram, and webhooks.
• OIDC support for authentication with OAuth providers.
• Web-based logo search for subscriptions.

Maintenance & Community

The project has a Discord server for community interaction. Notable contributors are listed, and sponsorship is available via GitHub Sponsors.

Licensing & Compatibility

Licensed under GNU General Public License v3.0 (GPLv3), which mandates that derivative works must also be open-sourced under GPLv3. This may impose restrictions on linking with closed-source commercial applications.

Limitations & Caveats

The baremetal installation requires manual setup of PHP modules and cron jobs. The demo database is reset every two hours. The GPLv3 license may affect commercial use cases.