Metadata-Version: 2.4
Name: hephaestus-pro
Version: 1.0.0
Summary: Bloomberg-style Financial Intelligence Terminal powered by AI
Home-page: https://github.com/AshrafGalibShaik/Hephaestus
Author: Ashraf Galib Shaik
License: MIT
Keywords: finance terminal bloomberg cli dashboard ai revenue
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: plotext>=5.2.8
Requires-Dist: pandas>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: openai>=1.0.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<p align="center">
  <br>
  <code>▉ H E P H A E S T U S ▉</code>
  <br><br>
  <em>Financial Intelligence Terminal</em>
  <br><br>
  <img src="https://img.shields.io/badge/Python-3.11+-1a1a2e?style=flat-square&logo=python&logoColor=f0a500" alt="Python">
  <img src="https://img.shields.io/badge/Terminal-Rich-1a1a2e?style=flat-square&logoColor=f0a500" alt="Rich">
  <img src="https://img.shields.io/badge/AI-Gemini-1a1a2e?style=flat-square&logo=google&logoColor=f0a500" alt="Gemini">
</p>

---

A Bloomberg-style CLI dashboard that transforms **any CSV** into actionable financial intelligence.  
Import your data. Get AI-powered revenue leak diagnostics. All from the terminal.

---

### Install

```
pip install hephaestus-pro
```

### Run

```
hephaestus
```

That's it. The interactive menu handles everything.

---

### What It Does

| Step | Description |
|:---|:---|
| **Import** | Feed any CSV — columns are auto-detected (numeric, categorical, currency) |
| **Analyze** | Engine identifies value, cost, loss columns and groups by categories |
| **Visualize** | Bloomberg-style terminal with responsive P&L charts |
| **Diagnose** | Gemini AI generates CRO-level revenue leak recommendations |

---

### Structure

```
hephaestus/
├── cli.py          Entry point — interactive terminal menu
├── main.py         Bloomberg dashboard renderer
├── analyzer.py     Auto-detecting universal data analyzer
├── ai_engine.py    Gemini AI integration
├── import_data.py  Universal CSV importer
└── database.py     SQLite connection manager
```

---

### AI Configuration

Place a `.env` file in the `hephaestus/` directory, your working directory, or `~/.hephaestus/`:

```
GOOGLE_API_KEY=your_key
```

The dashboard renders with or without AI — static insights are generated as fallback.

---

### Commands

| Command | Description |
|:---|:---|
| `hephaestus` | Launch the interactive terminal |
| `python -m hephaestus.cli` | Alternative entry point |

---

<p align="center">
  <sub>Built with <a href="https://github.com/Textualize/rich">Rich</a> · <a href="https://github.com/piccolomo/plotext">Plotext</a> · <a href="https://ai.google.dev/">Google Gemini</a></sub>
</p>
