Spaces:
Sleeping
Sleeping
File size: 1,840 Bytes
23654e5 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
# Quick Start Guide
## 🚀 Get Running in 3 Minutes
### 1. Install Dependencies
```bash
cd participatory_planner
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
```
### 2. Configure
```bash
cp .env.example .env
# Edit .env and set FLASK_SECRET_KEY to any random string
```
### 3. Run
```bash
python run.py
```
Visit **http://localhost:5000**
## 📝 First Login
- Default admin token: **`ADMIN123`**
- Login and start managing your participatory planning session!
## 🤖 AI Model Info
- **Completely FREE** - No API keys needed!
- **Offline** - Runs locally after initial download
- **First run**: Downloads model (~1.5GB) - this happens once
- **After that**: Instant offline classification
## 🎯 Basic Workflow
1. **Admin** → Share registration link with participants
2. **Participants** → Generate tokens, login, submit ideas
3. **Admin** → Click "Analyze Submissions" to categorize
4. **Admin** → View analytics, charts, and maps
5. **Export** → Save as JSON or CSV
## 💡 Key Features
✅ Token-based authentication
✅ 6 contributor types (Government, Community, Industry, NGO, Academic, Other)
✅ AI categorization (Vision, Problem, Objectives, Directives, Values, Actions)
✅ Geographic mapping with Leaflet
✅ Charts and analytics
✅ Export/Import sessions
✅ Flag offensive content
## 🔧 Troubleshooting
**Model download slow?**
- It's a one-time 1.5GB download
- Use good internet connection for first run
- Model is cached locally afterward
**Out of memory?**
- Model needs ~2-4GB RAM
- Close other applications during analysis
**Want faster analysis?**
- If you have a GPU, edit `app/analyzer.py` line 31:
```python
device=0 # Use GPU instead of device=-1 (CPU)
```
Enjoy your participatory planning session! 🎉
|