Multi-agent AI pipeline that takes any CSV/XLSX dataset and returns charts, statistics, and insights automatically.
Install these once on your machine before running anything:
| Tool | Version | Download |
|---|---|---|
| Python | 3.11 or later | https://www.python.org/downloads/ (check "Add Python to PATH") |
| Node.js | 18 or later | https://nodejs.org/ |
git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd YOUR_REPO
Ask the project owner to send you two files securely:
.envâ place it in the project root (same folder as the.batfiles)frontend\.envâ place it in the frontend folder
Open two separate terminal windows (or double-click the .bat files):
Terminal 1 â Backend:
start-backend.bat
Terminal 2 â Frontend:
start-frontend.bat
The bat files handle everything automatically: virtual environment creation, Python dependencies, and Node modules. First run takes ~2 minutes to download packages.
Go to â http://localhost:5173
DD PROJECT/
âââ backend/ # FastAPI Python backend
â âââ agents/ # AI pipeline agents
â â âââ architect.py # Dataset profiling
â â âââ statistician.py # Statistical analysis
â â âââ visualizer.py # Chart generation
â â âââ insights.py # LLM insights
â âââ core/ # Shared state, constants, utils
â âââ api.py # API endpoints
â âââ analysis_history.py # History DB operations
â âââ requirements.txt # Python dependencies
âââ frontend/ # React + Vite frontend
â âââ src/
â âââ pages/
â â âââ DataPulseDashboard.jsx
â â âââ Login.jsx
â âââ components/
â â âââ ErrorBoundary.jsx
â â âââ GlobeCanvas.jsx
â â âââ ParticleBackground.jsx
â âââ api.js
â âââ App.jsx
â âââ main.jsx
âââ start-backend.bat # One-click backend start
âââ start-frontend.bat # One-click frontend start
âââ .env # Secrets (NOT on GitHub â get from project owner)
| Problem | Fix |
|---|---|
Python not found |
Reinstall Python and check "Add Python to PATH" |
npm not found |
Install Node.js from nodejs.org |
.env file is missing |
Ask the project owner for the .env file |
| Backend crashes on start | Check the terminal output â usually a missing dependency |
| Charts not showing | Wait a few more seconds, the AI pipeline takes 5â15s |
| Port already in use | Close other terminals and try again |
