Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/aksakalli/dress

:dress: The Hackathon App: Fifty Shades of Dress
https://github.com/aksakalli/dress

fashion hackathon ios-app mongodb nodejs objective-c

Last synced: 5 days ago
JSON representation

:dress: The Hackathon App: Fifty Shades of Dress

Awesome Lists containing this project

README

        

# Fifty Shades of Dress

This application allows the user to find articles on [Zalando API](https://api.zalando.com/) based on specific
input color. It was developed in couple of hours in [a hackathon](http://www.gruenderzentrum.rwth-aachen.de/2015/03/16/hackathon-spring-2015/)
and might not be a production ready implementation. It just aims to show how color based search functionality
can help the user to find the best match.

## Authors

* Can Güney Aksakalli - [email protected]
* Yücel Uzun - [email protected]

## Introduction

![men vs women color](docs/images/colorman.png)

Color matters (especially to women). Most fashion eCommerce websites only allows to search on basic color groups but
if you are looking for a specific color, it is really hard to find it in thousands of listed products.

This application detects the dominant color of the product and store it in the NoSQL DB. It uses Lab color space because
it is the most convenient representation to get distance in terms of human perception. Once the server is received a request,
it changed the input to lab color space and returns closest 10 articles based on Euclidean distance of the color channels.

![CIE76](docs/images/CIE76.png)

## WEB API

All images are retrieved from Zalando API and color information is stored in MongoDB. The Web API runs a query in MongoDB
to get similar images.

![architecture](docs/images/architecture.png)

```
get /categories/ list all available categories
get /categories/:category/:color search for a specific color represented as /r,g,b in given category
```

## iPhone App

With this app, you can find best color combination before going out. You can combine your clothes and shoes based on
color preferences. To select a color, you can either take picture of your favorite color or select on color pallet.

Demo video:

[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/5FywLwi8j_M/0.jpg)](http://www.youtube.com/watch?v=5FywLwi8j_M)

[http://www.youtube.com/watch?v=5FywLwi8j_M](http://www.youtube.com/watch?v=5FywLwi8j_M)

## Web demo
![screen shot](docs/images/screenshot.png)

[Here you may check the running demo.](http://5.101.97.25:3000/)

## Running the Server App

Getting ready and running the server:

```bash
# canvas package has following dependencies
sudo apt-get install libcairo2-dev libjpeg8-dev libpango1.0-dev libgif-dev build-essential g++

cd ServerSide

# install node packages
npm install

# you can restore data:
mongorestore --drop -d zalando -c articles data/articles.bson
# or run the service to fill the database
node service.js

# now we are ready to run the app
node server.js
```
## Running the iOS App
With the last version of Xcode it should just work. To use camera part you need to test it in real device.
Since we had limited time, we only focused on working it on iPhone 5 and 5S. It might not work as expected in other models.

## Licence

Released under [the MIT license](LICENSE).