An AI Data Scientist for CSV Files
TableSage is an intelligent data analysis platform that automatically profiles, cleans, and builds ML models from CSV files. Upload your data and get instant insights, cleaning recommendations, automated ML models, and conversational data exploration.
✨ Automatic Data Profiling - Comprehensive statistics, correlations, and distributions
🧹 Smart Cleaning Suggestions - Detect missing values, outliers, dtype issues
🤖 LLM Schema Inference - Semantic understanding of your columns
📊 Automated ML Models - Classification and regression with performance metrics
💬 Chat Interface - Ask questions about your data in natural language
📈 Interactive Visualizations - Charts and plots for deeper insights
- FastAPI - Modern, fast web framework
- Pandas - Data manipulation and analysis
- scikit-learn - Machine learning models
- SHAP - Model explainability
- Pydantic - Data validation
- React + TypeScript - Type-safe UI components
- TailwindCSS - Modern styling
- React Query - State management and API integration
- Recharts - Data visualization
- Python 3.9+
- Node.js 16+
- npm or yarn
# Navigate to backend directory
cd backend
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the server
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000Backend will be available at: http://localhost:8000
API Documentation: http://localhost:8000/docs
# Navigate to frontend directory
cd frontend
# Install dependencies
npm install
# Start development server
npm run devFrontend will be available at: http://localhost:5173
TableSage/
├── backend/
│ ├── app/
│ │ ├── __init__.py
│ │ ├── main.py # FastAPI server & endpoints
│ │ ├── eda.py # Exploratory data analysis
│ │ ├── cleaning.py # Data cleaning suggestions
│ │ ├── modeling.py # ML model training
│ │ ├── llm.py # LLM integration placeholders
│ │ ├── schemas.py # Pydantic models
│ │ └── utils.py # Helper functions
│ ├── tests/
│ │ └── test_api.py
│ ├── uploads/ # Temporary CSV storage
│ ├── requirements.txt
│ └── README.md
├── frontend/
│ ├── src/
│ │ ├── components/ # React components
│ │ ├── pages/ # Page components
│ │ ├── services/ # API integration
│ │ ├── types/ # TypeScript types
│ │ ├── App.tsx
│ │ └── main.tsx
│ ├── package.json
│ └── tailwind.config.js
├── sample_data/
│ └── example.csv # Sample dataset
└── README.md
POST /upload- Upload CSV file and get initial metadataGET /profile/{dataset_id}- Get comprehensive profiling results
GET /cleaning_suggestions/{dataset_id}- Get cleaning recommendations
GET /schema_llm/{dataset_id}- LLM-inferred column semantics
POST /train_model- Train classification or regression modelsGET /model_results/{dataset_id}- Get model performance metrics
POST /chat- Ask natural language questions about your data
-
Upload CSV
curl -X POST "http://localhost:8000/upload" \ -F "file=@your_data.csv"
-
Get Profiling Results
curl "http://localhost:8000/profile/dataset_123" -
Train Model
curl -X POST "http://localhost:8000/train_model" \ -H "Content-Type: application/json" \ -d '{"dataset_id": "dataset_123", "target_column": "price"}'
# Backend tests
cd backend
pytest tests/
# Frontend tests
cd frontend
npm test# Backend
black app/
isort app/
# Frontend
npm run lint
npm run format- CSV upload and storage
- Basic profiling and statistics
- Cleaning suggestions
- Baseline ML models
- React frontend
- LLM integration (OpenAI/Anthropic)
- Advanced visualizations
- Data transformation UI
- Model export
- Multi-file analysis
- SQL database support
- Custom model training
- Collaboration features
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details
For issues or questions, please open an issue on GitHub.
Built with ❤️ for data scientists and analysts