CloudPulse

CloudPulse is a FinOps-ready, multi-cloud cost analytics desktop app with an R/Shiny dashboard and a lightweight Python launcher. It is designed to help teams monitor spend, compare cloud providers, explore forecasts, and review optimization opportunities across AWS, Azure, and GCP.

What CloudPulse does

• Provides a unified dashboard for cloud financial visibility
• Supports multi-cloud and provider-specific views
• Includes forecasting and mock-data workflows for local testing
• Surfaces optimization recommendations and cost insights
• Ships with a desktop launcher that starts the Shiny app locally
• Includes RBAC-ready login, role visibility, and session handling

Key features

• Cloud cost and utilization monitoring and reporting
• Forecasting and trend analysis
• Provider and Kubernetes-focused views
• Role-based access control for dashboard navigation
• Desktop-friendly startup flow via Python launcher
• Documentation for setup, RBAC, testing, and deployment

Project structure

• lib/ — main app logic, UI, and R modules
• api/ — API and middleware files
• setup/ — installation and environment configuration scripts
• docs/ — OS setup, RBAC, testing, and integration guides
• build/ and dist/ — packaged artifacts and local build outputs

Screenshots

Mock data only for demo visuals.

Quick start

Prerequisites

• R 4.4 or newer recommended
• Python 3 with pip
• Access to the repo and a writable local package library

1. Clone the repository

git clone https://github.com/kj851/CloudPulse.git
cd CloudPulse

2. Install Python requirements

python3 -m pip install -r setup/requirements.txt

3. Install R dependencies

On Linux/macOS:

bash setup/install_R_packages.sh
bash setup/install-deps.sh

On Windows, use the R script directly:

Rscript setup/install_R_packages.R

4. Launch the app

Desktop launcher:

python3 lib/app_launcher.py

Or run the Shiny app directly from R:

library(shiny)
source("lib/FInOpsApp.R")
shinyApp(ui, server)

Demo access

For the RBAC-enabled flow, use the built-in demo users documented in README_START_HERE.md and QUICK_REFERENCE.md.

Typical demo credentials:

• admin / admin_password
• analyst / analyst_password
• devops / devops_password
• viewer / viewer_password

Documentation map

• README_START_HERE.md — recommended starting point
• QUICK_REFERENCE.md — fast walkthrough and demo steps
• ARCHITECTURE.md — system and data-flow overview
• docs/APP_SETUP_WINDOWS.md — Windows setup instructions
• docs/APP_SETUP_MAC.md — macOS setup instructions
• docs/APP_SETUP_UBUNTU.md — Ubuntu setup instructions
• docs/RBAC_QUICK_START.md — RBAC quick setup
• docs/TESTING_GUIDE.md — manual validation walkthrough

Contributing

Contributions are welcome. Please open an issue or submit a pull request with a clear description of the change and any validation notes.

License

This project is licensed under the BSD 3-Clause License. See LICENSE for details.

Support

For support, please open a GitHub issue in this repository or contact the project maintainer.