Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shadmansaleh/krishi-dibanishi

A webapp to assist farmers
https://github.com/shadmansaleh/krishi-dibanishi

Last synced: 20 days ago
JSON representation

A webapp to assist farmers

Awesome Lists containing this project

README

        

# Krishi Dibanishi

Krishi Dibanishi is a basic web application designed to assist farmers by providing valuable insights and tools to improve their farming practices. Built with Flask, the app offers the following key features:

## Features
1. **Crop Suggestion**
- Recommends the best crops to grow based on soil conditions, weather, and other factors.

2. **Weather Prediction**
- Provides accurate and up-to-date weather forecasts to help farmers plan their activities.

3. **Market Prices**
- Displays the latest market prices for crops, enabling farmers to make informed decisions.

4. **Soil Tips**
- Suggests tips for how to improve the soil

## Installation

### Prerequisites
- Python (3.8 or higher)
- pip (Python package manager)
- Virtual environment setup (optional but recommended)

### Steps
1. Clone the repository:
```bash
git clone https://github.com/shadmansaleh/Krishi-DibaNishi
cd krishi-dibanishi
```
2. Create a virtual environment:

```bash
python3 -m venv .venv
```

3. Activate virtual environtment:

- On Linux
```bash
source .venv/bin/activate
```

- On Windows
```bash
source .venv\Scripts\activate
```

4. Install dependencies:

```bash
pip3 install -r requirements.txt
```

5. Setup environment:

```bash
cp .env.example .env
```
Then edit .env to fill it with required secrete values

6. Set Up the Database:
```bash
flask db upgrade
```

7. Run the app:
```bash
python run.py
```

5. Open your browser and visit:
http://127.0.0.1:5000

### Folder Structure

```python
/Krishi-DibaNishi/
/run.py # Entry point to start the app
/config.py # Application configuration settings
/app/ # Main application code
/__init__.py # Initializes the Flask app
/routes/ # All route handlers
/api.py # Api endpoints
/views.py # Webpage router from pages/
/auth.py # Authentication handler
/models.py # Database models
/static/ # Static assets (CSS, JS, images)
/templates/ # HTML templates
/layouts/ # Layout-related templates
/pages/ # Templates for individual pages
/partials/ # Reusable partial components
/requirements.txt # Python dependencies
/.venv # Virtual environment (not included in repository)
/.env # Environtment file for holding secretes
```

### License

This project is open-source. Feel free to modify and distribute as per the terms of the license.

### Credits
- [Shadman Saleh](https://github.com/shadmansaleh) ([[email protected]](mailto://[email protected]))
- [Ratnajit Dhar](https://github.com/ratnajit-dhar) ([[email protected]](mailto://[email protected]))
- [Arpita Mallik](https://github.com/ArpitaMallik) ([[email protected]](mailto://[email protected]))
- [Faozia Fariha](https://github.com/bountyhunter12) ([[email protected]](mailto://[email protected]))