███╗ ██╗ ███████╗ ██╗ ██╗ ██████╗ ██████╗ █████╗
████╗ ██║ ██╔════╝ ╚██╗██╔╝ ██╔═══██╗ ██╔══██╗ ██╔══██╗
██╔██╗ ██║ █████╗ ╚███╔╝ ██║ ██║ ██████╔╝ ███████║
██║╚██╗██║ ██╔══╝ ██╔██╗ ██║ ██║ ██╔══██╗ ██╔══██║
██║ ╚████║ ███████╗ ██╔╝ ██╗ ╚██████╔╝ ██║ ██║ ██║ ██║
╚═╝ ╚═══╝ ╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝
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.
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 dataset (supporting CSV, Excel, Parquet, JSON, JSONL, TSV, HTML, XML, Feather, ORC, Stata, SAS, SPSS, SQL, Pickles, HDF5, and 100+ more formats), 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, export trained models (.joblib), and deploy production-ready prediction API endpoints secured by unique API keys. Nexora also includes a structured community feedback and research contribution system for students, researchers, testers, and administrators. See COMMUNITY_GUIDELINES.md.
[] Interactive CLI Wizard - Same 9-stage workflow as web, no browser needed
[] Full Terminal Access - nexora train, nexora predict, nexora explain, nexora cluster, nexora forecast
[] Python Library - Import Nexora in scripts for automation
[] 100+ Data Formats - CSV, Excel, Parquet, SQL, MongoDB, S3, Google Sheets, scikit-learn datasets
[] 6 ML Families - Linear, Tree-based, Boosting (XGB/LGBM/CatBoost), Neural Networks, Ensemble
[] Auto Preprocessing - Missing imputation, encoding, scaling, outlier handling, deduplication
[] SHAP Explanations - Feature importance, what-if analysis, decision drivers
[] Deployment - FastAPI, Flask, Streamlit, Docker, Jupyter export
You can install the Nexora Python package directly via pip:
pip install nexora-predictionnexora # Interactive wizard
nexora train data.csv --target revenue # Train models
nexora predict model.nx new_data.csv # Make predictions
nexora explain model.nx # Feature importance
nexora serve model.nx --port 8000 # REST APINo web browser required. Everything in the terminal! See CLI_FEATURES.md for all commands.
| Component | URL | Host Provider |
|---|---|---|
| Frontend Web App | nexoraprediction.netlify.app | Netlify |
| Backend API | nexora-360r.onrender.com | Render |
| API Documentation | 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.
The diagram below outlines the end-to-end data flow, processing components, and communication layers in Nexora:
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
- Automated Multi-Format Validation - Handles CSV, Excel, Parquet, JSON, and 100+ tabular file formats. Formats columns, assesses size boundaries, and verifies 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.
- Type Parsing - Separates numerical parameters, categorical labels, datetimes (with enhanced Unix timestamp detection), 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.
- 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.
- 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.
- Model Export - Easily download compiled
.joblibmodel artifacts for offline use. - 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.
- Admin Dashboard - Dedicated interface to monitor system health, audit logs, and user activity.
- User Management & Profiles - Full user authentication flows (Login/OTP), profile avatars, and public profile pages.
- Dataset & Content Moderation - Admin controls for overseeing deployed models and data assets.
- API Key Rotation - Secure management and rotation of API keys directly within the production UI.
- Structured Feedback System - Users can submit bugs, feature requests, dataset feedback, research notes, UI issues, and performance reports.
- Contributor Reputation - Profiles include contribution scores, badges, administrator stars, implemented suggestions, and progression levels.
- Admin Review Workflow - Admins can reply, star, pin, prioritize, mark duplicate, award badges, and move feedback through review states.
- Community Leaderboard - Contributor rankings surface top testers, researchers, feedback authors, and bug reporters.
Community participation standards are available in COMMUNITY_GUIDELINES.md.
| 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) |
| Dependency | Minimum Version |
|---|---|
| Python | 3.11 or higher |
| Node.js | 20 or higher |
| npm | 10 or higher |
| Ollama | Latest (optional, for grounded Q&A) |
git clone https://github.com/jeet2005/Nexora.git
cd Nexoracd 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.pyThe backend service will be available at http://localhost:8000. You can test endpoints on Swagger UI at http://localhost:8000/docs.
cd ../frontend
npm install
cp .env.example .env.local
# Run development server
npm run devThe React frontend application will be active at http://localhost:5173.
Run the entire stack (FastAPI, React, and MongoDB) with a single command:
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
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
To enable the dataset assistant using a local LLM instance:
- Download and install Ollama.
- Pull the default micro-LLM model in your terminal:
ollama pull phi3:mini
- Keep Ollama active in the background. The assistant will detect local hosting at
http://localhost:11434and enable custom educational conversations.
- 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.
Contributions are welcome. Please read our Contributing Guidelines to understand branch conventions, pull request structures, and developer standards. Ensure all contributions align with our Code of Conduct.
For vulnerability notifications, refer to our Security Policy.
Nexora is open-source software licensed under the MIT License.