nexora-prediction 0.1.0__tar.gz

nexora_prediction-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jeet Patel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nexora_prediction-0.1.0/PKG-INFO

@@ -0,0 +1,327 @@
+Metadata-Version: 2.4
+Name: nexora-prediction
+Version: 0.1.0
+Summary: Autonomous predictive analytics from CSV to trained model and runnable code.
+Author: Jeet Patel
+License-Expression: MIT
+Project-URL: Homepage, https://nexoraprediction.netlify.app
+Project-URL: Repository, https://github.com/jeet2005/Nexora
+Project-URL: Issues, https://github.com/jeet2005/Nexora/issues
+Keywords: automl,machine-learning,predictive-analytics,data-science
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: scikit-learn>=1.3
+Requires-Dist: xgboost>=2.0
+Requires-Dist: lightgbm>=4.0
+Requires-Dist: catboost>=1.2
+Requires-Dist: optuna>=3.0
+Requires-Dist: shap>=0.44
+Requires-Dist: imbalanced-learn>=0.11
+Requires-Dist: jinja2>=3.1
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: tqdm>=4.65
+Requires-Dist: joblib>=1.3
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.31
+Requires-Dist: pyarrow>=14.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: seaborn>=0.12
+Requires-Dist: duckdb>=0.10.0
+Requires-Dist: evidently>=0.4.0
+Requires-Dist: huggingface_hub>=0.20.0
+Requires-Dist: gradio>=4.0.0
+Requires-Dist: marimo>=0.1.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: umap-learn>=0.5.0
+Requires-Dist: dvc>=3.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: mypy>=1.5; extra == "dev"
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Provides-Extra: sql
+Requires-Dist: sqlalchemy>=2.0; extra == "sql"
+Requires-Dist: psycopg2-binary>=2.9; extra == "sql"
+Provides-Extra: mongo
+Requires-Dist: pymongo>=4.5; extra == "mongo"
+Provides-Extra: cloud
+Requires-Dist: boto3>=1.34; extra == "cloud"
+Requires-Dist: gspread>=5.12; extra == "cloud"
+Provides-Extra: ui
+Requires-Dist: streamlit>=1.30; extra == "ui"
+Provides-Extra: llm
+Requires-Dist: ollama>=0.1; extra == "llm"
+Requires-Dist: openai>=1.0; extra == "llm"
+Provides-Extra: export
+Requires-Dist: weasyprint>=60.0; extra == "export"
+Requires-Dist: nbformat>=5.9; extra == "export"
+Provides-Extra: all
+Requires-Dist: nexora[cloud,export,llm,mongo,sql,ui]; extra == "all"
+Dynamic: license-file
+
+# Nexora
+
+An autonomous predictive analytics platform that profiles datasets, builds optimized preprocessing pipelines, trains reproducible model registries, runs batch predictions, monitors feature drift, and provides grounded AI educational interactive chats from a single CSV upload.
+
+---
+
+[![Backend CI](https://github.com/jeet2005/Nexora/actions/workflows/ci-backend.yml/badge.svg?branch=main)](https://github.com/jeet2005/Nexora/actions/workflows/ci-backend.yml)
+[![Frontend CI](https://github.com/jeet2005/Nexora/actions/workflows/ci-frontend.yml/badge.svg?branch=main)](https://github.com/jeet2005/Nexora/actions/workflows/ci-frontend.yml)
+[![GitHub stars](https://img.shields.io/github/stars/jeet2005/Nexora?style=social)](https://github.com/jeet2005/Nexora/stargazers)
+[![GitHub issues](https://img.shields.io/github/issues/jeet2005/Nexora)](https://github.com/jeet2005/Nexora/issues)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![Made with FastAPI](https://img.shields.io/badge/Made%20with-FastAPI-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)
+[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![scikit-learn](https://img.shields.io/badge/scikit--learn-5C9E48?logo=scikit-learn&logoColor=white)](https://scikit-learn.org/)
+[![XGBoost](https://img.shields.io/badge/XGBoost-1A4B8D?logo=xgboost&logoColor=white)](https://xgboost.ai/)
+[![LightGBM](https://img.shields.io/badge/LightGBM-00A8A1?logo=lightgbm&logoColor=white)](https://lightgbm.ai/)
+[![CatBoost](https://img.shields.io/badge/CatBoost-1F8E4B?logo=catboost&logoColor=white)](https://catboost.ai/)
+[![SHAP](https://img.shields.io/badge/SHAP-FF6F00?logo=shap&logoColor=white)](https://github.com/slundberg/shap)
+[![React](https://img.shields.io/badge/Frontend-React-61dafb?logo=react&logoColor=white)](https://reactjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Recharts](https://img.shields.io/badge/Recharts-181717?logo=recharts&logoColor=white)](https://recharts.org/)
+
+---
+
+## Why Nexora?
+
+Data scientists and developers often spend hours writing repetitive code for data profiling, exploratory analysis, preprocessing, model benchmarking, and production endpoint deployments. Nexora bridges this gap by serving as a unified prediction engine. 
+
+By uploading a single CSV dataset, developers can instantly audit dataset health, clean features, benchmark leading machine learning models side-by-side, analyze SHAP explainability insights, download compiled PDF reports, converse with a grounded AI dataset assistant, and deploy production-ready prediction API endpoints secured by unique API keys.
+
+---
+
+## Live Deployments
+
+| Component | URL | Host Provider |
+| :--- | :--- | :--- |
+| **Frontend Web App** | [nexoraprediction.netlify.app](https://nexoraprediction.netlify.app/) | Netlify |
+| **Backend API** | [nexora-360r.onrender.com](https://nexora-360r.onrender.com/) | Render |
+| **API Documentation** | [nexora-360r.onrender.com/docs](https://nexora-360r.onrender.com/docs) | Render |
+
+*Note: The backend API runs on Render's free tier and spins down after periods of inactivity. Please allow 30 to 60 seconds for the initial cold start when first accessing the application.*
+
+*Note: The educational assistant (Ollama integration) requires a local Ollama instance and is only active when running the application locally. See local setup guidelines below.*
+
+---
+
+## System Architecture
+
+The diagram below outlines the end-to-end data flow, processing components, and communication layers in Nexora:
+
+```mermaid
+graph TD
+    subgraph Client Layer
+        A[React Frontend]
+    end
+
+    subgraph Service API Layer
+        B[FastAPI Backend Gateway]
+        C[Dataset Analyzer & Validator]
+        D[Preprocessing Engine]
+        E[Training Manager & Registry]
+        F[SHAP Explainability Engine]
+        G[Grounded Chat Agent]
+        H[API Key Deployment Manager]
+    end
+
+    subgraph Storage & Compute
+        I[(Local Uploads / MongoDB)]
+        J[Local Ollama / Phi-3 Mini]
+        K[ML Models: XGBoost, CatBoost, LightGBM, Scikit-Learn]
+    end
+
+    A -->|Upload CSV & Configuration| B
+    B --> C
+    B --> D
+    B --> E
+    B --> F
+    B --> G
+    B --> H
+
+    C <-->|Read / Write Datasets| I
+    D <-->|Save Clean Pipelines| I
+    E <-->|Real-time Socket Updates| A
+    E <-->|Benchmark & Serialize| K
+    F -->|Render Report| I
+    G <-->|Dataset Context Queries| J
+    H <-->|Authorize Keys & Serves| K
+```
+
+---
+
+## Core Features
+
+### 1. Dataset Intelligence Engine
+* **Automated CSV Validation** - Formats columns, assesses size boundaries, and verifies tabular file integrity.
+* **Health Profiling** - Evaluates structural completeness, statistical anomalies, and generates per-column scorecards.
+* **Preview and Distributions** - Offers statistical summaries, skew metrics, and categorical balance diagnostics.
+
+### 2. Dynamic Preprocessing Pipelines
+* **Type Parsing** - Separates numerical parameters, categorical labels, datetimes, and identifier variables.
+* **Intelligent Preprocessing** - Implements missing values imputation, standard scaling, target-label encoding, outlier detection, and duplicate record cleaning.
+* **Interactive Configuration** - Provides controls to select prediction targets and customize individual preprocessing steps.
+
+### 3. Prediction Studio and Benchmarking
+* **Model Registry** - Supports multiple algorithms including XGBoost, CatBoost, LightGBM, and Scikit-Learn ensembles.
+* **Training Pipeline** - Executes cross-validation splits, train-test isolation, and hyperparameter parameter sweeps.
+* **WebSocket Leaderboard** - Streams active model training metrics and charts real-time scores directly to the UI.
+* **Comparison Arena** - Visualizes metrics, prediction drift charts, and latency histograms of trained models.
+
+### 4. Interactive Data Visualization
+* **Multi-Chart Dashboard** - Displays numerical trends, categorical patterns, and completeness heatmaps.
+* **Data Health Visualization** - Compiles data quality stats, missing records rates, and unique features counts.
+* **Correlation Insights** - Flags linear dependencies, high associations, and outlier counts.
+
+### 5. Production Suite
+* **API Endpoints** - Deploys production-grade prediction endpoints secured by custom API keys.
+* **Batch Processing** - Enables bulk uploads to retrieve fully enriched output prediction sheets.
+* **Drift Detection** - Compares historical prediction request signatures to highlight potential target concept drift.
+* **Grounded LLM Chat** - Integrates local Ollama models (Phi-3 Mini) to act as a database context tutor answering questions regarding data distribution trends.
+
+---
+
+## Technical Stack
+
+| Layer | Technologies |
+| :--- | :--- |
+| **Frontend Web App** | React 18, Vite, TypeScript, Tailwind CSS, Framer Motion, Recharts, Axios, Lucide Icons |
+| **Backend Service API** | Python 3.11, FastAPI, Uvicorn, Pydantic, Pandas, NumPy, Scikit-learn, CatBoost, LightGBM, XGBoost |
+| **Data Persistence** | MongoDB Atlas / Local File Storage |
+| **Local LLM Integration** | Ollama Engine (Phi-3 Mini) |
+| **Infrastructure Platforms** | Netlify (Frontend), Render (Backend) |
+
+---
+
+## Local Development
+
+### Installation Prerequisites
+
+| Dependency | Minimum Version |
+| :--- | :--- |
+| Python | 3.11 or higher |
+| Node.js | 20 or higher |
+| npm | 10 or higher |
+| Ollama | Latest (optional, for grounded Q&A) |
+
+### Development Option 1: Standard Installation
+
+#### 1. Clone the Project
+```bash
+git clone https://github.com/jeet2005/Nexora.git
+cd Nexora
+```
+
+#### 2. Configure Backend Service
+```bash
+cd backend
+python -m venv .venv
+
+# Activate Virtual Environment (Windows)
+.venv\Scripts\activate
+
+# Activate Virtual Environment (macOS / Linux)
+source .venv/bin/activate
+
+# Install dependencies and setup configuration
+pip install -r requirements.txt
+cp .env.example .env
+
+# Run development server
+python run.py
+```
+The backend service will be available at `http://localhost:8000`. You can test endpoints on Swagger UI at `http://localhost:8000/docs`.
+
+#### 3. Configure Frontend Application
+```bash
+cd ../frontend
+npm install
+cp .env.example .env.local
+
+# Run development server
+npm run dev
+```
+The React frontend application will be active at `http://localhost:5173`.
+
+---
+
+### Development Option 2: Docker Compose Setup
+
+Run the entire stack (FastAPI, React, and MongoDB) with a single command:
+
+```bash
+docker compose up --build
+```
+
+* **Frontend Web App**: Access at `http://localhost:3000`
+* **Backend API**: Access at `http://localhost:8000`
+* **MongoDB Instance**: Running on port `27017`
+
+---
+
+### Development Option 3: Makefile Shortcuts
+
+If you have Make installed, you can orchestrate development commands directly from the project root:
+
+* Install all package dependencies: `make install`
+* Launch backend locally: `make dev-backend`
+* Launch frontend locally: `make dev-frontend`
+* Run backend pytest suite: `make test`
+* Format all file types: `make format`
+* Spin up Docker containers: `make docker-up`
+* Spin down Docker containers: `make docker-down`
+
+---
+
+## Grounded Q&A Assistant Setup (Optional)
+
+To enable the dataset assistant using a local LLM instance:
+
+1. Download and install [Ollama](https://ollama.com/).
+2. Pull the default micro-LLM model in your terminal:
+   ```bash
+   ollama pull phi3:mini
+   ```
+3. Keep Ollama active in the background. The assistant will detect local hosting at `http://localhost:11434` and enable custom educational conversations.
+
+---
+
+## Repository Roadmap
+
+- [ ] Add Pytest code coverage reports in the Backend CI pipeline.
+- [ ] Implement multi-file comparison dashboards within the Frontend page.
+- [ ] Add support for automated time-series forecasting hyperparameter tuning.
+- [ ] Integrate PostgreSQL database schema mappings for enterprise persistence layers.
+- [ ] Add REST API key rotation options inside the Production UI.
+- [ ] Create automated end-to-end integration tests using Playwright.
+
+---
+
+## Contributing and Governance
+
+Contributions are welcome. Please read our [Contributing Guidelines](CONTRIBUTING.md) to understand branch conventions, pull request structures, and developer standards. Ensure all contributions align with our [Code of Conduct](CODE_OF_CONDUCT.md).
+
+For vulnerability notifications, refer to our [Security Policy](SECURITY.md).
+
+---
+
+## License
+
+Nexora is open-source software licensed under the [MIT License](LICENSE).

nexora_prediction-0.1.0/README.md

@@ -0,0 +1,250 @@
+# Nexora
+
+An autonomous predictive analytics platform that profiles datasets, builds optimized preprocessing pipelines, trains reproducible model registries, runs batch predictions, monitors feature drift, and provides grounded AI educational interactive chats from a single CSV upload.
+
+---
+
+[![Backend CI](https://github.com/jeet2005/Nexora/actions/workflows/ci-backend.yml/badge.svg?branch=main)](https://github.com/jeet2005/Nexora/actions/workflows/ci-backend.yml)
+[![Frontend CI](https://github.com/jeet2005/Nexora/actions/workflows/ci-frontend.yml/badge.svg?branch=main)](https://github.com/jeet2005/Nexora/actions/workflows/ci-frontend.yml)
+[![GitHub stars](https://img.shields.io/github/stars/jeet2005/Nexora?style=social)](https://github.com/jeet2005/Nexora/stargazers)
+[![GitHub issues](https://img.shields.io/github/issues/jeet2005/Nexora)](https://github.com/jeet2005/Nexora/issues)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![Made with FastAPI](https://img.shields.io/badge/Made%20with-FastAPI-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)
+[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![scikit-learn](https://img.shields.io/badge/scikit--learn-5C9E48?logo=scikit-learn&logoColor=white)](https://scikit-learn.org/)
+[![XGBoost](https://img.shields.io/badge/XGBoost-1A4B8D?logo=xgboost&logoColor=white)](https://xgboost.ai/)
+[![LightGBM](https://img.shields.io/badge/LightGBM-00A8A1?logo=lightgbm&logoColor=white)](https://lightgbm.ai/)
+[![CatBoost](https://img.shields.io/badge/CatBoost-1F8E4B?logo=catboost&logoColor=white)](https://catboost.ai/)
+[![SHAP](https://img.shields.io/badge/SHAP-FF6F00?logo=shap&logoColor=white)](https://github.com/slundberg/shap)
+[![React](https://img.shields.io/badge/Frontend-React-61dafb?logo=react&logoColor=white)](https://reactjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Recharts](https://img.shields.io/badge/Recharts-181717?logo=recharts&logoColor=white)](https://recharts.org/)
+
+---
+
+## Why Nexora?
+
+Data scientists and developers often spend hours writing repetitive code for data profiling, exploratory analysis, preprocessing, model benchmarking, and production endpoint deployments. Nexora bridges this gap by serving as a unified prediction engine. 
+
+By uploading a single CSV dataset, developers can instantly audit dataset health, clean features, benchmark leading machine learning models side-by-side, analyze SHAP explainability insights, download compiled PDF reports, converse with a grounded AI dataset assistant, and deploy production-ready prediction API endpoints secured by unique API keys.
+
+---
+
+## Live Deployments
+
+| Component | URL | Host Provider |
+| :--- | :--- | :--- |
+| **Frontend Web App** | [nexoraprediction.netlify.app](https://nexoraprediction.netlify.app/) | Netlify |
+| **Backend API** | [nexora-360r.onrender.com](https://nexora-360r.onrender.com/) | Render |
+| **API Documentation** | [nexora-360r.onrender.com/docs](https://nexora-360r.onrender.com/docs) | Render |
+
+*Note: The backend API runs on Render's free tier and spins down after periods of inactivity. Please allow 30 to 60 seconds for the initial cold start when first accessing the application.*
+
+*Note: The educational assistant (Ollama integration) requires a local Ollama instance and is only active when running the application locally. See local setup guidelines below.*
+
+---
+
+## System Architecture
+
+The diagram below outlines the end-to-end data flow, processing components, and communication layers in Nexora:
+
+```mermaid
+graph TD
+    subgraph Client Layer
+        A[React Frontend]
+    end
+
+    subgraph Service API Layer
+        B[FastAPI Backend Gateway]
+        C[Dataset Analyzer & Validator]
+        D[Preprocessing Engine]
+        E[Training Manager & Registry]
+        F[SHAP Explainability Engine]
+        G[Grounded Chat Agent]
+        H[API Key Deployment Manager]
+    end
+
+    subgraph Storage & Compute
+        I[(Local Uploads / MongoDB)]
+        J[Local Ollama / Phi-3 Mini]
+        K[ML Models: XGBoost, CatBoost, LightGBM, Scikit-Learn]
+    end
+
+    A -->|Upload CSV & Configuration| B
+    B --> C
+    B --> D
+    B --> E
+    B --> F
+    B --> G
+    B --> H
+
+    C <-->|Read / Write Datasets| I
+    D <-->|Save Clean Pipelines| I
+    E <-->|Real-time Socket Updates| A
+    E <-->|Benchmark & Serialize| K
+    F -->|Render Report| I
+    G <-->|Dataset Context Queries| J
+    H <-->|Authorize Keys & Serves| K
+```
+
+---
+
+## Core Features
+
+### 1. Dataset Intelligence Engine
+* **Automated CSV Validation** - Formats columns, assesses size boundaries, and verifies tabular file integrity.
+* **Health Profiling** - Evaluates structural completeness, statistical anomalies, and generates per-column scorecards.
+* **Preview and Distributions** - Offers statistical summaries, skew metrics, and categorical balance diagnostics.
+
+### 2. Dynamic Preprocessing Pipelines
+* **Type Parsing** - Separates numerical parameters, categorical labels, datetimes, and identifier variables.
+* **Intelligent Preprocessing** - Implements missing values imputation, standard scaling, target-label encoding, outlier detection, and duplicate record cleaning.
+* **Interactive Configuration** - Provides controls to select prediction targets and customize individual preprocessing steps.
+
+### 3. Prediction Studio and Benchmarking
+* **Model Registry** - Supports multiple algorithms including XGBoost, CatBoost, LightGBM, and Scikit-Learn ensembles.
+* **Training Pipeline** - Executes cross-validation splits, train-test isolation, and hyperparameter parameter sweeps.
+* **WebSocket Leaderboard** - Streams active model training metrics and charts real-time scores directly to the UI.
+* **Comparison Arena** - Visualizes metrics, prediction drift charts, and latency histograms of trained models.
+
+### 4. Interactive Data Visualization
+* **Multi-Chart Dashboard** - Displays numerical trends, categorical patterns, and completeness heatmaps.
+* **Data Health Visualization** - Compiles data quality stats, missing records rates, and unique features counts.
+* **Correlation Insights** - Flags linear dependencies, high associations, and outlier counts.
+
+### 5. Production Suite
+* **API Endpoints** - Deploys production-grade prediction endpoints secured by custom API keys.
+* **Batch Processing** - Enables bulk uploads to retrieve fully enriched output prediction sheets.
+* **Drift Detection** - Compares historical prediction request signatures to highlight potential target concept drift.
+* **Grounded LLM Chat** - Integrates local Ollama models (Phi-3 Mini) to act as a database context tutor answering questions regarding data distribution trends.
+
+---
+
+## Technical Stack
+
+| Layer | Technologies |
+| :--- | :--- |
+| **Frontend Web App** | React 18, Vite, TypeScript, Tailwind CSS, Framer Motion, Recharts, Axios, Lucide Icons |
+| **Backend Service API** | Python 3.11, FastAPI, Uvicorn, Pydantic, Pandas, NumPy, Scikit-learn, CatBoost, LightGBM, XGBoost |
+| **Data Persistence** | MongoDB Atlas / Local File Storage |
+| **Local LLM Integration** | Ollama Engine (Phi-3 Mini) |
+| **Infrastructure Platforms** | Netlify (Frontend), Render (Backend) |
+
+---
+
+## Local Development
+
+### Installation Prerequisites
+
+| Dependency | Minimum Version |
+| :--- | :--- |
+| Python | 3.11 or higher |
+| Node.js | 20 or higher |
+| npm | 10 or higher |
+| Ollama | Latest (optional, for grounded Q&A) |
+
+### Development Option 1: Standard Installation
+
+#### 1. Clone the Project
+```bash
+git clone https://github.com/jeet2005/Nexora.git
+cd Nexora
+```
+
+#### 2. Configure Backend Service
+```bash
+cd backend
+python -m venv .venv
+
+# Activate Virtual Environment (Windows)
+.venv\Scripts\activate
+
+# Activate Virtual Environment (macOS / Linux)
+source .venv/bin/activate
+
+# Install dependencies and setup configuration
+pip install -r requirements.txt
+cp .env.example .env
+
+# Run development server
+python run.py
+```
+The backend service will be available at `http://localhost:8000`. You can test endpoints on Swagger UI at `http://localhost:8000/docs`.
+
+#### 3. Configure Frontend Application
+```bash
+cd ../frontend
+npm install
+cp .env.example .env.local
+
+# Run development server
+npm run dev
+```
+The React frontend application will be active at `http://localhost:5173`.
+
+---
+
+### Development Option 2: Docker Compose Setup
+
+Run the entire stack (FastAPI, React, and MongoDB) with a single command:
+
+```bash
+docker compose up --build
+```
+
+* **Frontend Web App**: Access at `http://localhost:3000`
+* **Backend API**: Access at `http://localhost:8000`
+* **MongoDB Instance**: Running on port `27017`
+
+---
+
+### Development Option 3: Makefile Shortcuts
+
+If you have Make installed, you can orchestrate development commands directly from the project root:
+
+* Install all package dependencies: `make install`
+* Launch backend locally: `make dev-backend`
+* Launch frontend locally: `make dev-frontend`
+* Run backend pytest suite: `make test`
+* Format all file types: `make format`
+* Spin up Docker containers: `make docker-up`
+* Spin down Docker containers: `make docker-down`
+
+---
+
+## Grounded Q&A Assistant Setup (Optional)
+
+To enable the dataset assistant using a local LLM instance:
+
+1. Download and install [Ollama](https://ollama.com/).
+2. Pull the default micro-LLM model in your terminal:
+   ```bash
+   ollama pull phi3:mini
+   ```
+3. Keep Ollama active in the background. The assistant will detect local hosting at `http://localhost:11434` and enable custom educational conversations.
+
+---
+
+## Repository Roadmap
+
+- [ ] Add Pytest code coverage reports in the Backend CI pipeline.
+- [ ] Implement multi-file comparison dashboards within the Frontend page.
+- [ ] Add support for automated time-series forecasting hyperparameter tuning.
+- [ ] Integrate PostgreSQL database schema mappings for enterprise persistence layers.
+- [ ] Add REST API key rotation options inside the Production UI.
+- [ ] Create automated end-to-end integration tests using Playwright.
+
+---
+
+## Contributing and Governance
+
+Contributions are welcome. Please read our [Contributing Guidelines](CONTRIBUTING.md) to understand branch conventions, pull request structures, and developer standards. Ensure all contributions align with our [Code of Conduct](CODE_OF_CONDUCT.md).
+
+For vulnerability notifications, refer to our [Security Policy](SECURITY.md).
+
+---
+
+## License
+
+Nexora is open-source software licensed under the [MIT License](LICENSE).

nexora_prediction-0.1.0/nexora/__init__.py

@@ -0,0 +1,11 @@
+"""Public package API for Nexora v0.1.0."""
+
+
+from nexora.core import Nexora
+from nexora.report import NexoraReport
+# Alias for backward compatibility
+NexoraPrediction = Nexora
+
+__all__ = ["DatasetProfile", "ModelResult", "Nexora", "NexoraReport", "NexoraPrediction"]
+
+__version__ = "0.1.0"

nexora_prediction-0.1.0/nexora/cli/__init__.py

@@ -0,0 +1,5 @@
+"""Nexora command line interface."""
+
+from nexora.cli.main import cli
+
+__all__ = ["cli"]

nexora_prediction-0.1.0/nexora/cli/main.py

@@ -0,0 +1,45 @@
+"""Click-based CLI for the Nexora MVP."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+
+from nexora import Nexora
+
+
+@click.group()
+def cli() -> None:
+    """Nexora predictive analytics CLI."""
+
+
+@cli.command()
+@click.argument("data_csv", type=click.Path(exists=True, dir_okay=False, path_type=Path))
+@click.option("--target", required=True, help="Target column to predict.")
+@click.option(
+    "--out",
+    "output_path",
+    type=click.Path(dir_okay=False, path_type=Path),
+    default=None,
+    help="Output .nx session path.",
+)
+@click.option(
+    "--max-models",
+    default=6,
+    show_default=True,
+    type=int,
+    help="Maximum number of MVP registry models to train.",
+)
+def train(data_csv: Path, target: str, output_path: Path | None, max_models: int) -> None:
+    """Train models from a CSV and save a Nexora session."""
+
+    report = Nexora(data_csv, target=target).run(max_models=max_models)
+    session_path = output_path or data_csv.with_suffix(".nx")
+    saved = report.save(session_path)
+
+    click.echo(f"Best model: {report.best_model} ({report.best_score_label}={report.best_score:.4f})")
+    click.echo(f"Saved session: {saved}")
+    click.echo("")
+    leaderboard = report.leaderboard.head(10)
+    click.echo(leaderboard.to_string(index=False))

nexora_prediction-0.1.0/nexora/codegen/__init__.py

@@ -0,0 +1,5 @@
+"""Standalone code generation."""
+
+from nexora.codegen.script import generate_script
+
+__all__ = ["generate_script"]