# make-sense
**Repository Path**: acproject_admin/make-sense
## Basic Information
- **Project Name**: make-sense
- **Description**: Makesense 是一个为照片贴上标签的在线工具
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 4
- **Created**: 2020-02-20
- **Last Updated**: 2022-06-02
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](https://travis-ci.org/SkalskiP/make-sense)
[](https://codecov.io/gh/SkalskiP/make-sense)
[](https://gitter.im/make-sense-ai/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
makesense.ai
[makesense.ai][1] is a free-to-use online tool for labeling photos. Thanks to the use of a browser it does not require any complicated installation - just visit the website and you are ready to go. It also doesn't matter which operating system you're running on - we do our best to be truly cross-platform. It is perfect for small computer vision deep learning projects, making the process of preparing a dataset much easier and faster. Prepared labels can be downloaded in one of the multiple supported formats. The application was written in TypeScript and is based on React/Redux duo.
## 📄 Documentation
You can find out more about our tool from the newly released [documentation][14].
## 💡 Motto
> For AI to be free we need not just Open Source, but also a strong Open Data movement.
Andrew Ng
## 👀 Sneak Peek
**Figure 1.** Basic version of the application - without AI support
## 🤖 Advanced AI functionalities
[makesense.ai][1] strives to significantly reduce the time we have to spend on labeling photos. To achieve this, we are going to use many different AI models that will be able to give you recommendations as well as automate repetitive and tedious activities.
* [SSD model][8] pretrained on the [COCO dataset][9], which will do some of the work for you in drawing bboxes on photos and also (in some cases) suggest a label.
* [PoseNet model][11] is a vision model that can be used to estimate the pose of a person in an image or video by estimating where key body joints are.
In the future, we also plan to add, among other things, models that classify photos, detect characteristic features of faces as well as whole faces. The engine that drives our AI functionalities is [TensorFlow.js][10] - JS version of the most popular framework for training neural networks. This choice allows us not only to speed up your work but also to care about the privacy of your data, because unlike with other commercial and open source tools, your photos do not have to be transferred to the server. This time AI comes to your device!
**Figure 2.** SSD model - allows you to detect multiple objects, speeding up the bbox labeling process
**Figure 3.** PoseNet model - allows you to detect people's poses in photos, automating point labeling in some usecases
## 💻 Local Setup
```bash
# clone repository
git clone https://github.com/SkalskiP/make-sense.git
# navigate to main dir
cd make-sense
# install dependencies
npm install
# serve with hot reload at localhost:3000
npm start
```
To ensure proper functionality of the application locally, an npm `6.x.x` and node.js `v12.x.x` versions are required. More information about this problem is available in the [#16][4].
## 🐳 Docker Setup
```bash
# Build Docker Image
docker build -t make_sense docker/
# Run Docker Image as Service
docker run -dit -p 3000:3000 --restart=always --name=make_sense make_sense
# Get Docker Container IP
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' make_sense
# Go to `:3000`
# Get Docker Container Logs
docker logs make_sense
```
## ⌨️ Keyboard Shortcuts
| Functionality | Context | Mac | Windows / Linux |
|:-----------------------------------|:--------:|:---:|:----------------:|
| Polygon autocomplete | Editor | Enter | Enter |
| Cancel polygon drawing | Editor | Escape | Escape |
| Delete currently selected label | Editor | Backspace | Delete |
| Load previous image | Editor | ⌥ + Left | Ctrl + Left |
| Load next image | Editor | ⌥ + Right | Ctrl + Right |
| Zoom in | Editor | ⌥ + + | Ctrl + + |
| Zoom out | Editor | ⌥ + - | Ctrl + - |
| Move image | Editor | Up / Down / Left / Right | Up / Down / Left / Right |
| Select Label | Editor | ⌥ + 0-9 | Ctrl + 0-9 |
| Exit popup | Popup | Escape | Escape |
**Table 1.** Supported keyboard shortcuts
## ⬆️ Export Formats
| | CSV | YOLO | VOC XML | VGG JSON | COCO JSON | PIXEL MASK |
|:-------------:|:---:|:----:|:-------:|:--------:|:---------:|:----------:|
| **Point** | ✓ | ✗ | ☐ | ☐ | ☐ | ✗ |
| **Line** | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| **Rect** | ✓ | ✓ | ✓ | ☐ | ☐ | ✗ |
| **Polygon** | ☐ | ✗ | ☐ | ✓ | ✓ | ☐ |
| **Label** | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
**Table 2.** The matrix of supported labels export formats, where:
* ✓ - supported format
* ☐ - not yet supported format
* ✗ - format does not make sense for a given label type
You can find examples of export files along with a description and schema on our [Wiki][7].
## ⬇️ Import Formats
| | CSV | YOLO | VOC XML | VGG JSON | COCO JSON | PIXEL MASK |
|:-------------:|:---:|:----:|:-------:|:--------:|:---------:|:----------:|
| **Point** | ☐ | ✗ | ☐ | ☐ | ☐ | ✗ |
| **Line** | ☐ | ✗ | ✗ | ✗ | ✗ | ✗ |
| **Rect** | ☐ | ✓ | ☐ | ☐ | ✓ | ✗ |
| **Polygon** | ☐ | ✗ | ☐ | ☐ | ✓ | ☐ |
| **Label** | ☐ | ✗ | ✗ | ✗ | ✗ | ✗ |
**Table 3.** The matrix of supported labels import formats
* ✓ - supported format
* ☐ - not yet supported format
* ✗ - format does not make sense for a given label type
## 🔐 Privacy
We don't store your images, because we don't send them anywhere in the first place.
## 📅 Road Map
Our application is being actively developed. Check out our plans for the near future on our [Wiki][6]. If you have an idea for a new functionality, please hit us on [Twitter][3] and [Gitter][5] or create an issue where you can describe your concept. In the meantime, see what improvements we are planning for you in the future.
## 🚀 Tutorials
If you are just starting your adventure with deep learning and would like to learn and create something cool along the way, [makesense.ai][1] can help you with that. Leverage our bounding box labeling functionality to prepare a data set and use it to train your first state-of-the-art object detection model. Follow [instructions][12] and [examples][13] but most importantly, free your creativity.
**Figure 4.** Detection of players moving around the basketball court, based on YouTube-8M dataset.
## 🏆 Contribution
Feel free to file [issues](https://github.com/SkalskiP/make-sense/issues) or [pull requests](https://github.com/SkalskiP/make-sense/pulls).
## 💬 Citation
Please cite Make Sense in your publications if this is useful for your research. Here is an example BibTeX entry:
```BibTeX
@MISC{make-sense,
author = {Piotr Skalski},
title = {{Make Sense}},
howpublished = "\url{https://github.com/SkalskiP/make-sense/}",
year = {2019},
}
```
## 🪧 License
This project is licensed under the GPL-3.0 License - see the [LICENSE][2] file for details. Copyright © 2019 Piotr Skalski.
[1]: http://makesense.ai
[2]: ./LICENSE
[3]: https://twitter.com/PiotrSkalski92
[4]: https://github.com/SkalskiP/make-sense/issues/16
[5]: https://gitter.im/make-sense-ai/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link
[6]: https://github.com/SkalskiP/make-sense/wiki/Road-Map
[7]: https://github.com/SkalskiP/make-sense/wiki/Supported-Output-Formats
[8]: https://arxiv.org/abs/1512.02325
[9]: http://cocodataset.org
[10]: https://www.tensorflow.org/js
[11]: https://www.tensorflow.org/lite/models/pose_estimation/overview
[12]: https://towardsdatascience.com/chess-rolls-or-basketball-lets-create-a-custom-object-detection-model-ef53028eac7d
[13]: https://github.com/SkalskiP/ILearnDeepLearning.py/tree/master/02_data_science_toolkit/02_yolo_object_detection
[14]: https://skalskip.github.io/make-sense/