# Material Classification Tool - Portable Edition

## Quick Start

1. **Add Models First**: Copy your `models` folder into this directory
2. **Run**: Double-click `START_APP.bat`
3. **Use**: Click "Browse" to select Excel files and run classification

## Requirements

- Windows 10/11 (64-bit)
- **Models folder must be present** (not included in this package)

## Folder Structure

```
Material-Classification-Tool/
├── START_APP.bat         ← Double-click to run
├── main.js
├── preload.js
├── package.json
├── templates/
├── node_modules/        ← Electron runtime
├── venv/                ← Python environment
├── models/              ← ADD YOUR MODELS HERE
│   ├── Material_1/
│   ├── Material_2/
│   └── ...
└── README.txt           ← This file
```

## Important Notes

✅ Everything is self-contained - no installation required
✅ Works offline - no internet needed
✅ Models can be updated anytime - just replace files in `models/` folder
❌ DO NOT move files out of this folder
❌ DO NOT delete any files except in `models/` folder

## Updating Models

1. Navigate to the `models` folder
2. Add/replace model files
3. Restart the application
4. That's it!

## Troubleshooting

**"Models not found" error**
→ Make sure you have a `models` folder in the same directory as START_APP.bat
→ Check that models are in the correct subfolder structure

**"Python not found" error**  
→ Make sure the `venv` folder is present and intact
→ Do not modify the venv folder

**App won't start**
→ Make sure Node.js modules are present in `node_modules/` folder
→ Try running START_APP.bat as administrator

## How to Share This App

1. Zip this entire folder
2. Share the ZIP file
3. Recipients just unzip and run START_APP.bat
4. Remember to share the models folder separately or include it

---

**Size**: This package is large (~500MB+) because it includes:
- Complete Python environment
- Electron runtime  
- All dependencies

But it means no installation required - just unzip and run!