Spaces:
Sleeping
Sleeping
| title: ChainForecast CRM | |
| emoji: 🔗 | |
| colorFrom: blue | |
| colorTo: green | |
| sdk: docker | |
| pinned: false | |
| license: mit | |
| # 🔗 ChainForecast CRM | |
| **AI-Powered Sales Forecasting + Customer Segmentation with Blockchain Logging** | |
| This Space provides a unified API for: | |
| - **Sales Forecasting** using Random Forest ML models | |
| - **Customer Segmentation** (RFM Analysis + K-Means Clustering) | |
| - **Blockchain Logging** - All forecasts are immutably logged on a private Ethereum testnet (Ganache) | |
| --- | |
| ## 🚀 Features | |
| - **CSV File Upload** → Automatic column detection (dates, sales, customer IDs) | |
| - **28-Day Sales Forecast** with historical trend analysis | |
| - **Customer Segmentation** into VIP, Regular, and At-Risk groups | |
| - **AI-Generated Recommendations** (powered by Groq/LangChain) | |
| - **Blockchain Audit Trail** - Every forecast is recorded on-chain with a transaction hash | |
| --- | |
| ## 📡 API Endpoints | |
| ### `POST /analyze` | |
| Upload a CSV file to run the full forecasting + CRM pipeline. | |
| **Parameters:** | |
| - `file` (required): CSV file | |
| - `date_col` (optional): Name of date column | |
| - `sales_col` (optional): Name of sales/revenue column | |
| - `id_col` (optional): Name of customer ID column | |
| - `category_col` (optional): Name of product category column | |
| **Response:** | |
| ```json | |
| { | |
| "meta": {...}, | |
| "forecast": { | |
| "status": "success", | |
| "metrics": {...}, | |
| "blockchain_status": "logged", | |
| "transaction_hash": "0xabc..." | |
| }, | |
| "segmentation": {...} | |
| } | |
| ``` | |
| ### `POST /log-forecast` | |
| Manually log a forecast to the blockchain (accepts structured JSON payload). | |
| ### `GET /latest-on-chain` | |
| Retrieve the most recent forecast logged on the blockchain. | |
| --- | |
| ## ⚙️ Configuration | |
| This Space requires the following **environment variables** (set in Settings → Repository Secrets): | |
| | Variable | Description | Example | | |
| |----------|-------------|---------| | |
| | `BLOCKCHAIN_URL` | URL of the Ganache blockchain node | `http://34.70.216.31:8545` | | |
| | `GROQ_API_KEY` | (Optional) API key for Groq LLM recommendations | `gsk_...` | | |
| --- | |
| ## 🛠️ Architecture | |
| ``` | |
| User → FastAPI (Hugging Face Space) | |
| ↓ | |
| [Forecast Engine] → Random Forest ML | |
| [CRM Engine] → RFM + Clustering + AI Recs | |
| ↓ | |
| [Blockchain Service] → Ganache (GCP VM) | |
| ↓ | |
| Smart Contract (Solidity) stores: | |
| - Domain/Dataset Name | |
| - Predicted Value (in cents) | |
| - Merkle Root (data hash) | |
| - Timestamp | |
| ``` | |
| --- | |
| ## 📦 Local Development | |
| ```bash | |
| # Install dependencies | |
| pip install -r requirements.txt | |
| # Set environment variables | |
| export BLOCKCHAIN_URL="http://34.70.216.31:8545" | |
| export GROQ_API_KEY="your_key_here" | |
| # Deploy the smart contract (one-time setup) | |
| python app/blockchain/deploy.py | |
| # Run the API | |
| uvicorn app.api.main:app --reload | |
| ``` | |
| --- | |
| ## 📄 License | |
| MIT | |
| --- | |
| **Built with:** FastAPI • Scikit-Learn • Web3.py • Solidity • LangChain • Groq | |