Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add manual install and install requirements #540

Merged
merged 1 commit into from
Mar 25, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,12 +44,55 @@ permalink: /

# Install llmware

{: .note}
> New wheels are built generally on PyPy on a weekly basis and updated on PyPy versioning.
> The development repo is updated and current at all times, but may have updates that are not yet in the PyPy wheel.
> All wheels are built and tested on
> - Mac Metal
> - Mac x86
> - Windows x86 (+ with CUDA)
> - Linux x86 (+ with CUDA) - most testing on Ubuntu 22 and Ubuntu 20 - which are recommended.
> - Linux aarch64

{: .note}
> We recommend that you use at least ``llmware >= 0.2.0``. Other than that, make sure that you have the following
> set up.
> - Platforms: Mac M1, Mac x86, Windows, Linux (Ubuntu 22 preferred)
> - Hardware: 16 GB RAM minimum
> - Python versions: 3.9, 3.10, 3.11

You can install ``llmware`` via the Python Package Index (PIP), or you can manually download the ``wheel`` files from
the [GitHub repository](https://github.com/llmware-ai/llmware/tree/main/wheel_archives).

## PIP
You can easily install `llmware` via `pip`.

```bash
pip install llmware
```

## Manual install of wheel files
First, go to the [wheel\_archives](https://github.com/llmware-ai/llmware/tree/main/wheel_archives) folder
and download the *wheel* you want to install.
For example, if you want to install ``llmware`` version ``0.2.5`` then choose ``llmware-0.2.5-py3-none-any.whl``.
After downloading, place the ``wheel`` archive in a folder.
Finally, navigate to that folder and and run ``pip3 install llmware-0.2.5-py3-none-any.whl``.
On linux, a typical work flow would be the following.

```bash
cd Downloads

mkdir llmware
cd llmware

wget https://github.com/\
llmware-ai/llmware/\
blob/432b5530cda158f57442a3fe4a9f03a20945a41c/\
wheel_archives/llmware-0.2.5-py3-none-any.whl

pip3 install llmware-0.2.5-py3-none-any.whl
```

# When to use llmware

``llmware`` focuses on making it easy to integrate open source small specialized models and connecting enterprise knowledge safely and securely.
Expand Down