add repo readme (#30)

Signed-off-by: SammyOina <sammyoina@gmail.com>

README.md

@@ -1,3 +1,65 @@
-# cocos-ai
-Cocos AI - Confidential Computing System for AI
+# Cocos AI
+[Cocos AI (Confdential Computing System for AI/ML)][cocos] is a platform for secure multiparty computation (SMPC)
+based on the [Confidential Computing][cc] and [Trusted Execution Environments (TEEs)][tee].
+
+<p align="center">
+  <img src="https://cocos.ai/images/Collaborative%20AI.drawio.svg" width="500" height="500">
+</p>
+
+With Cocos AI it becomes possible to run AI/ML workloads on combined datasets from multiple organizations
+while guaranteeing the privacy and security of the data and the algorithms.
+Data is always encrypted, protected by hardware secure enclaves (Trusted Execution Environments),
+attested via secure remote attestation protocols, and invisible to cloud processors or any other
+3rd party to which computation is offloaded.
+
+## Install
+The following prerequisites are needed to run Cocos:
+
+- [Docker](https://docs.docker.com/install/)
+- [Docker compose](https://docs.docker.com/compose/install/)
+
+### Build Docker Images
+Currenty, there is no Docker registry, so Cocos images must be built by hand:
+```
+make dockers
+```
+
+For this you might be needing to setup DNS servers in your `/etc/resolf.conf` as explained
+[here](https://github.com/docker/cli/issues/2618) (i.e. add Google's `nameserver 8.8.8.8`).
+
+### Run Composition
+
+Once the images are built (`docker images` command should show you `ghcr.io/ultravioletrs/cocos/manager`),
+composition can be run:
+
+```bash
+make run
+```
+
+This will bring up the Cocos docker services and interconnect them. 
+
+## Usage
+
+The quickest way to start using Cocos is via the CLI. The latest version can be downloaded from the [official releases page][rel].
+
+It can also be built and used from the project's root directory:
+
+```bash
+make cli
+./build/cocos-cli version
+```
+
+Additional details on using the CLI can be found in the [CLI documentation](https://docs.cocos.ai/cli).
+
+## Documentation
+
+Official documentation is hosted at [Cocos official docs page][docs]. Documentation is auto-generated, checkout the instructions on [official docs repository](https://github.com/ultravioletrs/docs).
+
+## License
+Cocos AI is a proprietary product created by Ultraviolet company.
+
+[cc]: https://confidentialcomputing.io/white-papers-reports/
+[cocos]: https://cocos.ai/
+[rel]: https://github.com/ultraviolet/cocos/releases
+[tee]: https://en.wikipedia.org/wiki/Trusted_execution_environment