Browse Source

refactor readme and remove internal links

master
wenmeng.zwm 3 years ago
parent
commit
687766d9f8
3 changed files with 20 additions and 12 deletions
  1. +17
    -7
      README.md
  2. +2
    -4
      docs/source/develop.md
  3. +1
    -1
      docs/source/quick_start.md

+ 17
- 7
README.md View File

@@ -2,15 +2,25 @@


ModelScope library is targeted to support training, evaluation and inference for the state of the art models provided by Mind and further support third-party models provided by users outside alibaba. ModelScope library is targeted to support training, evaluation and inference for the state of the art models provided by Mind and further support third-party models provided by users outside alibaba.


# Design doc
In order to enable ModelScope users to use the various models provided by ModelScope quickly and conveniently, we provide a set of complete Python library, which includes the implementation of ModelScope official models, inference, finetuning and evaluation support for those models such as preprocessor and evaluation metrics. We also provide easy-to-use APIs and rich usage examples. By calling the library, users can write just a few lines of code to complete tasks such as model inference, training, and evaluation, and can also quickly carry out secondary development on this basis to realize their own innovative ideas.


Please refer to alidoc [link](https://alidocs.dingtalk.com/i/nodes/OBldywvrKxo89xmAO05yJQk2ngpNbLz4?nav=spaces&navQuery=spaceId%3Dnb9XJNlZxbgrOXyA&iframeQuery=utm_source%3Dportal%26utm_medium%3Dportal_space_file_tree)
At present, the algorithm models provided by library cover four main AI fields of image, natural language processing, speech, and multi-modality, and dozens of application scenarios and tasks.


# Development doc
# Installation


Please refer to [develop.md](docs/source/develop.md)
Please refer to [installation](https://modelscope.cn/docs/%E7%8E%AF%E5%A2%83%E5%AE%89%E8%A3%85).


# ChangeLog
* 20/05/2022 First release version
# Get Started


Refer to [change_log.md](docs/source/change_log.md) for more details
You can refer to [quick_start](https://modelscope.cn/docs/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) for quick start.

We also provide other documentations including:
* [Introduction to tasks](https://modelscope.cn/docs/%E4%BB%BB%E5%8A%A1%E7%9A%84%E4%BB%8B%E7%BB%8D)
* [Use pipeline for model inference](https://modelscope.cn/docs/%E6%A8%A1%E5%9E%8B%E7%9A%84%E6%8E%A8%E7%90%86Pipeline)
* [Finetune example](https://modelscope.cn/docs/%E6%A8%A1%E5%9E%8B%E7%9A%84%E8%AE%AD%E7%BB%83Train)
* [Preprocessing of data](https://modelscope.cn/docs/%E6%95%B0%E6%8D%AE%E7%9A%84%E9%A2%84%E5%A4%84%E7%90%86)
* [Evaluation metrics](https://modelscope.cn/docs/%E6%A8%A1%E5%9E%8B%E7%9A%84%E8%AF%84%E4%BC%B0)

# License

This project is licensed under the [Apache License (Version 2.0)](https://github.com/modelscope/modelscope/blob/master/LICENSE).

+ 2
- 4
docs/source/develop.md View File

@@ -44,7 +44,7 @@ There are mainly three test levels:
* level 2: scenario tests for all the implemented modules such as model, pipeline in different algorithm filed. * level 2: scenario tests for all the implemented modules such as model, pipeline in different algorithm filed.


Default test level is 0, which will only run those cases of level 0, you can set test level Default test level is 0, which will only run those cases of level 0, you can set test level
via environment variable `TEST_LEVEL`. For more details, you can refer to [test-doc](https://alidocs.dingtalk.com/i/nodes/mdvQnONayjBJKLXy1Bp38PY2MeXzp5o0?dontjump=true&nav=spaces&navQuery=spaceId%3Dnb9XJNlZxbgrOXyA)
via environment variable `TEST_LEVEL`.




```bash ```bash
@@ -159,9 +159,7 @@ git pull origin branch_name
git push --set-upstream origin dev/my-dev-branch git push --set-upstream origin dev/my-dev-branch
``` ```
Note that you may push multiple times to the same branch with 'git push' commands later. Note that you may push multiple times to the same branch with 'git push' commands later.
5. Open the remote url `https://code.alibaba-inc.com/Ali-MaaS/MaaS-lib/codereview/new` to create a new merge request that merges your development branch (aka, the "dev/my-dev-branch in this example) into master branch. Please follow the instruction on aone page to submit the merge request a code review.


5. Create a pull request on github to merge your code into master.


## Build pip package ## Build pip package
```bash ```bash


+ 1
- 1
docs/source/quick_start.md View File

@@ -74,7 +74,7 @@ pip install "modelscope[multi-modal]" -f https://modelscope.oss-cn-beijing.aliyu
ModelScope的源码可以直接clone到本地: ModelScope的源码可以直接clone到本地:


```shell ```shell
git clone git@gitlab.alibaba-inc.com:Ali-MaaS/MaaS-lib.git modelscope
git clone git@github.com:modelscope/modelscope.git
cd modelscope cd modelscope
git fetch origin master git fetch origin master
git checkout master git checkout master


Loading…
Cancel
Save