Badget: Manage Household Finances with AI-Assisted Insights

Overview

Badget is a financial management web app designed to bring household finances together. It aims to help families and other shared households monitor spending, manage budgets, and make financial decisions using a unified dashboard and AI-oriented insights.

The project is a self-hostable application rather than a standalone budgeting library. Its architecture separates authentication from financial business logic, with household roles for controlling access. It may suit developers who want to explore or adapt a TypeScript financial app, as well as households willing to run and configure their own service.

Key Features

• Dashboard for viewing financial accounts and categorized spending.
• Budget creation and tracking, including budgeting based on spending patterns.
• AI-oriented spending analysis, recommendations, forecasts, and anomaly detection.
• Household accounts with Owner, Admin, Member, and Viewer roles.
• Financial goals, alerts, and health-oriented summaries.
• OAuth authentication and email-related capabilities within the application stack.
• Responsive interface built with Next.js, Shadcn/ui, and Tailwind CSS.

Use Cases

• A household can bring account and spending views together to review finances in one dashboard.
• A family can share budgeting responsibilities while limiting access by household role.
• A developer can use the project as a starting point for a custom finance-management web app.
• A self-hosting team can investigate AI-assisted budgeting and spending analysis in a TypeScript and PostgreSQL application.

Getting Started

Clone the repository and install dependencies:

git clone https://github.com/Codehagen/Badget.git
cd Badget
pnpm install

The app also needs environment configuration, authentication provider setup, and a database. See the README for setup details.

Considerations

• Running the application requires configuring a database and environment variables, including authentication providers; the README describes PostgreSQL and OAuth setup.
• AI features are presented as part of the product, but using the application requires completing its service configuration. Consult the project documentation for current requirements.
• AGPL-3.0 is a copyleft license. Review its terms before modifying or deploying the software, particularly for network-accessible services.
• The repository is active rather than archived, but repository activity alone does not establish production readiness or the completeness of financial integrations.