📊 Smart CSV Analyzer & Predictor

A simple web app for exploring CSV files, generating insights, and testing ML predictions—all from your browser

🎥 Watch Demo • 📖 Documentation

✨ Features

📤 File Upload

• Upload CSV files (up to 50MB)
• Real-time upload progress
• Automatic file validation

📈 Data Insights

• Dataset overview (rows, columns, size)
• Data quality scoring
• Missing values detection
• Column type analysis

📊 Interactive Charts

• Universal chart builder
• Multiple visualization types
• Real-time data exploration

🤖 ML Predictions

• Test predictions with custom inputs
• Model confidence scores
• Live prediction results

🔄 Real-time Updates

• WebSocket progress tracking
• Live logs and status updates
• Instant feedback on operations

---

Quick Start

Prerequisites

Make sure you have these installed:

• Node.js (v18 or higher)
• Python (3.12 or higher)
• pnpm (recommended) or npm

1️⃣ Clone & Setup

git clone https://github.com/grimmy-dev/assessment2.git
cd assessment2

2️⃣ Install Dependencies

# Install frontend dependencies
pnpm install

3️⃣ Start the Application

Option 1: Run Everything (Recommended)

pnpm run dev:full

Option 2: Run Separately

# Terminal 1: Backend
pnpm run fastapi-dev

# Terminal 2: Frontend
pnpm run dev

4️⃣ Open Your Browser

• Main App: http://localhost:3000
• Debug API: http://localhost:8000/docs

---

📁 Project Structure

assessment2/
├── 📂 data/                   # Sample CSV files
│   └── testing_dataset.csv    # Ready-to-use sample data
├── 📂 src/
│   ├── 📂 api/                 # FastAPI backend
│   │   ├── routes/            # API routes
│   │   └── main.py            # Main endpoint
│   │
│   └── 📂 app/                # Next.js frontend
│       ├── components/        # React components
│       ├── pages/             # App pages
│       └── styles/            # CSS & styling
├── package.json               # Frontend dependencies
├── requirements.txt           # Python dependencies
└── README.md                  # This file

---

🛠️ Technology Stack

---

🎯 How to Use

---

---

---

💡 Try It Now

Don't have a CSV file? No problem! Use our sample dataset:

📁 /data/testing_dataset.csv

This file is perfect for exploring all features of the application.

---

📋 Available Scripts

Command	Description
pnpm run dev:full	Start both frontend and backend
pnpm run dev	Start frontend only
pnpm run fastapi-dev	Start backend only
pnpm run build	Build for production
pnpm run lint	Run code linting

---

🤝 Contributing

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit-m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

🆘 Need Help?

• 🐛 Found a bug? Open an issue
• 💡 Have a suggestion? Start a discussion

---

Made with ❤️ for data enthusiasts

⭐ Star this repo if you found it helpful!