FARMDEPOT_NG - AI-Powered Agricultural Marketplace πΎ Nigeria's premier agricultural classified ads platform with AI-powered voice recognition and multilingual support.
# FARMDEPOT_NG - AI-Powered Agricultural Marketplace
πΎ Nigeria's premier agricultural classified ads platform with AI-powered voice recognition and multilingual support.
## π Live Demo
**Streamlit Cloud:** [Your deployed app URL here]
## β¨ Features
- π€ **Voice Recognition** (Local only - full functionality when running locally)
- π **Multilingual Support** (English, Hausa, Yoruba, Igbo)
- π **User Authentication** (Registration & Login)
- ποΈ **Post & Search Ads** with image upload
- π± **Mobile-Responsive Design**
- π€ **AI Command Processing**
- π **Real-time Search & Filtering**
## π οΈ Installation & Setup
### Option 1: Run Locally (Full Features)
```bash
# Clone the repository
git clone [your-repo-url]
cd farmdepot_ng
# Install basic requirements
pip install streamlit pillow pandas
# Install voice recognition (optional but recommended)
pip install speechrecognition pyaudio pyttsx3
# Run the application
streamlit run app.py
```
### Option 2: Deploy to Streamlit Cloud
1. **Create these files in your repository:**
- `app.py` (main application)
- `requirements.txt` (Python dependencies)
- `packages.txt` (system packages - optional)
- `.streamlit/config.toml` (Streamlit configuration)
2. **Deploy to Streamlit Cloud:**
- Go to share.streamlit.io
- Connect your GitHub repository
- Select `app.py` as the main file
- Deploy!
## π File Structure
```
farmdepot_ng/
βββ app.py # Main application
βββ requirements.txt # Python dependencies
βββ packages.txt # System packages (for cloud)
βββ .streamlit/
β βββ config.toml # Streamlit configuration
βββ uploads/ # Image uploads (created automatically)
βββ farmdepot.db # SQLite database (created automatically)
βββ README.md # This file
```
## π§ Dependencies
### Required (Core functionality):
- `streamlit>=1.28.0`
- `pillow>=9.0.0`
- `pandas>=1.5.0`
### Optional (Voice features - Local only):
- `speechrecognition`
- `pyaudio`
- `pyttsx3`
### Option β¦