Installation from source

Installation from source is useful if installation of wheels fail due to some incompatible distribution for your operating system / architecture. Source installations are recommended if you would like to

  • Develop / Contribute to Sugaroid AI

  • A packager for Sugaroid Bot

  • Your OS does not support the wheel

  • You would like to use bleeding edge releases

Installing from Source

Cloning the sugaroid repository

To clone the sugaroid repository, you will need to have git on PATH. You may search this up, and look up possible articles on installing git for your operating system.

git clone https://github.com/sugaroidbot/sugaroid.git

If you are low on data, you might like to make a shallow clone (if you would not like to get the previous commits)

git clone https://github.com/sugaroidbot/sugaroid.git --depth=1

Note

If you are installing Sugaroid on Windows, you will have to install Microsoft Visual C++ Redistributable for Visual Studio 2019 for installing the runtime components of Visual C++ Libraries required by the en-core-web-sm dependency

Setting up the environment (easier, linux)

Sugaroid development interface can be set up using toolbox.

Execute the following inside the cloned repository. This will build a toolbox docker container, and install all the required dependencies and you will have a sandboxed, development ready environment.

podman build --target=toolbox . -t sugaroid-toolbox:latest
toolbox create -c sugaroid-toolbox -i sugaroid-toolbox
toolbox enter sugaroid-toolbox

# once inside the toolbox, run sugaroid normally
python3 -m sugaroid

Dockerfile is provided, and can be used with any other container orchestration system, like docker itself, or podman, etc.

Installing Sugaroid (advanced users)

You can now install sugaroid using python. Make sure you have setuptools, by default, most python distribution includes setuptools by default

cd sugaroid
pipenv sync && pipenv lock

Note

You might need to install pipenv from your package manager, or from PyPI. See the pipenv installation guide for more details.