Skip to content

AreefRasool/CodeWirePro

Repository files navigation

⚡ CodeWire Pro — Engineering Compliance Hub

CodeWire Pro is an all-in-one electrical engineering dashboard that turns manual cable-sizing and compliance calculations into an instant, visual, and shareable web app. Built with Gradio and Plotly, it brings together voltage drop analysis, wire sizing, conduit design, box fill, ampacity lookups, material estimation, and one-click executive PDF reports — all wrapped in a sleek, dark, glassmorphism-inspired interface with a live-updating KPI dashboard.

Whether you're a student validating textbook formulas or an engineer sanity-checking a quick design, CodeWire Pro gives you instant, visual feedback instead of spreadsheets and manual lookups.

Status Python Gradio


🎯 Features

  • ⚡ Voltage Drop Analysis — Calculates voltage drop, percentage loss, and a live engineering health score with a dynamic gauge chart.
  • 🔌 Wire Sizing — Recommends AWG wire size based on load current.
  • 📦 Conduit Design — Calculates conduit fill percentage and recommends conduit size with a bar chart.
  • 📐 Box Fill Calculator — Computes required box volume from conductors, devices, and grounds.
  • 🔥 Ampacity Lookup — Quick reference ampacity ratings for standard wire sizes.
  • 📋 Material Estimator — Estimates wire and conduit material requirements with a donut chart breakdown.
  • 📊 Executive Analytics — Compliance meter and auto-generated executive summary, side-by-side.
  • 📂 Project Manager — Save and reload multiple project calculations by name.
  • 📄 Executive PDF Reports — One-click professional PDF report generation using ReportLab.
  • 🎨 Modern UI — Glassmorphism dark theme with live-updating KPI dashboard cards.

📸 Preview

Hero Section & Live KPI Dashboard

Hero Dashboard

Executive Dashboard — Engineering Health Gauge

Executive Dashboard Gauge

⚡ Voltage Drop Analysis

Voltage Analysis

🔌 Wire Sizing

Wire Sizing

📦 Conduit Design

Conduit Design

📐 Box Fill Calculator

Box Fill

🔥 Ampacity Lookup

Ampacity

📋 Material Estimator

Material Estimator

📊 Executive Analytics — Compliance Meter & Summary

Executive Analytics

📄 Executive PDF Report Generation

PDF Report Generation


🖥️ Tech Stack

Tool Purpose
Gradio Web UI framework
Plotly Interactive charts (gauges, bar, pie)
ReportLab PDF report generation
Python 3.9+ Core logic

🚀 Getting Started

1. Clone the repository

git clone https://github.com/<your-username>/<repo-name>.git
cd <repo-name>

2. Install dependencies

pip install -r requirements.txt

3. Run the app

python codewire_pro.py

The app will launch locally and also generate a temporary public link (via Gradio's share=True).

💡 Running in Google Colab / Kaggle? Just upload codewire_pro.py, install dependencies with !pip install -r requirements.txt, and run the script — Gradio will give you a shareable public link.


🧠 How It Works

The app uses a simple engineering health-score model:

Health Score = 100 − (Voltage Drop % × 8)
  • Score ≥ 90 → ✅ PASS
  • Score 70–89⚠️ WARNING
  • Score < 70 → ❌ FAIL

Wire sizing follows standard AWG current-capacity tiers, and all calculations update the live dashboard KPI cards in real time.


📌 Future Improvements

  • Add user authentication for multi-user project storage
  • Export project history to Excel/CSV
  • Add support for 3-phase voltage drop calculations
  • Persist projects to a database instead of in-memory storage

👤 Author

Areef Rasool

BSAI Student | AI, Development & Networking Enthusiast


📄 License

This project is open-source and available under the MIT License.

Releases

No releases published

Packages

 
 
 

Contributors

Languages