Merge pull request #1 from AdamMiltonBarker/main

1.0.0
leukaemiamedtech · May 29, 2021 · 55de945 · 55de945
2 parents 28d3ae7 + 5f4da61
commit 55de945
Show file tree

Hide file tree

Showing 30 changed files with 1,642 additions and 2 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,287 @@
+# Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss
+## Contributing To Our Projects
+
+&nbsp;
+
+The Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss encourages and welcomes code contributions, bug fixes and enhancements from the Github community.
+
+The following is a guide on how to contribute to Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss Github projects and **_should be followed in all cases_**.
+
+&nbsp;
+
+# Table Of Contents
+
+- [Repository Issues](#repository-issues)
+    - [Bug reports](#bug-reports)
+    - [Feature requests](#feature-requests)
+    - [Feature proposals](#feature-proposals)
+- [Creating a fork of the repository](#creating-a-fork-of-the-repository)
+- [Repository structure](#repository-structure)
+- [Documentation](#documentation)
+- [Installation Scripts](#documentation)
+- [Naming](#documentation)
+- [Attribution](#documentation)
+- [.md Files](#documentation)
+- [Push changes to forked repository](#documentation)
+- [Pull requests](#documentation)
+- [Pull requests process](#documentation)
+- [Code of conduct](#documentation)
+    - [Our pledge](#documentation)
+    - [Our standards](#documentation)
+    - [Our responsibilities](#documentation)
+
+
+
+&nbsp;
+
+# Repository Issues
+
+The first step is to head to our repository issues tab and decide how you would like to contribute.
+
+![Repository Issues](assets/images/repo-issues.png)
+
+## Bug reports
+
+![Bug Reports](assets/images/bug-report.png)
+
+If you would like to contribute bug fixes or make the team aware of bugs you have identified in the project, please raise a **Bug report** issue in the [issues section](issues/new/choose) section. A template is provided that will allow you to provide your suggestions for your bug report / bug fix(es) which will be reviewed by the team.
+
+Bug fix issues are the first step to creating a pull request for bug fixes, once you have created your issue and it has been approved you can proceed with your bug fixes.
+
+## Feature requests
+
+![Bug Reports](assets/images/feature-request.png)
+
+If you would like to suggest a new feature/new features for this project, please raise a **Feature request** issue in the [issues section](issues/new/choose) section. A template is provided that will allow you to provide your suggestions for your feature request.
+
+## Feature proposals
+
+![Bug Reports](assets/images/feature-proposals.png)
+
+If you would like to contribute new features to the project, please raise a **Feature proposal** issue in the [issues section](issues/new/choose) section. A template is provided that will allow you to provide your suggestions for your feature proposal.
+
+&nbsp;
+
+# Creating a fork of the repository
+
+![Creating a fork of the repository](assets/images/fork.png)
+If you are going to be contributing code or documentation to the repository you will need to make a fork of the current development branch. The current development branch will always be the highest branch or master. Once you have created a fork of the repository, you will be able to clone the repository to a location on your development machine using terminal and Git or Github Desktop if using Windows.
+
+&nbsp;
+
+# Repository structure
+
+```
+- Project Root (Directory)
+    - config (Directory) *
+        - config.json (File) *
+        - credentials.json (File) *
+    - modules (Directory) *
+        - AbstractAgent.py (File) *
+        - AbstractData.py (File) *
+        - AbstractModel.py (File) *
+        - AbstractServer.py (File) *
+        - helpers.py (File) *
+        - data.py (File) *
+        - model.py (File) *
+        - mqtt.py (File) *
+        - server.py (File) *
+    - documentation (Directory)
+        - installation (Directory)
+            - Ubuntu
+            - Windows
+            - Raspberry Pi OS
+    - logs (Directory)
+        - logfiles
+    - assets
+        - media
+            - images (Directory)
+            - videos (Directory)
+    - model
+        - data (Directory) *
+            - test (Directory) *
+            - train (Directory) *
+            - plots (Directory) *
+        - model.json (File)
+        - weights.h (File)
+    - scripts
+        - install.sh (File)
+    - agent.py (File)
+    - Project README (File)
+```
+
+&nbsp;
+
+# Documentation
+
+All projects should have documentation, changes you make to the code in the repository or new projects that you make should also have documentation. In the structures above you can see the **Documentation** directories, and the **Installation** file. This installation file should contain a step by step guide to how to install your project, while directions of use will be a high level tutorial in your project README. If you are contributing an existing repository you will ensure that these documents are updated to reflect your changes.
+
+&nbsp;
+
+# Installation Scripts
+
+You will notice the **Scripts** directory above, this is home to any scripts that make it easier for the end use to set up and / or use your project. By default every project must have an installation script when installations are required. If you are contributing an existing repository you will ensure that these scripts are updated to reflect your changes.
+
+&nbsp;
+
+# Naming
+
+We use CamelCase for our directory and file names (except images), we would like this to stay uniform across all of our projects. Please use descriptive but short names where possible, and make sure you do not use spaces in directory and file names.
+
+&nbsp;
+
+# Attribution
+
+Whenever relevant you should add yourself to the contributors section of the READMEs. If you have a public profile on the Peter Moss Leukemia AI Research website, you should use this in your link. Please see the contributing section of any of our READMEs for examples.
+
+&nbsp;
+
+# .md Files
+
+Each .md file in the repository should use the same header. An example of this is as follows:
+
+```
+# Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss
+## Acute Lymphoblastic Leukemia oneAPI Classifier
+
+![Acute Lymphoblastic Leukemia oneAPI Classifier](assets/images/all-oneapi-classifier-2020.png)
+```
+If the .md file is the README  in the project root, it should including the following markdown, ensuring the repository URLS and versions are correct.
+
+```
+[![CURRENT RELEASE](https://img.shields.io/badge/CURRENT%20RELEASE-0.0.0-blue.svg)](https://github.com/AIIAL/Acute-Lymphoblastic-Leukemia-oneAPI-Classifier/tree/0.0.0) [![UPCOMING RELEASE](https://img.shields.io/badge/CURRENT%20DEV%20BRANCH-0.1.0-blue.svg)](https://github.com/AIIAL/Acute-Lymphoblastic-Leukemia-oneAPI-Classifier/tree/0.1.0) [![Contributions Welcome!](https://img.shields.io/badge/Contributions-Welcome-lightgrey.svg)](CONTRIBUTING.md)  [![Issues](https://img.shields.io/badge/Issues-Welcome-lightgrey.svg)](issues) [![LICENSE](https://img.shields.io/badge/LICENSE-MIT-blue.svg)](LICENSE)
+```
+
+```
+
+# Contributing
+The Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss encourages and welcomes code contributions, bug fixes and enhancements from the Github community.
+
+Please read the [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") document for a full guide to forking our repositories and submitting your pull requests. You will also find information about our code of conduct on this page.
+
+## Contributors
+- [Adam Milton-Barker](https://www.leukemiaairesearch.com/association/volunteers/adam-milton-barker "Adam Milton-Barker") - [Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss](https://www.leukemiaresearchassociation.ai "Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss") President/Founder & Lead Developer, Sabadell, Spain
+
+&nbsp;
+
+# Versioning
+We use SemVer for versioning.
+
+&nbsp;
+
+# License
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE "LICENSE") file for details.
+
+&nbsp;
+
+# Bugs/Issues
+We use the [repo issues](issues "repo issues") to track bugs and general requests related to using this project. See [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") for more info on how to submit bugs, feature requests and proposals.
+```
+
+The project README contributors should contain a list of all contributors in the entire repository.
+
+&nbsp;
+
+# Push changes to forked repository
+
+When you have made your changes, you need to push them to your forked repository. This process requires a commit with a message about what your commit is, and then finally a push to the repository which will place your changes or created files to your forked repository.
+
+Show the status of all changed/added files.
+
+```
+git status
+```
+
+You may want to do check the differences between changed files, you can do this using the following command.
+
+```
+git diff
+```
+
+Add all changes ready to commit. (You may not want to add all changed files, in this case please follow instructions to add single files to commit that you were shown using git status). To repeat, the following will add all changes shown by using git status to your commit.
+
+```
+git add .
+```
+
+Commit your changes.
+
+```
+git commit -m "Your descriptive commit message"
+```
+
+Push changes to your fork.
+
+```
+git push
+```
+
+You can also Github Desktop if on Windows as shown in the image above.
+
+&nbsp;
+
+# Pull requests
+
+When you are satisfied with your changes you can submit a pull request that will request that your changes be pulled into the latest development branch.
+
+## Pull Request Process
+
+1. Ensure all documentation has been updated and matches the style of our repository layouts, including repository directory structures etc.
+2. Add new README.md files for new directories / ** init **.py files for empty directories.
+3. Ensure that your READMEs, documentation and code match the format/design of the rest of the repoistory.
+4. Include the project header banner on all documentation pages / READMEs.
+5. Incude the Contributing, Versioning, Licensing, Bugs/Issues information in all READMEs and documentation.
+6. Do not ever upload licensed software or images that you do not own the rights to.
+7. Submit your Pull Request with an accurate description of the changes you have made.
+8. Your Pull Request will be reviewed by the team.
+
+&nbsp;
+
+# Code of conduct
+
+Please note we have a code of conduct, please follow it in all your interactions with the project.
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [email protected] All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+&nbsp;
+
+# Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org/version/1/4), version 1.4.
diff --git a/README.md b/README.md
@@ -1,2 +1,92 @@
-# GPT-3-Leukemia-Information-Assistant
-A HIAS connected AI assistant based on GPT-3, capable of providing information based on Leukemia. This application is a proof of concept and should not be used for medical advise
+# Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss
+## GPT-3 Leukemia Information Assistant
+
+![GPT-3 Leukemia Information AssistantGPT-3 Leukemia Information Assistant](assets/images/gpt-3-leukemia-assistant.jpg)
+
+[![CURRENT RELEASE](https://img.shields.io/badge/CURRENT%20RELEASE-1.0.0-blue.svg)](https://github.com/AIIAL/GPT-3-Leukemia-Information-Assistant/tree/1.0.0) [![UPCOMING RELEASE](https://img.shields.io/badge/CURRENT%20DEV%20BRANCH-2.0.0-blue.svg)](https://github.com/AIIAL/GPT-3-Leukemia-Information-Assistant/tree/2.0.0) [![Contributions Welcome!](https://img.shields.io/badge/Contributions-Welcome-lightgrey.svg)](CONTRIBUTING.md)  [![Issues](https://img.shields.io/badge/Issues-Welcome-lightgrey.svg)](issues) [![LICENSE](https://img.shields.io/badge/LICENSE-MIT-blue.svg)](LICENSE)
+
+&nbsp;
+
+# Table Of Contents
+
+- [Introduction](#introduction)
+- [DISCLAIMER](#disclaimer)
+- [Motivation](#motivation)
+- [Leukemia](#leukemia)
+- [GPT-3](#gpt-3)
+- [GETTING STARTED](#getting-started)
+- [Contributing](#contributing)
+  - [Contributors](#contributors)
+- [Versioning](#versioning)
+- [License](#license)
+- [Bugs/Issues](#bugs-issues)
+
+&nbsp;
+
+# Introduction
+
+The **GPT-3 Leukemia Information Assistant** is an open-source **proof of concept** application developed using the OpenAI API beta. The project is a HIAS AI Agent meaning it can be connected to the HIAS Network and can provide user interfaces with on demand information about Leukemia.
+
+&nbsp;
+
+# DISCLAIMER
+
+This project is a **proof of concept** and has been designed to demonstrate a **possible** medical use case for GPT-3. It is currently against OpenAI's [use case guidelines](https://beta.openai.com/docs/use-case-guidelines/faq) to create a production application that is intended to provide medical advice.
+
+**This project is not to be used to provide medical information in the real world.**
+
+The information provided by this project may not be factually correct.
+
+&nbsp;
+
+# Motivation
+
+The motivation for this project is to see how GPT-3 could be used as a potential medical information source for leukemia.
+
+&nbsp;
+
+# Leukemia
+
+Leukemia is a blood cancer characterized by a rapid production of abnormal white blood cells called blasts.  In 2020, almost 500,000 new patients were diagnosed with leukemia all over the world and approximately 312,000 individuals died with this disease. In the United States, there are over 60,000 new cases every year, and over 24,000 patients die from leukemia annually.
+
+For more information about Leukemia please visit our [Leukemia Information Page](https://www.leukemiaairesearch.com/research/leukemia)
+
+&nbsp;
+
+# GPT-3
+
+GPT-3 (Generative Pre-trained Transformer 3) uses state of the deep learning to produce human-like text for natural language understanding applications. The language prediction model is exposed via the OpenAI API Beta, a new offering from OpenAI that allows developers to implement state of the art language predictions into their applications.
+
+Thank you to OpenAI for providing early access to the beta making this project possible.
+
+&nbsp;
+
+# GETTING STARTED
+
+Ready to get started ? Head over to the [Getting Started guide](documentation/getting-started.md) for instructions on how to download/install and setup the GPT-3 Leukemia Information Assistant.
+
+&nbsp;
+
+# Contributing
+The Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss encourages and welcomes code contributions, bug fixes and enhancements from the Github community.
+
+Please read the [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") document for a full guide to forking our repositories and submitting your pull requests. You will also find information about our code of conduct on this page.
+
+## Contributors
+- [Adam Milton-Barker](https://www.leukemiaairesearch.com/association/volunteers/adam-milton-barker "Adam Milton-Barker") - [Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss](https://www.leukemiaresearchassociation.ai "Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss") President/Founder & Lead Developer, Sabadell, Spain
+- [Dr Rita Rb-Silva](https://www.leukemiaairesearch.com/association/volunteers/rita-silva-md-phd "Dr Rita Rb-Silva") - [Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss](https://www.leukemiaresearchassociation.ai "Asociación de Investigacion en Inteligencia Artificial Para la Leucemia Peter Moss") Medical Advisor (Hematology), Porto, Portugal
+
+&nbsp;
+
+# Versioning
+We use SemVer for versioning.
+
+&nbsp;
+
+# License
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE "LICENSE") file for details.
+
+&nbsp;
+
+# Bugs/Issues
+We use the [repo issues](issues "repo issues") to track bugs and general requests related to using this project. See [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") for more info on how to submit bugs, feature requests and proposals.