Skip to content

Commit 6dbbc5a

Browse files
authored
Merge pull request llmware-ai#874 from llmware-ai/doberst-patch-1
Update README.md
2 parents 92f7a85 + c024573 commit 6dbbc5a

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

‎README.md‎

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -694,6 +694,31 @@ Check out: [llmware examples](https://github.com/llmware-ai/llmware/blob/main/e
694694

695695
</details>
696696

697+
## ✍️ Working with the llmware Github repository
698+
699+
The llmware repo can be pulled locally to get access to all the examples, or to work directly with the latest version of the llmware code.
700+
701+
```bash
702+
git clone git@github.com:llmware-ai/llmware.git
703+
```
704+
705+
We have provided a **welcome_to_llmware** automation script in the root of the repository folder. After cloning:
706+
- On Windows command line: `.\welcome_to_llmware_windows.sh`
707+
- On Mac / Linux command line: `sh ./welcome_to_llmware.sh`
708+
709+
Alternatively, if you prefer to complete setup without the welcome automation script, then the next steps include:
710+
711+
1. **install requirements.txt** - inside the /llmware path - e.g., ```pip3 install -r llmware/requirements.txt```
712+
713+
2. **install requirements_extras.txt** - inside the /llmware path - e.g., ```pip3 install -r llmware/requirements_extras.txt``` (Depending upon your use case, you may not need all or any of these installs, but some of these will be used in the examples.)
714+
715+
3. **run examples** - copy one or more of the example .py files into the root project path. (We have seen several IDEs that will attempt to run interactively from the nested /example path, and then not have access to the /llmware module - the easy fix is to just copy the example you want to run into the root path).
716+
717+
4. **install vector db** - no-install vector db options include milvus lite, chromadb, faiss and lancedb - which do not require a server install, but do require that you install the python sdk library for that vector db, e.g., `pip3 install pymilvus`, or `pip3 install chromadb`. If you look in [examples/Embedding](https://github.com/llmware-ai/llmware/tree/main/examples/Embedding), you will see examples for getting started with various vector DB, and in the root of the repo, you will see easy-to-get-started docker compose scripts for installing milvus, postgres/pgvector, mongo, qdrant, neo4j, and redis.
718+
719+
5. Note: we have seen recently issues with Pytorch==2.3 on some platforms - if you run into any issues, we have seen that uninstalling Pytorch and downleveling to Pytorch==2.1 usually solves the problem.
720+
721+
697722
## Data Store Options
698723

699724
<details>
@@ -761,32 +786,7 @@ curl -o docker-compose.yaml https://raw.githubusercontent.com/llmware-ai/llmware
761786

762787
LLMWare is an open platform and supports a wide range of open source and proprietary models. To use LLMWare, you do not need to use any proprietary LLM - we would encourage you to experiment with [SLIM](https://www.huggingface.co/llmware/), [BLING](https://huggingface.co/llmware), [DRAGON](https://huggingface.co/llmware), [Industry-BERT](https://huggingface.co/llmware), the GGUF examples, along with bringing in your favorite models from HuggingFace and Sentence Transformers.
763788

764-
If you would like to use a proprietary model, you will need to provide your own API Keys. API keys and secrets for models, aws, and pinecone can be set-up for use in environment variables or passed directly to method calls.
765-
766-
767-
## ✍️ Working with the llmware Github repository
768-
769-
The llmware repo can be pulled locally to get access to all the examples, or to work directly with the latest version of the llmware code.
770-
771-
```bash
772-
git clone git@github.com:llmware-ai/llmware.git
773-
```
774-
775-
We have provided a **welcome_to_llmware** automation script in the root of the repository folder. After cloning:
776-
- On Windows command line: `.\welcome_to_llmware_windows.sh`
777-
- On Mac / Linux command line: `sh ./welcome_to_llmware.sh`
778-
779-
Alternatively, if you prefer to complete setup without the welcome automation script, then the next steps include:
780-
781-
1. **install requirements.txt** - inside the /llmware path - e.g., ```pip3 install -r llmware/requirements.txt```
782-
783-
2. **install requirements_extras.txt** - inside the /llmware path - e.g., ```pip3 install -r llmware/requirements_extras.txt``` (Depending upon your use case, you may not need all or any of these installs, but some of these will be used in the examples.)
784-
785-
3. **run examples** - copy one or more of the example .py files into the root project path. (We have seen several IDEs that will attempt to run interactively from the nested /example path, and then not have access to the /llmware module - the easy fix is to just copy the example you want to run into the root path).
786-
787-
4. **install vector db** - no-install vector db options include milvus lite, chromadb, faiss and lancedb - which do not require a server install, but do require that you install the python sdk library for that vector db, e.g., `pip3 install pymilvus`, or `pip3 install chromadb`. If you look in [examples/Embedding](https://github.com/llmware-ai/llmware/tree/main/examples/Embedding), you will see examples for getting started with various vector DB, and in the root of the repo, you will see easy-to-get-started docker compose scripts for installing milvus, postgres/pgvector, mongo, qdrant, neo4j, and redis.
788-
789-
5. Note: we have seen recently issues with Pytorch==2.3 on some platforms - if you run into any issues, we have seen that uninstalling Pytorch and downleveling to Pytorch==2.1 usually solves the problem.
789+
If you would like to use a proprietary model, you will need to provide your own API Keys. API keys and secrets for models, aws, and pinecone can be set-up for use in environment variables or passed directly to method calls.
790790

791791
<details>
792792

0 commit comments

Comments
 (0)