Skip to content

daxmu92/CicadaFinScape

Repository files navigation

🦋 Cicada Financial Scape

GitHub Workflow Status

🌟 Overview

Cicada Financial Scape is a powerful and intuitive financial management tool designed to help you track, analyze, and visualize your personal finances. Built with Python and Streamlit, this application offers a seamless experience for managing your assets, income, expenses, and overall financial health.

✨ Features

  • 📊 Asset Management: Easily track and categorize your assets across multiple accounts.
  • 💰 Income and Expense Tracking: Monitor your cash flow with detailed income and expense records.
  • 📈 Profit and Loss Analysis: Visualize your financial performance over time with interactive charts.
  • 🏦 Account Overview: Get a comprehensive view of all your accounts and their respective assets.
  • 📅 Historical Data: Keep track of your financial journey with historical data storage and analysis.
  • 🔄 Data Import/Export: Seamlessly import and export your financial data for backup or migration.

🚀 Getting Started

Prerequisites

  • Python 3.10 or higher
  • pip (Python package manager)

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/cicada-financial-scape.git
    cd cicada-financial-scape
    
  2. Install the required dependencies:

    pip install -r requirements.txt
    
  3. Run the Streamlit app:

    streamlit run Home.py
    

📚 Usage

  1. Home Page: Start by exploring your overall financial health and key metrics.
  2. Account: Manage your individual accounts and assets.
  3. Profit and Loss: Analyze your financial performance over time.
  4. Income and Expense: Track your cash flow and categorize transactions.
  5. Account Management: Set up and configure your accounts and asset categories.

🛠️ Technologies Used

  • Python: The core programming language.
  • Streamlit: For building the interactive web application.
  • Pandas: For data manipulation and analysis.
  • Plotly: For creating interactive and beautiful charts.
  • SQLite: For local data storage.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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