|
|
@@ -1,68 +1,82 @@
|
|
|
---
|
|
|
title: '⚡ Quickstart'
|
|
|
-description: '💡 Start building ChatGPT like apps in a minute on your own data'
|
|
|
+description: '💡 Create a RAG app on your own data in a minute'
|
|
|
---
|
|
|
|
|
|
-Install python package:
|
|
|
+## Installation
|
|
|
+
|
|
|
+First install the python package.
|
|
|
|
|
|
```bash
|
|
|
pip install embedchain
|
|
|
```
|
|
|
|
|
|
-Creating an app involves 3 steps:
|
|
|
-
|
|
|
-<Steps>
|
|
|
- <Step title="⚙️ Import app instance">
|
|
|
- ```python
|
|
|
- from embedchain import App
|
|
|
- app = App()
|
|
|
- ```
|
|
|
- <Accordion title="Customize your app by a simple YAML config" icon="gear-complex">
|
|
|
- Embedchain provides a wide range of options to customize your app. You can customize the model, data sources, and much more.
|
|
|
- Explore the custom configurations [here](https://docs.embedchain.ai/advanced/configuration).
|
|
|
- <CodeGroup>
|
|
|
- ```python yaml_app.py
|
|
|
- from embedchain import App
|
|
|
- app = App.from_config(config_path="config.yaml")
|
|
|
- ```
|
|
|
- ```python json_app.py
|
|
|
- from embedchain import App
|
|
|
- app = App.from_config(config_path="config.json")
|
|
|
- ```
|
|
|
- ```python app.py
|
|
|
- from embedchain import App
|
|
|
- config = {} # Add your config here
|
|
|
- app = App.from_config(config=config)
|
|
|
- ```
|
|
|
- </CodeGroup>
|
|
|
- </Accordion>
|
|
|
- </Step>
|
|
|
- <Step title="🗃️ Add data sources">
|
|
|
- ```python
|
|
|
- app.add("https://en.wikipedia.org/wiki/Elon_Musk")
|
|
|
- app.add("https://www.forbes.com/profile/elon-musk")
|
|
|
- # app.add("path/to/file/elon_musk.pdf")
|
|
|
- ```
|
|
|
- <Accordion title="Embedchain supports adding data from many data sources." icon="files">
|
|
|
- Embedchain supports adding data from many data sources including web pages, PDFs, databases, and more.
|
|
|
- Explore the list of supported [data sources](https://docs.embedchain.ai/data-sources/overview).
|
|
|
- </Accordion>
|
|
|
- </Step>
|
|
|
- <Step title="💬 Ask questions, chat, or search through your data with ease">
|
|
|
- ```python
|
|
|
- app.query("What is the net worth of Elon Musk today?")
|
|
|
- # Answer: The net worth of Elon Musk today is $258.7 billion.
|
|
|
- ```
|
|
|
- <hr />
|
|
|
- <Accordion title="Want to chat with your app?" icon="face-thinking">
|
|
|
- Embedchain provides a wide range of features to interact with your app. You can chat with your app, ask questions, search through your data, and much more.
|
|
|
- ```python
|
|
|
- app.chat("How many companies does Elon Musk run? Name those")
|
|
|
- # Answer: Elon Musk runs 3 companies: Tesla, SpaceX, and Neuralink.
|
|
|
- app.chat("What is his net worth today?")
|
|
|
- # Answer: The net worth of Elon Musk today is $258.7 billion.
|
|
|
- ```
|
|
|
- To learn about other features, click [here](https://docs.embedchain.ai/get-started/introduction)
|
|
|
- </Accordion>
|
|
|
- </Step>
|
|
|
-</Steps>
|
|
|
+Once you have installed the package, depending upon your preference you can either use:
|
|
|
+
|
|
|
+<CardGroup cols={2}>
|
|
|
+ <Card title="Open Source Models" icon="osi" href="#open-source-models">
|
|
|
+ This includes Open source LLMs like Mistral, Llama, etc.<br/>
|
|
|
+ Free to use, and runs locally on your machine.
|
|
|
+ </Card>
|
|
|
+ <Card title="Paid Models" icon="dollar-sign" href="#paid-models" color="#4A154B">
|
|
|
+ This includes paid LLMs like GPT 4, Claude, etc.<br/>
|
|
|
+ Cost money and are accessible via an API.
|
|
|
+ </Card>
|
|
|
+</CardGroup>
|
|
|
+
|
|
|
+## Open Source Models
|
|
|
+
|
|
|
+This section gives a quickstart example of using Mistral as the Open source LLM and Sentence transformers as the Open source embedding model. These models are free and run mostly on your local machine.
|
|
|
+
|
|
|
+We are using Mistral hosted at Hugging Face, so will you need a Hugging Face token to run this example. Its *free* and you can create one [here](https://huggingface.co/docs/hub/security-tokens).
|
|
|
+
|
|
|
+<CodeGroup>
|
|
|
+```python quickstart.py
|
|
|
+import os
|
|
|
+# replace this with your HF key
|
|
|
+os.environ["HUGGINGFACE_ACCESS_TOKEN"] = "hf_xxxx"
|
|
|
+
|
|
|
+from embedchain import App
|
|
|
+app = App.from_config("mistral.yaml")
|
|
|
+app.add("https://www.forbes.com/profile/elon-musk")
|
|
|
+app.add("https://en.wikipedia.org/wiki/Elon_Musk")
|
|
|
+app.query("What is the net worth of Elon Musk today?")
|
|
|
+# Answer: The net worth of Elon Musk today is $258.7 billion.
|
|
|
+```
|
|
|
+```yaml mistral.yaml
|
|
|
+llm:
|
|
|
+ provider: huggingface
|
|
|
+ config:
|
|
|
+ model: 'mistralai/Mistral-7B-v0.1'
|
|
|
+embedder:
|
|
|
+ provider: huggingface
|
|
|
+ config:
|
|
|
+ model: 'sentence-transformers/all-mpnet-base-v2'
|
|
|
+```
|
|
|
+</CodeGroup>
|
|
|
+
|
|
|
+## Paid Models
|
|
|
+
|
|
|
+In this section, we will use both LLM and embedding model from OpenAI.
|
|
|
+
|
|
|
+```python quickstart.py
|
|
|
+import os
|
|
|
+# replace this with your OpenAI key
|
|
|
+os.environ["OPENAI_API_KEY"] = "sk-xxxx"
|
|
|
+
|
|
|
+from embedchain import App
|
|
|
+app = App()
|
|
|
+app.add("https://www.forbes.com/profile/elon-musk")
|
|
|
+app.add("https://en.wikipedia.org/wiki/Elon_Musk")
|
|
|
+app.query("What is the net worth of Elon Musk today?")
|
|
|
+# Answer: The net worth of Elon Musk today is $258.7 billion.
|
|
|
+```
|
|
|
+
|
|
|
+# Next Steps
|
|
|
+
|
|
|
+Now that you have created your first app, you can follow any of the links:
|
|
|
+
|
|
|
+* [Introduction](/get-started/introduction)
|
|
|
+* [Customization](/components/introduction)
|
|
|
+* [Use cases](/use-cases/introduction)
|
|
|
+* [Deployment](/get-started/deployment)
|
Taranjeet Singh
