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 |