Skip to content

harsh16coder/Your_Personal_Accountant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💰 Your Personal Accountant

A comprehensive AI-powered personal finance management application featuring an intelligent chatbot, advanced payment systems, real-time updates, and multi-model LLM support. Built with React frontend and Flask backend, integrated with Cerebras Cloud for intelligent financial assistance.

Build Status License: MIT React Flask Python

🌟 Key Features

🤖 AI-Powered Financial Assistant

  • Natural Language Processing for intuitive communication
  • Multi-Model LLM Support (Cerebras AI models)
  • User-Configurable API Keys
  • Intelligent Expense Recording and Trade Logging
  • Personalized Financial Guidance
  • Security-First Design with prompt injection protection

💳 Advanced Payment Management

  • Flexible payment options (full payoff, partial, installments)
  • Payment progress tracking with accurate calculations
  • Multiple payment methods (chatbot or manual interface)
  • Dynamic payment validation
  • Complete transaction history

📊 Comprehensive Financial Dashboard

  • Real-time overview of assets, liabilities, and net worth
  • Asset management (savings, investments, properties)
  • Smart liability tracking with priority scoring
  • AI-generated financial recommendations

📚 Documentation

🚀 Quick Start

Prerequisites

  • REACT
  • Python (v3.8 or higher)
  • npm or yarn
  • Cerebras AI API Key - Get yours here

Installation

  1. Clone the repository
git clone https://github.com/harsh16coder/Your_Personal_Accountant.git
cd Your_Personal_Accountant
  1. Backend Setup
cd backend
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your configurations
python app.py
  1. Frontend Setup
cd frontend
npm install
npm start
  1. Access the Application

🛠️ Technology Stack

Frontend: React 18.2.0, Tailwind CSS, React Router, Axios
Backend: Flask 2.3.2, SQLite, Flask-CORS, JWT
AI Integration: Cerebras Cloud SDK

See ARCHITECTURE.md for detailed technical information.

📖 Usage Examples

AI Chatbot Commands

💬 "I spent $15 on lunch at Chipotle today"
📈 "I bought 10 shares of AAPL at $150"
💳 "Pay off my credit card completely"
💡 "Help me understand my budget"

See FEATURES.md for complete usage guide.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🙏 Acknowledgments


Made with ❤️ for better financial management

🌐 Website📧 Email🐛 Issues

⭐ Star this repository if it helped you manage your finances better!

About

A comprehensive AI-powered personal finance management platform

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •