使用
Linux系统的用户建议采用本安装方式。
使用Windows系统的用户仅支持使用 docker镜像安装 方式。
注意：目前linger和thinker的运行环境有差异，建议在linux系统下创建两个独立的虚拟环境：linger-env和thinker-env
22.04及以上版本使用pip或者源码方式安装工具链时，需要提前配置运行环境
建议使用conda创建虚拟环境：
conda 是一款方便在本地创建、保存、切换环境的软件包和环境管理系统，可参照 官方安装指引 或网上相关教程进行安装。
conda create -n linger-env python==3.7.0
conda activate linger-env
pip install -U pip
cat requirements.txt | xargs -n 1 pip install
conda create -n thinker-env python==3.8.5
conda activate thinker-env
pip install -U pip
cat requirements.txt | xargs -n 1 pip install
linger和thinker分别有两种安装方案，任选其一
git clone https://github.com/LISTENAI/linger.git
cd linger && sh install.sh
git clone https://github.com/LISTENAI/thinker.git
cd thinker && sh scirpts/x86_linux.sh
pip install pylinger
pip install pythinker
Python 3.7.0 (default, Jul 8 2022, 22:11:17)
[GCC 7.3.0] :: Anaconda, Inc. on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import linger
>>>
Python 3.7.0 (default, Jul 8 2022, 22:11:17)
[GCC 7.3.0] :: Anaconda, Inc. on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import thinker
>>>
conda info --env
conda list
conda activate base(或者 conda deactivate xxx)
conda remove -n xxx --all
使用
Windows系统的用户建议采用本安装方式。
如果未安装docker工具，请参考以下链接进行安装（建议使用Centos系统）。如果已安装则直接进行权限验证
请安装docker-19.03及以上版本。安装完成后，运行下面的命令查看版本，验证是否安装成功并有足够权限
$ docker version
如果出现"Got permission denied"权限报错，说明当前用户权限不够，需要添加权限
docker 需要用户具有 sudo 权限，但不宜直接使用root用户进行操作
为了避免每次命令都输入sudo，可以建立 docker 用户组并把用户加入
$ sudo groupadd docker # 添加docker用户组
$ sudo gpasswd -a $USER docker # 将登陆用户加入到docker用户组中
$ newgrp docker # 更新用户组
$ docker ps # 测试docker命令是否可以使用sudo正常使用
再次执行"docker version"命令，发现不再出现"Got permission denied"权限报错，继续下一步。
可通过修改/etc/docker/daemon.json文件设置从国内服务器获取镜像文件来进行加速
$ sudo systemctl start docker # systemctl 命令的用法
1）、拉取镜像
sudo docker pull listenai/linger:1.1.1 #纯cpu版本镜像
sudo docker pull listenai/linger_gpu:1.1.1 #cuda11.2版本镜像
sudo docker pull listenai/thinker:2.1.1
2）、运行容器
docker container run -it listenai/linger:1.1.1 /bin/bash
docker container run -it --gpus all listenai/linger_gpu:1.1.1 /bin/bash
如果提示不能使用gpu，则需要在本地机器上安装nvidia-container-toolkit，将宿主机的GPU驱动文件映射到容器内部使用。
如果一切正常，运行上面的命令以后，就会返回一个命令行提示符。
root@66d80f4aaf1e:/linger#
注意：linger_gpu版本中，需要将linger/modules/lib/*.so文件拷贝到linger的安装目录下。否则验证时会出现找不到lingerext模块
root@66d80f4aaf1e:/linger#cp linger/modules/lib/*.so ~/anaconda3/lib/python3.7/site-packages/
其中66d80f4aaf1e表示容器ID
这表示你已经在容器里面了，返回的提示符就是容器内部的 Shell 提示符。这里进入linger目录，能够执行linger相关命令。
root@66d80f4aaf1e:/linger#sh install.sh
docker container run -it listenai/thinker:2.1.1 /bin/bash
如果一切正常，运行上面的命令以后，就会返回一个命令行提示符。
root@2f0688ea7963:/thinker#
其中2f0688ea7963表示容器ID
这表示你已经在容器里面了，返回的提示符就是容器内部的 Shell 提示符。这里进入thinker目录，能够执行thinker相关命令。
root@2f0688ea7963:/thinker#sh scripts/x86_linux.sh
3）、其它可能的操作
以下为docker常用指令，如有其它需要，请查阅docker的指令集
$ docker ps
$ docker cp model 66d80f4aaf1e:linger
$ docker cp 66d80f4aaf1e:/models /opt
$ docker container kill [containID]
$ docker container rm [containID]
$ docker commit <container-id> <new_image_name> # 其中<container-id>为已有容器的id， new_iamge_name是新镜像的名称
| 方式 | 结果 | 再次启动 |
|---|---|---|
| exit | 退出后,容器消失并销毁，ps查不到 | docker start 容器名/容器id |
| ctrl + D | 退出后,容器消失并销毁，ps查不到 | docker start 容器名/容器id |
| 先按 ctrl + p,再按 ctrl + q | 退出后,容器后台运行，ps能查到 | docker start 容器名/容器id |