Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .DS_Store
Binary file not shown.
92 changes: 92 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
# Requesting City Services via AI-Driven App

This Flutter application allows users to submit municipal-related complaints by capturing images using the camera or selecting images from the gallery. The backend API, built with FastAPI, classifies the complaints and directs them to the appropriate department using a Vision Transformer model trained on a custom dataset.

## About Dataset ##
- The model is trained on self made dataset consisting over 125 images with 25 images for each category, featuring images both self-captured and sourced from the internet, across five categories:.

- Road and Transport Department
- Electricity Department
- Waste Management Department
- Nature and Recreation Department
- Water Supply and Management

## Features

- Capture images using the device camera or form gallery
- allows user to share location of the compliant to be registered
- Submit complaints with images and descriptions
- Automatic classification of complaints to the relevant department

## Technology Stack

### Frontend

- **Flutter 3.19.0**
- Dart programming language
- BLoC (Business Logic Component) state management

### Backend

- **FastAPI**
- **Vision Transformer model for image classification**

## Installation

### Prerequisites

- Flutter SDK: [Install Flutter](https://flutter.dev/docs/get-started/install)
- Dart SDK: Included with Flutter SDK
- Python 3.7+: [Install Python](https://www.python.org/downloads/)
- FastAPI: [FastAPI Documentation](https://fastapi.tiangolo.com/)

### Steps

1. **Clone the repository:**
```sh
git clone https://github.com/AMANREVANKAR/summerofcode.git
cd summerofcode
```

2. **Install Flutter dependencies:**
```sh
cd app
flutter pub get
```

3. **Run the Flutter app:**
```sh
cd summerofcode/app/lib/features/complaint_form/domain/usecase.dart
add the url for the api server
flutter run
```


4. **Setup and run the backend API:**

- Navigate to the backend directory:
```sh
cd backend
```

- Setting up the server:
```sh
add the server ip address and port number
```

- Start the FastAPI server:
```sh
uvicorn APIserver:app --host ip_address --port port_no
```
## Working
below is the demo video of a working app
https://drive.google.com/file/d/1QOL003BB6ShAkGesp5ocMF6mtkS2mJcM/view?usp=drive_link

## Directory Structure
- **summerofcode**
- App
- contains whole flutter app
- backend
- contains all the server and model files


1 change: 0 additions & 1 deletion _config.yml

This file was deleted.

Binary file added app/.DS_Store
Binary file not shown.
31 changes: 31 additions & 0 deletions app/.dart_tool/extension_discovery/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
Extension Discovery Cache
=========================

This folder is used by `package:extension_discovery` to cache lists of
packages that contains extensions for other packages.

DO NOT USE THIS FOLDER
----------------------

* Do not read (or rely) the contents of this folder.
* Do write to this folder.

If you're interested in the lists of extensions stored in this folder use the
API offered by package `extension_discovery` to get this information.

If this package doesn't work for your use-case, then don't try to read the
contents of this folder. It may change, and will not remain stable.

Use package `extension_discovery`
---------------------------------

If you want to access information from this folder.

Feel free to delete this folder
-------------------------------

Files in this folder act as a cache, and the cache is discarded if the files
are older than the modification time of `.dart_tool/package_config.json`.

Hence, it should never be necessary to clear this cache manually, if you find a
need to do please file a bug.
1 change: 1 addition & 0 deletions app/.dart_tool/extension_discovery/vs_code.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"version":2,"entries":[{"package":"sanpresolve","rootUri":"../","packageUri":"lib/"}]}
Loading