Added user_id while updating memory (#1613)

Co-authored-by: Deshraj Yadav <deshrajdry@gmail.com>

.env.example

@@ -1 +0,0 @@
-OPENAI_API_KEY="your-openai-api-key"

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -5,7 +5,7 @@ body:
 - type: markdown
   attributes:
     value: >
-      #### Before submitting a bug, please make sure the issue hasn't been already addressed by searching through [the existing and past issues](https://github.com/gventuri/pandas-ai/issues?q=is%3Aissue+sort%3Acreated-desc+).
+      #### Before submitting a bug, please make sure the issue hasn't been already addressed by searching through [the existing and past issues](https://github.com/embedchain/embedchain/issues?q=is%3Aissue+sort%3Acreated-desc+).
 - type: textarea
   attributes:
     label: 🐛 Describe the bug

.github/workflows/cd.yml

@@ -2,14 +2,13 @@ name: Publish Python 🐍 distributions 📦 to PyPI and TestPyPI
 
 on:
   release:
-    types: [published] # This will trigger the workflow when you create a new release
+    types: [published]
 
 jobs:
   build-n-publish:
     name: Build and publish Python 🐍 distributions 📦 to PyPI and TestPyPI
     runs-on: ubuntu-latest
     permissions:
-      # IMPORTANT: this permission is mandatory for trusted publishing
       id-token: write
     steps:
       - uses: actions/checkout@v2
@@ -25,16 +24,23 @@ jobs:
           echo "$HOME/.local/bin" >> $GITHUB_PATH
 
       - name: Install dependencies
-        run: poetry install
+        run: |
+          cd embedchain
+          poetry install
 
       - name: Build a binary wheel and a source tarball
-        run: poetry build
+        run: |
+          cd embedchain
+          poetry build
 
       - name: Publish distribution 📦 to Test PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           repository_url: https://test.pypi.org/legacy/
+          packages_dir: embedchain/dist/
 
       - name: Publish distribution 📦 to PyPI
         if: startsWith(github.ref, 'refs/tags')
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages_dir: embedchain/dist/

.github/workflows/ci.yml

@@ -4,22 +4,40 @@ on:
   push:
     branches: [main]
     paths:
-      - 'embedchain/**'
+      - 'mem0/**'
       - 'tests/**'
-      - 'examples/**'
+      - 'embedchain/**'
   pull_request:
     paths:
-      - 'embedchain/**'
+      - 'mem0/**'
       - 'tests/**'
-      - 'examples/**'
+      - 'embedchain/**'
 
 jobs:
-  build:
+  check_changes:
+    runs-on: ubuntu-latest
+    outputs:
+      mem0_changed: ${{ steps.filter.outputs.mem0 }}
+      embedchain_changed: ${{ steps.filter.outputs.embedchain }}
+    steps:
+    - uses: actions/checkout@v3
+    - uses: dorny/paths-filter@v2
+      id: filter
+      with:
+        filters: |
+          mem0:
+            - 'mem0/**'
+            - 'tests/**'
+          embedchain:
+            - 'embedchain/**'
+
+  build_mem0:
+    needs: check_changes
+    if: needs.check_changes.outputs.mem0_changed == 'true'
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11"]
-
+        python-version: ["3.10", "3.11"]
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python ${{ matrix.python-version }}
@@ -37,17 +55,48 @@ jobs:
         uses: actions/cache@v2
         with:
           path: .venv
-          key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
+          key: venv-mem0-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
       - name: Install dependencies
-        run: poetry install --all-extras
+        run: make install_all
+        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
+      - name: Run tests and generate coverage report
+        run: make test
+
+  build_embedchain:
+    needs: check_changes
+    if: needs.check_changes.outputs.embedchain_changed == 'true'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11"]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: 1.4.2
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+      - name: Load cached venv
+        id: cached-poetry-dependencies
+        uses: actions/cache@v2
+        with:
+          path: .venv
+          key: venv-embedchain-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
+      - name: Install dependencies
+        run: cd embedchain && make install_all
         if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
       - name: Lint with ruff
-        run: make lint
+        run: cd embedchain && make lint
       - name: Run tests and generate coverage report
-        run: make coverage
+        run: cd embedchain && make coverage
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v3
         with:
           file: coverage.xml
         env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.gitignore

@@ -165,6 +165,7 @@ cython_debug/
 # Database
 db
 test-db
+!embedchain/embedchain/core/db/
 
 .vscode
 .idea/
@@ -175,3 +176,11 @@ notebooks/*.yaml
 .ipynb_checkpoints/
 
 !configs/*.yaml
+
+# cache db
+*.db
+
+# local directories for testing
+eval/
+qdrant_storage/
+.crossnote

.pre-commit-config.yaml

@@ -1,20 +0,0 @@
-repos:
-  - repo: https://github.com/psf/black
-    rev: 23.3.0
-    hooks:
-      - id: black
-  - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: 'v0.0.220'
-    hooks:
-      - id: ruff
-        name: ruff
-        # Respect `exclude` and `extend-exclude` settings.
-        args: ["--force-exclude"]
-  - repo: local
-    hooks:
-      - id: pytest-check
-        name: pytest-check
-        entry: poetry run pytest
-        language: system
-        pass_filenames: false
-        always_run: true

Makefile

@@ -1,44 +1,42 @@
-# Variables
-PYTHON := python3
-PIP := $(PYTHON) -m pip
-PROJECT_NAME := embedchain
+.PHONY: format sort lint
 
-# Targets
-.PHONY: install format lint clean test ci_lint ci_test coverage
+# Variables
+ISORT_OPTIONS = --profile black
+PROJECT_NAME := mem0ai
+
+# Default target
+all: format sort lint
 
 install:
 	poetry install
 
 install_all:
-	poetry install --all-extras
-
-install_es:
-	poetry install --extras elasticsearch
-
-install_opensearch:
-	poetry install --extras opensearch
-
-install_milvus:
-	poetry install --extras milvus
-
-shell:
-	poetry shell
-
-py_shell:
-	poetry run python
+	poetry install
+	poetry run pip install groq together boto3 litellm ollama
 
+# Format code with ruff
 format:
-	$(PYTHON) -m black .
-	$(PYTHON) -m isort .
+	poetry run ruff check . --fix $(RUFF_OPTIONS)
 
-clean:
-	rm -rf dist build *.egg-info
+# Sort imports with isort
+sort:
+	poetry run isort . $(ISORT_OPTIONS)
 
+# Lint code with ruff
 lint:
 	poetry run ruff .
 
-test:
-	poetry run pytest $(file)
+docs:
+	cd docs && mintlify dev
 
-coverage:
-	poetry run pytest --cov=$(PROJECT_NAME) --cov-report=xml
+build:
+	poetry build
+
+publish:
+	poetry publish
+
+clean:
+	poetry run rm -rf dist
+
+test:
+	poetry run pytest tests

README.md

@@ -1,140 +1,212 @@
 <p align="center">
-  <img src="docs/logo/dark.svg" width="400px" alt="Embedchain Logo">
+  <img src="docs/images/banner.png" width="800px" alt="Mem0 Logo">
 </p>
 
 <p align="center">
-  <a href="https://runacap.com/ross-index/q3-2023/" target="_blank" rel="noopener"><img style="width: 260px; height: 56px" src="https://runacap.com/wp-content/uploads/2023/10/ROSS_badge_black_Q3_2023.svg" alt="ROSS Index - Fastest Growing Open-Source Startups in Q3 2023 | Runa Capital" width="260" height="56"/></a>
+  <a href="https://mem0.ai/slack">
+    <img src="https://img.shields.io/badge/slack-mem0-brightgreen.svg?logo=slack" alt="Mem0 Slack">
+  </a>
+  <a href="https://mem0.ai/discord">
+    <img src="https://dcbadge.vercel.app/api/server/6PzXDgEjG5?style=flat" alt="Mem0 Discord">
+  </a>
+  <a href="https://x.com/mem0ai">
+    <img src="https://img.shields.io/twitter/follow/mem0ai" alt="Mem0 Twitter">
+  </a>
+  <a href="https://www.ycombinator.com/companies/mem0"><img src="https://img.shields.io/badge/Y%20Combinator-S24-orange?style=flat-square" alt="Y Combinator S24"></a>
+  <a href="https://www.npmjs.com/package/mem0ai"><img src="https://img.shields.io/npm/v/mem0ai?style=flat-square&label=npm+mem0ai" alt="mem0ai npm package"></a>
+  <a href="https://pypi.python.org/pypi/mem0ai"><img src="https://img.shields.io/pypi/v/mem0ai.svg?style=flat-square&label=pypi+mem0ai" alt="mem0ai Python package on PyPi"></a>
+  <a href="https://mem0.ai/email"><img src="https://img.shields.io/badge/substack-mem0-brightgreen.svg?logo=substack&label=mem0+substack" alt="Mem0 newsletter"></a>
 </p>
 
-<p align="center">
-  <a href="https://pypi.org/project/embedchain/">
-    <img src="https://img.shields.io/pypi/v/embedchain" alt="PyPI">
-  </a>
-  <a href="https://join.slack.com/t/embedchain/shared_invite/zt-22uwz3c46-Zg7cIh5rOBteT_xe1jwLDw">
-    <img src="https://img.shields.io/badge/slack-embedchain-brightgreen.svg?logo=slack" alt="Slack">
-  </a>
-  <a href="https://discord.gg/CUU9FPhRNt">
-    <img src="https://dcbadge.vercel.app/api/server/6PzXDgEjG5?style=flat" alt="Discord">
-  </a>
-  <a href="https://twitter.com/embedchain">
-    <img src="https://img.shields.io/twitter/follow/embedchain" alt="Twitter">
-  </a>
-  <a href="https://embedchain.substack.com/">
-    <img src="https://img.shields.io/badge/Substack-%23006f5c.svg?logo=substack" alt="Substack">
-  </a>
-  <a href="https://colab.research.google.com/drive/138lMWhENGeEu7Q1-6lNbNTHGLZXBBz_B?usp=sharing">
-    <img src="https://camo.githubusercontent.com/84f0493939e0c4de4e6dbe113251b4bfb5353e57134ffd9fcab6b8714514d4d1/68747470733a2f2f636f6c61622e72657365617263682e676f6f676c652e636f6d2f6173736574732f636f6c61622d62616467652e737667" alt="Open in Colab">
-  </a>
-  <a href="https://codecov.io/gh/embedchain/embedchain">
-    <img src="https://codecov.io/gh/embedchain/embedchain/graph/badge.svg?token=EMRRHZXW1Q" alt="codecov">
-  </a>
-</p>
+# Mem0: The Memory Layer for Personalized AI
 
-<hr />
+Mem0 provides an intelligent, adaptive memory layer for Large Language Models (LLMs), enhancing personalized AI experiences by retaining and utilizing contextual information across diverse applications. This enhanced memory capability is crucial for applications ranging from customer support and healthcare diagnostics to autonomous systems and personalized content recommendations, allowing AI to remember user preferences, adapt to individual needs, and continuously improve over time.
 
-## What is Embedchain?
-Embedchain is a Data Platform for Large Language Models (LLMs). Seamlessly load, index, retrieve, and sync unstructured data to build dynamic, LLM-powered applications. Check out [embedchain-js](https://github.com/embedchain/embedchain/tree/main/embedchain-js) for a JavaScript implementation.
+## 🚀 Quickstart
 
-## 🔧 Quick install
+### Installation
 
-### Python API
-```bash
-pip install --upgrade embedchain
-```
-
-### REST API
-You can also run Embedchain as a REST API server using the following command:
+The Mem0 package can be installed directly from pip command in the terminal.
 
 ```bash
-docker run --name embedchain -p 8080:8080 embedchain/rest-api:latest
+pip install mem0ai
 ```
 
-Then, navigate to http://0.0.0.0:8080/docs to interact with the API.
+### Basic Usage (Open Source)
 
-## 🔍 Usage and Demo
-
-<!-- Demo GIF or Image -->
-<p align="center">
-  <img src="docs/images/cover.gif" width="900px" alt="Embedchain Demo">
-</p>
-
-For example, you can create an Elon Musk bot using the following code:
+Mem0 supports various LLMs, details of which can be found in our docs, checkout [Supported LLMs](https://docs.mem0.ai/llms). By default, Mem0 is equipped with ```gpt-4o```, and to use it, you need to set the keys in the environment variable.
 
 ```python
 import os
-from embedchain import Pipeline as App
-
-# Create a bot instance
-os.environ["OPENAI_API_KEY"] = "YOUR API KEY"
-elon_bot = App()
-
-# Embed online resources
-elon_bot.add("https://en.wikipedia.org/wiki/Elon_Musk")
-elon_bot.add("https://www.forbes.com/profile/elon-musk")
-elon_bot.add("https://www.youtube.com/watch?v=RcYjXbSJBN8")
-
-# Query the bot
-elon_bot.query("How many companies does Elon Musk run and name those?")
-# Answer: Elon Musk currently runs several companies. As of my knowledge, he is the CEO and lead designer of SpaceX, the CEO and product architect of Tesla, Inc., the CEO and founder of Neuralink, and the CEO and founder of The Boring Company. However, please note that this information may change over time, so it's always good to verify the latest updates.
-
-# (Optional): Deploy app to Embedchain Platform
-app.deploy()
-# 🔑 Enter your Embedchain API key. You can find the API key at https://app.embedchain.ai/settings/keys/
-# ec-xxxxxx
-
-# 🛠️ Creating pipeline on the platform...
-# 🎉🎉🎉 Pipeline created successfully! View your pipeline: https://app.embedchain.ai/pipelines/xxxxx
-
-# 🛠️ Adding data to your pipeline...
-# ✅ Data of type: web_page, value: https://www.forbes.com/profile/elon-musk added successfully.
+os.environ["OPENAI_API_KEY"] = "sk-xxx"
 ```
 
-You can also try it in your browser with Google Colab:
+Now, you can simply initialize the memory.
 
-[![Open in Colab](https://camo.githubusercontent.com/84f0493939e0c4de4e6dbe113251b4bfb5353e57134ffd9fcab6b8714514d4d1/68747470733a2f2f636f6c61622e72657365617263682e676f6f676c652e636f6d2f6173736574732f636f6c61622d62616467652e737667)](https://colab.research.google.com/drive/17ON1LPonnXAtLaZEebnOktstB_1cJJmh?usp=sharing)
+```python
+from mem0 import Memory
+
+m = Memory()
+```
+
+You can perform the following task on the memory.
+1. Add: adds memory
+2. Update: update memory of a given memory_id
+3. Search: fetch memories based on a query
+4. Get: return memories for a certain user/agent/session
+5. History: describes how a memory has changed over time for a specific memory ID
+
+```python
+# 1. Add: Store a memory from any unstructured text
+result = m.add("I am working on improving my tennis skills. Suggest some online courses.", user_id="alice", metadata={"category": "hobbies"})
+
+# Created memory --> 'Improving her tennis skills.' and 'Looking for online suggestions.'
+```
+
+```python
+# 2. Update: update the memory
+result = m.update(memory_id=<memory_id_1>, data="Likes to play tennis on weekends")
+
+# Updated memory --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'
+```
+
+```python
+# 3. Search: search related memories
+related_memories = m.search(query="What are Alice's hobbies?", user_id="alice")
+
+# Retrieved memory --> 'Likes to play tennis on weekends'
+```
+
+```python
+# 4. Get all memories
+all_memories = m.get_all()
+memory_id = all_memories[0]["id"] # get a memory_id
+
+# All memory items --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'
+```
+
+```python
+# 5. Get memory history for a particular memory_id
+history = m.history(memory_id=<memory_id_1>)
+
+# Logs corresponding to memory_id_1 --> {'prev_value': 'Working on improving tennis skills and interested in online courses for tennis.', 'new_value': 'Likes to play tennis on weekends' }
+```
+
+### Mem0 Platform
+
+```python
+from mem0 import MemoryClient
+client = MemoryClient(api_key="your-api-key") # get api_key from https://app.mem0.ai/
+
+# Store messages 
+messages = [
+    {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
+    {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
+]
+result = client.add(messages, user_id="alex")
+print(result)
+
+# Retrieve memories
+all_memories = client.get_all(user_id="alex")
+print(all_memories)
+
+# Search memories
+query = "What do you know about me?"
+related_memories = client.search(query, user_id="alex")
+
+# Get memory history
+history = client.history(memory_id="m1")
+print(history)
+```
+
+> [!TIP]
+> If you are looking for a hosted version and don't want to setup the infrastucture yourself, checkout [Mem0 Platform Docs](https://docs.mem0.ai/platform/quickstart) to get started in minutes.
+
+## 🔑 Core Features
+
+- **Multi-Level Memory**: User, Session, and AI Agent memory retention
+- **Adaptive Personalization**: Continuous improvement based on interactions
+- **Developer-Friendly API**: Simple integration into various applications
+- **Cross-Platform Consistency**: Uniform behavior across devices
+- **Managed Service**: Hassle-free hosted solution
 
 ## 📖 Documentation
-Comprehensive guides and API documentation are available to help you get the most out of Embedchain:
 
-- [Getting Started](https://docs.embedchain.ai/get-started/quickstart)
-- [Introduction](https://docs.embedchain.ai/get-started/introduction#what-is-embedchain)
-- [Examples](https://docs.embedchain.ai/get-started/examples)
-- [Supported data types](https://docs.embedchain.ai/data-sources/)
+For detailed usage instructions and API reference, visit our documentation at [docs.mem0.ai](https://docs.mem0.ai).
 
-## 🔗 Join the Community
+## 🔧 Advanced Usage
 
-Connect with fellow developers and users by joining our [Slack Workspace](https://join.slack.com/t/embedchain/shared_invite/zt-22uwz3c46-Zg7cIh5rOBteT_xe1jwLDw). Dive into discussions, ask questions, and share your experiences.
+For production environments, you can use Qdrant as a vector store:
 
-## 🤝 Schedule a 1-on-1 Session
+```python
+from mem0 import Memory
 
-Book a [1-on-1 Session](https://cal.com/taranjeetio/ec) with Taranjeet, the founder, to discuss any issues, provide feedback, or explore how we can improve Embedchain for you.
-
-## 🌐 Contributing
-
-Contributions are welcome! Please check out the issues on the repository, and feel free to open a pull request.
-For more information, please see the [contributing guidelines](CONTRIBUTING.md).
-
-For more reference, please go through [Development Guide](https://docs.embedchain.ai/contribution/dev) and [Documentation Guide](https://docs.embedchain.ai/contribution/docs).
-
-<a href="https://github.com/embedchain/embedchain/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=embedchain/embedchain" />
-</a>
-
-## Telemetry
-
-We collect anonymous usage metrics to enhance our package's quality and user experience. This includes data like feature usage frequency and system info, but never personal details. The data helps us prioritize improvements and ensure compatibility. If you wish to opt-out, set the `app.config.collect_metrics = False` in the code. We prioritize data security and don't share this data externally.
-
-## Citation
-
-If you utilize this repository, please consider citing it with:
-
-```
-@misc{embedchain,
-  author = {Taranjeet Singh, Deshraj Yadav},
-  title = {Embedchain: Data platform for LLMs - load, index, retrieve, and sync any unstructured data},
-  year = {2023},
-  publisher = {GitHub},
-  journal = {GitHub repository},
-  howpublished = {\url{https://github.com/embedchain/embedchain}},
+config = {
+    "vector_store": {
+        "provider": "qdrant",
+        "config": {
+            "host": "localhost",
+            "port": 6333,
+        }
+    },
 }
+
+m = Memory.from_config(config)
 ```
+
+## 🗺️ Roadmap
+
+- Integration with various LLM providers
+- Support for LLM frameworks
+- Integration with AI Agents frameworks
+- Customizable memory creation/update rules
+- Hosted platform support
+
+## 💰 Pricing
+
+Choose the Mem0 plan that best fits your needs:
+
+### Open Source (Self-hosted)
+Perfect for developers and small teams who want full control over their infrastructure.
+
+### Pro (Hosted)
+Ideal for growing businesses that need a reliable, managed solution with generous free usage. Try the platform [here](https://app.mem0.ai)
+
+### Enterprise (Hosted)
+Designed for large organizations with advanced security, compliance, and scalability needs.
+
+| Feature | Open Source | Pro | Enterprise |
+|---------|-------------|-----|------------|
+| Hosting | Self-hosted | Hosted | Hosted |
+| API Calls | Unlimited | 100K free/month | Custom limits |
+| Support | Community | Email | Dedicated support |
+| Updates | Manual | Automatic | Automatic |
+| SSO | ❌ | ❌ | ✅ |
+| Audit Logs | ❌ | ❌ | ✅ |
+| Custom Integrations | ❌ | ❌ | ✅ |
+| SLA | ❌ | ❌ | ✅ |
+| Advanced Analytics | ❌ | Basic | Advanced |
+| Multi-region Deployment | ❌ | ❌ | ✅ |
+
+[Contact us](mailto:taranjeet@mem0.ai) for Enterprise pricing and custom solutions.
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=mem0ai/mem0&type=Date)](https://star-history.com/#mem0ai/mem0&Date)
+
+## 🙋‍♂️ Support
+Join our Slack or Discord community for support and discussions.
+If you have any questions, feel free to reach out to us using one of the following methods:
+
+- [Join our Discord](https://mem0.ai/discord)
+- [Join our Slack](https://mem0.ai/slack)
+- [Join our newsletter](https://mem0.ai/email)
+- [Follow us on Twitter](https://x.com/mem0ai)
+- [Email us](mailto:founders@mem0.ai)
+
+## 📝 License
+
+This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
+
+> [!NOTE]
+> The Mem0 repository now also includes the Embedchain project. We continue to maintain and support Embedchain ❤️. You can find the Embedchain codebase in the [embedchain](https://github.com/mem0ai/mem0/tree/main/embedchain) directory.

cookbooks/multion_travel_agent.ipynb

@@ -0,0 +1,306 @@
+{
+  "cells": [
+    {
+      "cell_type": "code",
+      "source": [
+        "!pip install mem0ai"
+      ],
+      "metadata": {
+        "id": "fu3euPKZsbaC"
+      },
+      "execution_count": null,
+      "outputs": []
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "U2VC_0FElQid"
+      },
+      "outputs": [],
+      "source": [
+        "import os\n",
+        "from openai import OpenAI\n",
+        "from mem0 import MemoryClient\n",
+        "from multion.client import MultiOn\n",
+        "\n",
+        "# Configuration\n",
+        "OPENAI_API_KEY = 'sk-xxx'  # Replace with your actual OpenAI API key\n",
+        "MULTION_API_KEY = 'xx'  # Replace with your actual MultiOn API key\n",
+        "MEM0_API_KEY = 'xx'  # Replace with your actual Mem0 API key\n",
+        "USER_ID = \"test_travel_agent\"\n",
+        "\n",
+        "# Set up OpenAI API key\n",
+        "os.environ['OPENAI_API_KEY'] = OPENAI_API_KEY\n",
+        "\n",
+        "# Initialize Mem0 and MultiOn\n",
+        "memory = MemoryClient(api_key=MEM0_API_KEY)\n",
+        "multion = MultiOn(api_key=MULTION_API_KEY)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "sq-OdPHKlQie",
+        "outputId": "1d605222-0bf5-4ac9-99b9-6059b502c20b"
+      },
+      "outputs": [
+        {
+          "data": {
+            "text/plain": [
+              "{'message': 'Memory added successfully!'}"
+            ]
+          },
+          "execution_count": 2,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "# Add conversation to Mem0\n",
+        "conversation = [\n",
+        "    {\n",
+        "        \"role\": \"user\",\n",
+        "        \"content\": \"What are the best travel destinations in the world?\"\n",
+        "    },\n",
+        "    {\n",
+        "        \"role\": \"assistant\",\n",
+        "        \"content\": \"Could you please specify your interests or the type of travel information you are looking for? This will help me find the most relevant information for you.\"\n",
+        "    },\n",
+        "    {\n",
+        "        \"role\": \"user\",\n",
+        "        \"content\": \"Sure, I want to travel to San Francisco.\"\n",
+        "    },\n",
+        "    {\n",
+        "        \"role\": \"assistant\",\n",
+        "        \"content\": \"\"\"\n",
+        "        Based on the information gathered from TripAdvisor, here are some popular attractions, activities, and travel tips for San Francisco:\n",
+        "\n",
+        "        1. **Golden Gate Bridge**: A must-see iconic landmark.\n",
+        "        2. **Alcatraz Island**: Famous former prison offering tours.\n",
+        "        3. **Fisherman's Wharf**: Popular tourist area with shops, restaurants, and sea lions.\n",
+        "        4. **Chinatown**: The largest Chinatown outside of Asia.\n",
+        "        5. **Golden Gate Park**: Large urban park with gardens, museums, and recreational activities.\n",
+        "        6. **Cable Cars**: Historic streetcars offering a unique way to see the city.\n",
+        "        7. **Exploratorium**: Interactive science museum.\n",
+        "        8. **San Francisco Museum of Modern Art (SFMOMA)**: Modern and contemporary art museum.\n",
+        "        9. **Lombard Street**: Known for its steep, one-block section with eight hairpin turns.\n",
+        "        10. **Union Square**: Major shopping and cultural hub.\n",
+        "\n",
+        "        Travel Tips:\n",
+        "        - **Weather**: San Francisco has a mild climate, but it can be foggy and windy. Dress in layers.\n",
+        "        - **Transportation**: Use public transportation like BART, Muni, and cable cars to get around.\n",
+        "        - **Safety**: Be aware of your surroundings, especially in crowded tourist areas.\n",
+        "        - **Dining**: Try local specialties like sourdough bread, seafood, and Mission-style burritos.\n",
+        "        \"\"\"\n",
+        "    },\n",
+        "    {\n",
+        "        \"role\": \"user\",\n",
+        "        \"content\": \"Show me hotels around Golden Gate Bridge.\"\n",
+        "    },\n",
+        "    {\n",
+        "        \"role\": \"assistant\",\n",
+        "        \"content\": \"\"\"\n",
+        "        The search results for hotels around Golden Gate Bridge in San Francisco include:\n",
+        "\n",
+        "        1. Hilton Hotels In San Francisco - Hotel Near Fishermans Wharf (hilton.com)\n",
+        "        2. The 10 Closest Hotels to Golden Gate Bridge (tripadvisor.com)\n",
+        "        3. Hotels near Golden Gate Bridge (expedia.com)\n",
+        "        4. Hotels near Golden Gate Bridge (hotels.com)\n",
+        "        5. Holiday Inn Express & Suites San Francisco Fishermans Wharf, an IHG Hotel $146 (1.8K) 3-star hotel Golden Gate Bridge • 3.5 mi DEAL 19% less than usual\n",
+        "        6. Holiday Inn San Francisco-Golden Gateway, an IHG Hotel $151 (3.5K) 3-star hotel Golden Gate Bridge • 3.7 mi Casual hotel with dining, a bar & a pool\n",
+        "        7. Hotel Zephyr San Francisco $159 (3.8K) 4-star hotel Golden Gate Bridge • 3.7 mi Nautical-themed lodging with bay views\n",
+        "        8. Lodge at the Presidio\n",
+        "        9. The Inn Above Tide\n",
+        "        10. Cavallo Point\n",
+        "        11. Casa Madrona Hotel and Spa\n",
+        "        12. Cow Hollow Inn and Suites\n",
+        "        13. Samesun San Francisco\n",
+        "        14. Inn on Broadway\n",
+        "        15. Coventry Motor Inn\n",
+        "        16. HI San Francisco Fisherman's Wharf Hostel\n",
+        "        17. Loews Regency San Francisco Hotel\n",
+        "        18. Fairmont Heritage Place Ghirardelli Square\n",
+        "        19. Hotel Drisco Pacific Heights\n",
+        "        20. Travelodge by Wyndham Presidio San Francisco\n",
+        "        \"\"\"\n",
+        "    }\n",
+        "]\n",
+        "\n",
+        "memory.add(conversation, user_id=USER_ID)\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "hO8z9aNTlQif"
+      },
+      "outputs": [],
+      "source": [
+        "def get_travel_info(question, use_memory=True):\n",
+        "    \"\"\"\n",
+        "    Get travel information based on user's question and optionally their preferences from memory.\n",
+        "\n",
+        "    \"\"\"\n",
+        "    if use_memory:\n",
+        "        previous_memories = memory.search(question, user_id=USER_ID)\n",
+        "        relevant_memories_text = \"\"\n",
+        "        if previous_memories:\n",
+        "            print(\"Using previous memories to enhance the search...\")\n",
+        "            relevant_memories_text = '\\n'.join(mem[\"memory\"] for mem in previous_memories)\n",
+        "\n",
+        "        command = \"Find travel information based on my interests:\"\n",
+        "        prompt = f\"{command}\\n Question: {question} \\n My preferences: {relevant_memories_text}\"\n",
+        "    else:\n",
+        "        command = \"Find travel information based on my interests:\"\n",
+        "        prompt = f\"{command}\\n Question: {question}\"\n",
+        "\n",
+        "\n",
+        "    print(\"Searching for travel information...\")\n",
+        "    browse_result = multion.browse(cmd=prompt)\n",
+        "    return browse_result.message"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "Wp2xpzMrlQig"
+      },
+      "source": [
+        "## Example 1"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "bPRPwqsplQig"
+      },
+      "outputs": [],
+      "source": [
+        "question = \"Show me flight details for it.\"\n",
+        "answer_without_memory = get_travel_info(question, use_memory=False)\n",
+        "answer_with_memory = get_travel_info(question, use_memory=True)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "a76ifa2HlQig"
+      },
+      "source": [
+        "| Without Memory                                                                                                                                                                                                                                     | With Memory                                                                                                                                                                                                                                                                                      |\n",
+        "|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n",
+        "| I have performed a Google search for \"flight details\" and reviewed the search results. Here are some relevant links and information:                                                                                                     | Memorizing the following information: Flight details for San Francisco:                                                                                                                                                                                                                                                                          |\n",
+        "| 1. **FlightStats Global Flight Tracker** - Track the real-time flight status of your flight. See if your flight has been delayed or cancelled and track the live status. <br> [Flight Tracker - FlightStats](https://www.flightstats.com/flight-tracker/search)          | 1. Prices from $232. Depart Thursday, August 22. Return Thursday, August 29. <br> 2. Prices from $216. Depart Friday, August 23. Return Friday, August 30. <br> 3. Prices from $236. Depart Saturday, August 24. Return Saturday, August 31. <br> 4. Prices from $215. Depart Sunday, August 25. Return Sunday, September 1. |\n",
+        "| 2. **FlightAware - Flight Tracker** - Track live flights worldwide, see flight cancellations, and browse by airport. <br> [FlightAware - Flight Tracker](https://www.flightaware.com)                                                | 5. Prices from $218. Depart Monday, August 26. Return Monday, September 2. <br> 6. Prices from $211. Depart Tuesday, August 27. Return Tuesday, September 3. <br> 7. Prices from $198. Depart Wednesday, August 28. Return Wednesday, September 4. <br> 8. Prices from $218. Depart Thursday, August 29. Return Thursday, September 5.          |\n",
+        "| 3. **Google Flights** - Show flights based on your search. <br> [Google Flights](https://www.google.com/flights)                                                                                                                            | 9. Prices from $194. Depart Friday, August 30. Return Friday, September 6. <br> 10. Prices from $218. Depart Saturday, August 31. Return Saturday, September 7. <br> 11. Prices from $212. Depart Sunday, September 1. Return Sunday, September 8. <br> 12. Prices from $247. Depart Monday, September 2. Return Monday, September 9.         |\n",
+        "|                                                                                                                                                                                                                                            | 13. Prices from $212. Depart Tuesday, September 3. Return Tuesday, September 10. <br> 14. Prices from $203. Depart Wednesday, September 4. Return Wednesday, September 11. <br> 15. Prices from $242. Depart Thursday, September 5. Return Thursday, September 12. <br> 16. Prices from $191. Depart Friday, September 6. Return Friday, September 13.     |\n",
+        "|                                                                                                                                                                                                                                            | 17. Prices from $215. Depart Saturday, September 7. Return Saturday, September 14. <br> 18. Prices from $229. Depart Sunday, September 8. Return Sunday, September 15. <br> 19. Prices from $183. Depart Monday, September 9. Return Monday, September 16. <br> 65. Prices from $194. Depart Friday, October 25. Return Friday, November 1.                |\n",
+        "|                                                                                                                                                                                                                                            | 66. Prices from $205. Depart Saturday, October 26. Return Saturday, November 2. <br> 67. Prices from $241. Depart Sunday, October 27. Return Sunday, November 3.                                                                                                                                                    |\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "0cXpiAwMlQig"
+      },
+      "source": [
+        "## Example 2"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "LpprKfpslQih"
+      },
+      "outputs": [],
+      "source": [
+        "question = \"What places to visit there?\"\n",
+        "answer_without_memory = get_travel_info(question, use_memory=False)\n",
+        "answer_with_memory = get_travel_info(question, use_memory=True)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "kpfjeY1_lQih"
+      },
+      "source": [
+        "| Without Memory                                                                                                                                                                                                                                      | With Memory                                                                                                                                                                                                                                                                                            |\n",
+        "|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n",
+        "| Based on the information gathered, here are some top travel destinations to consider visiting:                                                                                                                                              | Based on the information gathered, here are some top places to visit in San Francisco:                                                                                                                                                                                                                 |\n",
+        "| 1. **Paris**: Known for its iconic attractions like the Eiffel Tower and the Louvre, Paris offers quaint cafes, trendy shopping districts, and beautiful Haussmann architecture. It's a city where you can always discover something new with each visit.        | 1. **Golden Gate Bridge** - An iconic symbol of San Francisco, perfect for walking, biking, or simply enjoying the view. <br> 2. **Alcatraz Island** - The historic former prison offers tours and insights into its storied past. <br> 3. **Fisherman's Wharf** - A bustling waterfront area known for its seafood, shopping, and attractions like Pier 39. <br> 4. **Golden Gate Park** - A large urban park with gardens, museums, and recreational activities. <br> 5. **Chinatown San Francisco** - One of the oldest and most famous Chinatowns in North America, offering unique shops and delicious food. <br> 6. **Coit Tower** - Offers panoramic views of the city and murals depicting San Francisco's history. <br> 7. **Lands End** - A beautiful coastal trail with stunning views of the Pacific Ocean and the Golden Gate Bridge. <br> 8. **Palace of Fine Arts** - A picturesque structure and park, perfect for a leisurely stroll or photo opportunities. <br> 9. **Crissy Field & The Presidio Tunnel Tops** - Great for outdoor activities and scenic views of the bay. |\n",
+        "| 2. **Bora Bora**: This small island in French Polynesia is famous for its stunning turquoise waters, luxurious overwater bungalows, and vibrant coral reefs. It's a popular destination for honeymooners and those seeking a tropical paradise.      |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 3. **Glacier National Park**: Located in Montana, USA, this park is known for its breathtaking landscapes, including rugged mountains, pristine lakes, and diverse wildlife. It's a haven for outdoor enthusiasts and hikers.                  |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 4. **Rome**: The capital of Italy, Rome is rich in history and culture, featuring landmarks such as the Colosseum, the Vatican, and the Pantheon. It's a city where ancient history meets modern life.                                          |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 5. **Swiss Alps**: Renowned for their stunning natural beauty, the Swiss Alps offer opportunities for skiing, hiking, and enjoying picturesque mountain villages.                                                                             |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 6. **Maui**: One of Hawaii's most popular islands, Maui is known for its beautiful beaches, lush rainforests, and the scenic Hana Highway. It's a great destination for both relaxation and adventure.                                        |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 7. **London, England**: A vibrant city with a mix of historical landmarks like the Tower of London and modern attractions such as the London Eye. London offers diverse cultural experiences, world-class museums, and a bustling nightlife.    |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 8. **Maldives**: This tropical paradise in the Indian Ocean is famous for its crystal-clear waters, luxurious resorts, and abundant marine life. It's an ideal destination for snorkeling, diving, and relaxation.                            |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 9. **Turks & Caicos**: Known for its pristine beaches and turquoise waters, this Caribbean destination is perfect for water sports, beach lounging, and exploring coral reefs.                                                                 |                                                                                                                                                                                                                                                                                                        |\n",
+        "| 10. **Tokyo**: Japan's bustling capital offers a unique blend of traditional and modern attractions, from ancient temples to futuristic skyscrapers. Tokyo is also known for its vibrant food scene and shopping districts.                   |                                                                                                                                                                                                                                                                                                        |\n"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "XdpkcMrclQih"
+      },
+      "source": [
+        "## Example 3"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "id": "Nntl2FxulQih"
+      },
+      "outputs": [],
+      "source": [
+        "question = \"What the weather there?\"\n",
+        "answer_without_memory = get_travel_info(question, use_memory=False)\n",
+        "answer_with_memory = get_travel_info(question, use_memory=True)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {
+        "id": "yt2pj1irlQih"
+      },
+      "source": [
+        "| Without Memory                                                                                                                                                                                                                                      | With Memory                                                                                                                                                                                                                                                                                            |\n",
+        "|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n",
+        "| The current weather in Paris is light rain with a temperature of 67°F. The precipitation is at 50%, humidity is 95%, and the wind speed is 5 mph.                                                                                   | The current weather in San Francisco is as follows: <br> - **Temperature**: 59°F <br> - **Condition**: Clear with periodic clouds <br> - **Precipitation**: 3% <br> - **Humidity**: 87% <br> - **Wind**: 12 mph                                                                        |\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": ".venv",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.12.3"
+    },
+    "colab": {
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

docs/README.md

@@ -1,7 +1,14 @@
-# Contributing to embedchain docs
+# Mintlify Starter Kit
 
+Click on `Use this template` to copy the Mintlify starter kit. The starter kit contains examples including
 
-### 👩‍💻 Development
+- Guide pages
+- Navigation
+- Customizations
+- API Reference pages
+- Use of popular components
+
+### Development
 
 Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the documentation changes locally. To install, use the following command
 
@@ -15,9 +22,9 @@ Run the following command at the root of your documentation (where mint.json is)
 mintlify dev
 ```
 
-### 😎 Publishing Changes
+### Publishing Changes
 
-Changes will be deployed to production automatically after your PR is merged to the main branch.
+Install our Github App to auto propagate changes from your repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. 
 
 #### Troubleshooting
 

docs/_snippets/get-help.mdx

@@ -1,11 +1,11 @@
 <CardGroup cols={3}>
-  <Card title="Slack" icon="slack" href="https://join.slack.com/t/embedchain/shared_invite/zt-22uwz3c46-Zg7cIh5rOBteT_xe1jwLDw" color="#4A154B">
-    Join our slack community
+  <Card title="Discord" icon="discord" href="https://mem0.ai/discord" color="#7289DA">
+    Join our community
   </Card>
-  <Card title="Discord" icon="discord" href="https://discord.gg/6PzXDgEjG5" color="#7289DA">
-    Join our discord community
+  <Card title="GitHub" icon="github" href="https://github.com/mem0ai/mem0">
+    Star us on GitHub
   </Card>
-  <Card title="Schedule a call" icon="calendar" href="https://cal.com/taranjeetio/ec">
-  Schedule a call with Embedchain founder
+  <Card title="Support" icon="calendar" href="mailto:taranjeet@mem0.ai">
+  Talk to founders
   </Card>
 </CardGroup>

docs/components/embedding-models.mdx

@@ -1,173 +0,0 @@
----
-title: 🧩 Embedding models
----
-
-## Overview
-
-Embedchain supports several embedding models from the following providers:
-
-<CardGroup cols={4}>
-  <Card title="OpenAI" href="#openai"></Card>
-  <Card title="Azure OpenAI" href="#azure-openai"></Card>
-  <Card title="GPT4All" href="#gpt4all"></Card>
-  <Card title="Hugging Face" href="#hugging-face"></Card>
-  <Card title="Vertex AI" href="#vertex-ai"></Card>
-</CardGroup>
-
-## OpenAI
-
-To use OpenAI embedding function, you have to set the `OPENAI_API_KEY` environment variable. You can obtain the OpenAI API key from the [OpenAI Platform](https://platform.openai.com/account/api-keys).
-
-Once you have obtained the key, you can use it like this:
-
-<CodeGroup>
-
-```python main.py
-import os
-from embedchain import Pipeline as App
-
-os.environ['OPENAI_API_KEY'] = 'xxx'
-
-# load embedding model configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-
-app.add("https://en.wikipedia.org/wiki/OpenAI")
-app.query("What is OpenAI?")
-```
-
-```yaml config.yaml
-embedder:
-  provider: openai
-  config:
-    model: 'text-embedding-ada-002'
-```
-
-</CodeGroup>
-
-## Azure OpenAI
-
-To use Azure OpenAI embedding model, you have to set some of the azure openai related environment variables as given in the code block below:
-
-<CodeGroup>
-
-```python main.py
-import os
-from embedchain import Pipeline as App
-
-os.environ["OPENAI_API_TYPE"] = "azure"
-os.environ["AZURE_OPENAI_ENDPOINT"] = "https://xxx.openai.azure.com/"
-os.environ["AZURE_OPENAI_API_KEY"] = "xxx"
-os.environ["OPENAI_API_VERSION"] = "xxx"
-
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: azure_openai
-  config:
-    model: gpt-35-turbo
-    deployment_name: your_llm_deployment_name
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-
-embedder:
-  provider: azure_openai
-  config:
-    model: text-embedding-ada-002
-    deployment_name: you_embedding_model_deployment_name
-```
-</CodeGroup>
-
-You can find the list of models and deployment name on the [Azure OpenAI Platform](https://oai.azure.com/portal).
-
-## GPT4ALL
-
-GPT4All supports generating high quality embeddings of arbitrary length documents of text using a CPU optimized contrastively trained Sentence Transformer.
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load embedding model configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: gpt4all
-  config:
-    model: 'orca-mini-3b-gguf2-q4_0.gguf'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-
-embedder:
-  provider: gpt4all
-```
-
-</CodeGroup>
-
-## Hugging Face
-
-Hugging Face supports generating embeddings of arbitrary length documents of text using Sentence Transformer library. Example of how to generate embeddings using hugging face is given below:
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load embedding model configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: huggingface
-  config:
-    model: 'google/flan-t5-xxl'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 0.5
-    stream: false
-
-embedder:
-  provider: huggingface
-  config:
-    model: 'sentence-transformers/all-mpnet-base-v2'
-```
-
-</CodeGroup>
-
-## Vertex AI
-
-Embedchain supports Google's VertexAI embeddings model through a simple interface. You just have to pass the `model_name` in the config yaml and it would work out of the box.
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load embedding model configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: vertexai
-  config:
-    model: 'chat-bison'
-    temperature: 0.5
-    top_p: 0.5
-
-embedder:
-  provider: vertexai
-  config:
-    model: 'textembedding-gecko'
-```
-
-</CodeGroup>

docs/components/llms.mdx

@@ -1,21 +1,22 @@
 ---
-title: 🤖 Large language models (LLMs)
+title: 🤖 LLMs
 ---
 
 ## Overview
 
-Embedchain comes with built-in support for various popular large language models. We handle the complexity of integrating these models for you, allowing you to easily customize your language model interactions through a user-friendly interface.
+Mem0 includes built-in support for various popular large language models. Memory can utilize the LLM provided by the user, ensuring efficient use for specific needs.
 
 <CardGroup cols={4}>
   <Card title="OpenAI" href="#openai"></Card>
-  <Card title="Azure OpenAI" href="#azure-openai"></Card>
+  <Card title="Ollama" href="#ollama"></Card>
+  <Card title="Groq" href="#groq"></Card>
+  <Card title="Together" href="#together"></Card>
+  <Card title="AWS Bedrock" href="#aws-bedrock"></Card>
+  <Card title="Litellm" href="#litellm"></Card>
+  <Card title="Google AI" href="#google-ai"></Card>
   <Card title="Anthropic" href="#anthropic"></Card>
-  <Card title="Cohere" href="#cohere"></Card>
-  <Card title="GPT4All" href="#gpt4all"></Card>
-  <Card title="JinaChat" href="#jinachat"></Card>
-  <Card title="Hugging Face" href="#hugging-face"></Card>
-  <Card title="Llama2" href="#llama2"></Card>
-  <Card title="Vertex AI" href="#vertex-ai"></Card>
+  <Card title="Mistral AI" href="#mistral-ai"></Card>
+  <Card title="OpenAI Azure" href="#openai-azure"></Card>
 </CardGroup>
 
 ## OpenAI
@@ -26,300 +27,268 @@ Once you have obtained the key, you can use it like this:
 
 ```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ['OPENAI_API_KEY'] = 'xxx'
+os.environ["OPENAI_API_KEY"] = "your-api-key"
 
-app = App()
-app.add("https://en.wikipedia.org/wiki/OpenAI")
-app.query("What is OpenAI?")
+config = {
+    "llm": {
+        "provider": "openai",
+        "config": {
+            "model": "gpt-4o",
+            "temperature": 0.2,
+            "max_tokens": 1500,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
 
-If you are looking to configure the different parameters of the LLM, you can do so by loading the app using a [yaml config](https://github.com/embedchain/embedchain/blob/main/configs/chroma.yaml) file.
+## Ollama
 
-<CodeGroup>
+You can use LLMs from Ollama to run Mem0 locally. These [models](https://ollama.com/search?c=tools) support tool support.
 
-```python main.py
+```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ['OPENAI_API_KEY'] = 'xxx'
+os.environ["OPENAI_API_KEY"] = "your-api-key" # for embedder
 
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
+config = {
+    "llm": {
+        "provider": "ollama",
+        "config": {
+            "model": "mixtral:8x7b",
+            "temperature": 0.1,
+            "max_tokens": 2000,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
 
-```yaml config.yaml
-llm:
-  provider: openai
-  config:
-    model: 'gpt-3.5-turbo'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-```
+## Groq
 
-</CodeGroup>
+[Groq](https://groq.com/) is the creator of the world's first Language Processing Unit (LPU), providing exceptional speed performance for AI workloads running on their LPU Inference Engine.
 
+In order to use LLMs from Groq, go to their [platform](https://console.groq.com/keys) and get the API key. Set the API key as `GROQ_API_KEY` environment variable to use the model as given below in the example.
 
-## Azure OpenAI
-
-To use Azure OpenAI model, you have to set some of the azure openai related environment variables as given in the code block below:
-
-<CodeGroup>
-
-```python main.py
+```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ["OPENAI_API_TYPE"] = "azure"
-os.environ["OPENAI_API_BASE"] = "https://xxx.openai.azure.com/"
-os.environ["OPENAI_API_KEY"] = "xxx"
-os.environ["OPENAI_API_VERSION"] = "xxx"
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ["GROQ_API_KEY"] = "your-api-key"
 
-app = App.from_config(config_path="config.yaml")
+config = {
+    "llm": {
+        "provider": "groq",
+        "config": {
+            "model": "mixtral-8x7b-32768",
+            "temperature": 0.1,
+            "max_tokens": 1000,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
 
-```yaml config.yaml
-llm:
-  provider: azure_openai
-  config:
-    model: gpt-35-turbo
-    deployment_name: your_llm_deployment_name
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
+## Together
 
-embedder:
-  provider: azure_openai
-  config:
-    model: text-embedding-ada-002
-    deployment_name: you_embedding_model_deployment_name
+To use TogetherAI LLM models, you have to set the `TOGETHER_API_KEY` environment variable. You can obtain the TogetherAI API key from their [Account settings page](https://api.together.xyz/settings/api-keys).
+
+Once you have obtained the key, you can use it like this:
+
+```python
+import os
+from mem0 import Memory
+
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ["TOGETHER_API_KEY"] = "your-api-key"
+
+config = {
+    "llm": {
+        "provider": "togetherai",
+        "config": {
+            "model": "mistralai/Mixtral-8x7B-Instruct-v0.1",
+            "temperature": 0.2,
+            "max_tokens": 1500,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
-</CodeGroup>
 
-You can find the list of models and deployment name on the [Azure OpenAI Platform](https://oai.azure.com/portal).
+## AWS Bedrock
+
+### Setup
+- Before using the AWS Bedrock LLM, make sure you have the appropriate model access from [Bedrock Console](https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/modelaccess).
+- You will also need to authenticate the `boto3` client by using a method in the [AWS documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html#configuring-credentials)
+- You will have to export `AWS_REGION`, `AWS_ACCESS_KEY`, and `AWS_SECRET_ACCESS_KEY` to set environment variables.
+
+```python
+import os
+from mem0 import Memory
+
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ['AWS_REGION'] = 'us-east-1'
+os.environ["AWS_ACCESS_KEY"] = "xx"
+os.environ["AWS_SECRET_ACCESS_KEY"] = "xx"
+
+config = {
+    "llm": {
+        "provider": "aws_bedrock",
+        "config": {
+            "model": "arn:aws:bedrock:us-east-1:123456789012:model/your-model-name",
+            "temperature": 0.2,
+            "max_tokens": 1500,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```
+
+## Litellm
+
+[Litellm](https://litellm.vercel.app/docs/) is compatible with over 100 large language models (LLMs), all using a standardized input/output format. You can explore the [available models]((https://litellm.vercel.app/docs/providers)) to use with Litellm. Ensure you set the `API_KEY` for the model you choose to use.
+
+```python
+import os
+from mem0 import Memory
+
+os.environ["OPENAI_API_KEY"] = "your-api-key"
+
+config = {
+    "llm": {
+        "provider": "litellm",
+        "config": {
+            "model": "gpt-3.5-turbo",
+            "temperature": 0.2,
+            "max_tokens": 1500,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```
+
+## Google AI
+
+To use Google AI model, you have to set the `GOOGLE_API_KEY` environment variable. You can obtain the Google API key from the [Google Maker Suite](https://makersuite.google.com/app/apikey)
+
+Once you have obtained the key, you can use it like this:
+
+```python
+import os
+from mem0 import Memory
+
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ["GEMINI_API_KEY"] = "your-api-key"
+
+config = {
+    "llm": {
+        "provider": "litellm",
+        "config": {
+            "model": "gemini/gemini-pro",
+            "temperature": 0.2,
+            "max_tokens": 1500,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```
 
 ## Anthropic
 
-To use anthropic's model, please set the `ANTHROPIC_API_KEY` which you find on their [Account Settings Page](https://console.anthropic.com/account/keys).
+To use anthropic's models, please set the `ANTHROPIC_API_KEY` which you find on their [Account Settings Page](https://console.anthropic.com/account/keys).
 
-<CodeGroup>
-
-```python main.py
+```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ["ANTHROPIC_API_KEY"] = "xxx"
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ["ANTHROPIC_API_KEY"] = "your-api-key"
 
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
+config = {
+    "llm": {
+        "provider": "litellm",
+        "config": {
+            "model": "claude-3-opus-20240229",
+            "temperature": 0.1,
+            "max_tokens": 2000,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
 
-```yaml config.yaml
-llm:
-  provider: anthropic
-  config:
-    model: 'claude-instant-1'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-```
+## Mistral AI
 
-</CodeGroup>
+To use mistral's models, please Obtain the Mistral AI api key from their [console](https://console.mistral.ai/). Set the `MISTRAL_API_KEY` environment variable to use the model as given below in the example.
 
-## Cohere
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[cohere]'
-```
-
-Set the `COHERE_API_KEY` as environment variable which you can find on their [Account settings page](https://dashboard.cohere.com/api-keys).
-
-Once you have the API key, you are all set to use it with Embedchain.
-
-<CodeGroup>
-
-```python main.py
+```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ["COHERE_API_KEY"] = "xxx"
+os.environ["OPENAI_API_KEY"] = "your-api-key" # used for embedding model
+os.environ["MISTRAL_API_KEY"] = "your-api-key"
 
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
+config = {
+    "llm": {
+        "provider": "litellm",
+        "config": {
+            "model": "open-mixtral-8x7b",
+            "temperature": 0.1,
+            "max_tokens": 2000,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
 
-```yaml config.yaml
-llm:
-  provider: cohere
-  config:
-    model: large
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-```
+## OpenAI Azure
 
-</CodeGroup>
+To use Azure AI models, you have to set the `AZURE_API_KEY`, `AZURE_API_BASE`, and `AZURE_API_VERSION` environment variables. You can obtain the Azure API key from the [Azure](https://azure.microsoft.com/).
 
-## GPT4ALL
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[opensource]'
-```
-
-GPT4all is a free-to-use, locally running, privacy-aware chatbot. No GPU or internet required. You can use this with Embedchain using the following code:
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: gpt4all
-  config:
-    model: 'orca-mini-3b-gguf2-q4_0.gguf'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-
-embedder:
-  provider: gpt4all
-```
-</CodeGroup>
-
-
-## JinaChat
-
-First, set `JINACHAT_API_KEY` in environment variable which you can obtain from [their platform](https://chat.jina.ai/api).
-
-Once you have the key, load the app using the config yaml file:
-
-<CodeGroup>
-
-```python main.py
+```python
 import os
-from embedchain import Pipeline as App
+from mem0 import Memory
 
-os.environ["JINACHAT_API_KEY"] = "xxx"
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
+
+os.environ["AZURE_API_KEY"] = "your-api-key"
+
+# Needed to use custom models
+os.environ["AZURE_API_BASE"] = "your-api-base-url"
+os.environ["AZURE_API_VERSION"] = "version-to-use"
+
+config = {
+    "llm": {
+        "provider": "litellm",
+        "config": {
+            "model": "azure_ai/command-r-plus",
+            "temperature": 0.1,
+            "max_tokens": 2000,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
 ```
-
-```yaml config.yaml
-llm:
-  provider: jina
-  config:
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 1
-    stream: false
-```
-</CodeGroup>
-
-
-## Hugging Face
-
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[huggingface-hub]'
-```
-
-First, set `HUGGINGFACE_ACCESS_TOKEN` in environment variable which you can obtain from [their platform](https://huggingface.co/settings/tokens).
-
-Once you have the token, load the app using the config yaml file:
-
-<CodeGroup>
-
-```python main.py
-import os
-from embedchain import Pipeline as App
-
-os.environ["HUGGINGFACE_ACCESS_TOKEN"] = "xxx"
-
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: huggingface
-  config:
-    model: 'google/flan-t5-xxl'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 0.5
-    stream: false
-```
-</CodeGroup>
-
-## Llama2
-
-Llama2 is integrated through [Replicate](https://replicate.com/).  Set `REPLICATE_API_TOKEN` in environment variable which you can obtain from [their platform](https://replicate.com/account/api-tokens).
-
-Once you have the token, load the app using the config yaml file:
-
-<CodeGroup>
-
-```python main.py
-import os
-from embedchain import Pipeline as App
-
-os.environ["REPLICATE_API_TOKEN"] = "xxx"
-
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: llama2
-  config:
-    model: 'a16z-infra/llama13b-v2-chat:df7690f1994d94e96ad9d568eac121aecf50684a0b0963b25a41cc40061269e5'
-    temperature: 0.5
-    max_tokens: 1000
-    top_p: 0.5
-    stream: false
-```
-</CodeGroup>
-
-## Vertex AI
-
-Setup Google Cloud Platform application credentials by following the instruction on [GCP](https://cloud.google.com/docs/authentication/external/set-up-adc). Once setup is done, use the following code to create an app using VertexAI as provider:
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load llm configuration from config.yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-llm:
-  provider: vertexai
-  config:
-    model: 'chat-bison'
-    temperature: 0.5
-    top_p: 0.5
-```
-</CodeGroup>
-
-<br/ >
-<Snippet file="missing-llm-tip.mdx" />

docs/components/vector-databases.mdx

@@ -1,227 +0,0 @@
----
-title: 🗄️ Vector databases
----
-
-## Overview
-
-Utilizing a vector database alongside Embedchain is a seamless process. All you need to do is configure it within the YAML configuration file. We've provided examples for each supported database below:
-
-<CardGroup cols={4}>
-  <Card title="ChromaDB" href="#chromadb"></Card>
-  <Card title="Elasticsearch" href="#elasticsearch"></Card>
-  <Card title="OpenSearch" href="#opensearch"></Card>
-  <Card title="Zilliz" href="#zilliz"></Card>
-  <Card title="LanceDB" href="#lancedb"></Card>
-  <Card title="Pinecone" href="#pinecone"></Card>
-  <Card title="Qdrant" href="#qdrant"></Card>
-  <Card title="Weaviate" href="#weaviate"></Card>
-</CardGroup>
-
-## ChromaDB
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load chroma configuration from yaml file
-app = App.from_config(config_path="config1.yaml")
-```
-
-```yaml config1.yaml
-vectordb:
-  provider: chroma
-  config:
-    collection_name: 'my-collection'
-    dir: db
-    allow_reset: true
-```
-
-```yaml config2.yaml
-vectordb:
-  provider: chroma
-  config:
-    collection_name: 'my-collection'
-    host: localhost
-    port: 5200
-    allow_reset: true
-```
-
-</CodeGroup>
-
-
-## Elasticsearch
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[elasticsearch]'
-```
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load elasticsearch configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: elasticsearch
-  config:
-    collection_name: 'es-index'
-    es_url: http://localhost:9200
-    http_auth:
-      - admin
-      - admin
-    api_key: xxx
-    verify_certs: false
-```
-</CodeGroup>
-
-## OpenSearch
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[opensearch]'
-```
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load opensearch configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: opensearch
-  config:
-    collection_name: 'my-app'
-    opensearch_url: 'https://localhost:9200'
-    http_auth:
-      - admin
-      - admin
-    vector_dimension: 1536
-    use_ssl: false
-    verify_certs: false
-```
-
-</CodeGroup>
-
-## Zilliz
-
-Install related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[milvus]'
-```
-
-Set the Zilliz environment variables `ZILLIZ_CLOUD_URI` and `ZILLIZ_CLOUD_TOKEN` which you can find it on their [cloud platform](https://cloud.zilliz.com/).
-
-<CodeGroup>
-
-```python main.py
-import os
-from embedchain import Pipeline as App
-
-os.environ['ZILLIZ_CLOUD_URI'] = 'https://xxx.zillizcloud.com'
-os.environ['ZILLIZ_CLOUD_TOKEN'] = 'xxx'
-
-# load zilliz configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: zilliz
-  config:
-    collection_name: 'zilliz_app'
-    uri: https://xxxx.api.gcp-region.zillizcloud.com
-    token: xxx
-    vector_dim: 1536
-    metric_type: L2
-```
-
-</CodeGroup>
-
-## LanceDB
-
-_Coming soon_
-
-## Pinecone
-
-Install pinecone related dependencies using the following command:
-
-```bash
-pip install --upgrade 'embedchain[pinecone]'
-```
-
-In order to use Pinecone as vector database, set the environment variables `PINECONE_API_KEY` and `PINECONE_ENV` which you can find on [Pinecone dashboard](https://app.pinecone.io/).
-
-<CodeGroup>
-
-```python main.py
-from embedchain import Pipeline as App
-
-# load pinecone configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: pinecone
-  config:
-    metric: cosine
-    vector_dimension: 1536
-    collection_name: my-pinecone-index
-```
-
-</CodeGroup>
-
-## Qdrant
-
-In order to use Qdrant as a vector database, set the environment variables `QDRANT_URL` and `QDRANT_API_KEY` which you can find on [Qdrant Dashboard](https://cloud.qdrant.io/).
-
-<CodeGroup>
-```python main.py
-from embedchain import Pipeline as App
-
-# load qdrant configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: qdrant
-  config:
-    collection_name: my_qdrant_index
-```
-</CodeGroup>
-
-## Weaviate
-
-In order to use Weaviate as a vector database, set the environment variables `WEAVIATE_ENDPOINT` and `WEAVIATE_API_KEY` which you can find on [Weaviate dashboard](https://console.weaviate.cloud/dashboard).
-
-<CodeGroup>
-```python main.py
-from embedchain import Pipeline as App
-
-# load weaviate configuration from yaml file
-app = App.from_config(config_path="config.yaml")
-```
-
-```yaml config.yaml
-vectordb:
-  provider: weaviate
-  config:
-    collection_name: my_weaviate_index
-```
-</CodeGroup>
-
-<Snippet file="missing-vector-db-tip.mdx" />

docs/components/vectordb.mdx

@@ -0,0 +1,64 @@
+---
+title: 🗄 Vector Databases
+---
+
+## Overview
+
+Mem0 includes built-in support for various popular databases. Memory can utilize the database provided by the user, ensuring efficient use for specific needs.
+
+<CardGroup>
+    <Card title="Qdrant" href="#qdrant"></Card>
+    <Card title="Chroma" href="#chroma"></Card>
+</CardGroup>
+
+
+## Qdrant
+
+[Qdrant](https://qdrant.tech/) is an open-source vector search engine. It is designed to work with large-scale datasets and provides a high-performance search engine for vector data.
+
+To use Qdrant you can do like this:
+
+```python
+import os
+from mem0 import Memory
+
+
+config = {
+    "vectordb": {
+        "provider": "qdrant",
+        "config": {
+            "collection_name": "test",
+            "host": "localhost",
+            "port": 6333,
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```
+
+## Chroma
+
+[Chroma](https://www.trychroma.com/) is an AI-native open-source vector database that simplifies building LLM apps by providing tools for storing, embedding, and searching embeddings with a focus on simplicity and speed.
+
+To use ChromaDB you can do like this:
+
+```python
+import os
+from mem0 import Memory
+
+
+config = {
+    "vectordb": {
+        "provider": "chromadb",
+        "config": {
+            "collection_name": "test",
+            "path": "db",
+        }
+    }
+}
+
+m = Memory.from_config(config)
+m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```

docs/contribution/guidelines.mdx

@@ -1,4 +0,0 @@
----
-title: '📋 Guidelines'
-url: https://github.com/embedchain/embedchain/blob/main/CONTRIBUTING.md
----

docs/contribution/javascript.mdx

@@ -1,4 +0,0 @@
----
-title: ' 🟨 Javascript'
-url: https://github.com/embedchain/embedchain/tree/main/embedchain-js
----

docs/data-sources/csv.mdx

@@ -1,19 +0,0 @@
----
-title: '📊 CSV'
----
-
-To add any csv file, use the data_type as `csv`. `csv` allows remote urls and conventional file paths. Headers are included for each line, so if you have an `age` column, `18` will be added as `age: 18`. Eg:
-
-```python
-from embedchain import Pipeline as App
-
-app = App()
-app.add('https://people.sc.fsu.edu/~jburkardt/data/csv/airtravel.csv', data_type="csv")
-# Or add using the local file path
-# app.add('/path/to/file.csv', data_type="csv")
-
-app.query("Summarize the air travel data")
-# Answer: The air travel data shows the number of flights for the months of July in the years 1958, 1959, and 1960. In July 1958, there were 491 flights, in July 1959 there were 548 flights, and in July 1960 there were 622 flights.
-```
-
-Note: There is a size limit allowed for csv file beyond which it can throw error. This limit is set by the LLMs. Please consider chunking large csv files into smaller csv files.

docs/data-sources/overview.mdx

@@ -1,34 +0,0 @@
----
-title: Overview
----
-
-Embedchain comes with built-in support for various data sources. We handle the complexity of loading unstructured data from these data sources, allowing you to easily customize your app through a user-friendly interface.
-
-<CardGroup cols={4}>
-  <Card title="📊 CSV" href="/data-sources/csv"></Card>
-  <Card title="📃 JSON" href="/data-sources/json"></Card>
-  <Card title="📚 docs site" href="/data-sources/docs-site"></Card>
-  <Card title="📄 docx" href="/data-sources/docx"></Card>
-  <Card title="📝 mdx" href="/data-sources/mdx"></Card>
-  <Card title="📓 Notion" href="/data-sources/notion"></Card>
-  <Card title="📰 PDF" href="/data-sources/pdf-file"></Card>
-  <Card title="❓💬 q&a pair" href="/data-sources/qna"></Card>
-  <Card title="🗺️ sitemap" href="/data-sources/sitemap"></Card>
-  <Card title="📝 text" href="/data-sources/text"></Card>
-  <Card title="🌐 web page" href="/data-sources/web-page"></Card>
-  <Card title="🧾 xml" href="/data-sources/xml"></Card>
-  <Card title="🙌 OpenAPI" href="/data-sources/openapi"></Card>
-  <Card title="📺 Youtube" href="/data-sources/youtube-video"></Card>
-  <Card title="📬 Gmail" href="/data-sources/gmail"></Card>
-  <Card title="🐘 Postgres" href="/data-sources/postgres"></Card>
-  <Card title="🐬 MySQL" href="/data-sources/mysql"></Card>
-  <Card title="🤖 Slack" href="/data-sources/slack"></Card>
-  <Card title="🗨️ Discourse" href="/data-sources/discourse"></Card>
-  <Card title="💬 Discord" href="/data-sources/discord"></Card>
-  <Card title="📝 Github" href="/data-sources/github"></Card>
-  <Card title="⚙️ Custom" href="/data-sources/custom"></Card>
-</CardGroup>
-
-<br/ >
-
-<Snippet file="missing-data-source-tip.mdx" />

docs/data-sources/pdf-file.mdx

@@ -1,17 +0,0 @@
----
-title: '📰 PDF file'
----
-
-To add any pdf file, use the data_type as `pdf_file`. Eg:
-
-```python
-from embedchain import Pipeline as App
-
-app = App()
-
-app.add('https://arxiv.org/pdf/1706.03762.pdf', data_type='pdf_file')
-app.query("What is the paper 'attention is all you need' about?")
-# Answer: The paper "Attention Is All You Need" proposes a new network architecture called the Transformer, which is based solely on attention mechanisms. It suggests moving away from complex recurrent or convolutional neural networks and instead using attention mechanisms to connect the encoder and decoder in sequence transduction models.
-```
-
-Note that we do not support password protected pdfs.

docs/data-sources/substack.mdx

@@ -1,16 +0,0 @@
----
-title: "📝 Substack"
----
-
-To add any Substack data sources to your app, just add the sitemap.xml of that url as the source and set the data_type to `substack`.
-
-```python
-from embedchain import Pipeline as App
-
-app = App()
-
-# source: for any substack just add the sitemap.xml url
-app.add('https://www.lennysnewsletter.com/sitemap.xml', data_type='substack')
-app.query("Who is Brian Chesky?")
-# Answer: Brian Chesky is the co-founder and CEO of Airbnb.
-```

docs/data-sources/youtube-video.mdx

@@ -1,13 +0,0 @@
----
-title: '📺 Youtube'
----
-
-
-To add any youtube video to your app, use the data_type (first argument to `.add()` method) as `youtube_video`. Eg:
-
-```python
-from embedchain import Pipeline as App
-
-app = App()
-app.add('a_valid_youtube_url_here', data_type='youtube_video')
-```

docs/examples/customer-support-agent.mdx

@@ -0,0 +1,109 @@
+---
+title: Customer Support AI Agent
+---
+
+You can create a personalized Customer Support AI Agent using Mem0. This guide will walk you through the necessary steps and provide the complete code to get you started.
+
+## Overview
+
+The Customer Support AI Agent leverages Mem0 to retain information across interactions, enabling a personalized and efficient support experience.
+
+## Setup
+
+Install the necessary packages using pip:
+
+```bash
+pip install openai mem0ai
+```
+
+## Full Code Example
+
+Below is the simplified code to create and interact with a Customer Support AI Agent using Mem0:
+
+```python
+from openai import OpenAI
+from mem0 import Memory
+
+# Set the OpenAI API key
+os.environ['OPENAI_API_KEY'] = 'sk-xxx'
+
+class CustomerSupportAIAgent:
+    def __init__(self):
+        """
+        Initialize the CustomerSupportAIAgent with memory configuration and OpenAI client.
+        """
+        config = {
+            "vector_store": {
+                "provider": "qdrant",
+                "config": {
+                    "host": "localhost",
+                    "port": 6333,
+                }
+            },
+        }
+        self.memory = Memory.from_config(config)
+        self.client = OpenAI()
+        self.app_id = "customer-support"
+
+    def handle_query(self, query, user_id=None):
+        """
+        Handle a customer query and store the relevant information in memory.
+
+        :param query: The customer query to handle.
+        :param user_id: Optional user ID to associate with the memory.
+        """
+        # Start a streaming chat completion request to the AI
+        stream = self.client.chat.completions.create(
+            model="gpt-4",
+            stream=True,
+            messages=[
+                {"role": "system", "content": "You are a customer support AI agent."},
+                {"role": "user", "content": query}
+            ]
+        )
+        # Store the query in memory
+        self.memory.add(query, user_id=user_id, metadata={"app_id": self.app_id})
+
+        # Print the response from the AI in real-time
+        for chunk in stream:
+            if chunk.choices[0].delta.content is not None:
+                print(chunk.choices[0].delta.content, end="")
+
+    def get_memories(self, user_id=None):
+        """
+        Retrieve all memories associated with the given customer ID.
+
+        :param user_id: Optional user ID to filter memories.
+        :return: List of memories.
+        """
+        return self.memory.get_all(user_id=user_id)
+
+# Instantiate the CustomerSupportAIAgent
+support_agent = CustomerSupportAIAgent()
+
+# Define a customer ID
+customer_id = "jane_doe"
+
+# Handle a customer query
+support_agent.handle_query("I need help with my recent order. It hasn't arrived yet.", user_id=customer_id)
+```
+
+### Fetching Memories
+
+You can fetch all the memories at any point in time using the following code:
+
+```python
+memories = support_agent.get_memories(user_id=customer_id)
+for m in memories:
+    print(m['text'])
+```
+
+### Key Points
+
+- **Initialization**: The CustomerSupportAIAgent class is initialized with the necessary memory configuration and OpenAI client setup.
+- **Handling Queries**: The handle_query method sends a query to the AI and stores the relevant information in memory.
+- **Retrieving Memories**: The get_memories method fetches all stored memories associated with a customer.
+
+### Conclusion
+
+As the conversation progresses, Mem0's memory automatically updates based on the interactions, providing a continuously improving personalized support experience.

docs/examples/overview.mdx

@@ -0,0 +1,32 @@
+---
+title: Overview
+description: How to use mem0 in your existing applications?
+---
+
+
+With Mem0, you can create stateful LLM-based applications such as chatbots, virtual assistants, or AI agents. Mem0 enhances your applications by providing a memory layer that makes responses:
+
+- More personalized
+- More reliable
+- Cost-effective by reducing the number of LLM interactions
+- More engaging
+- Enables long-term memory
+
+Here are some examples of how Mem0 can be integrated into various applications:
+
+## Example Use Cases
+
+<CardGroup cols={1}>
+  <Card title="Personal AI Tutor" icon="square-1" href="/examples/personal-ai-tutor">
+    <img width="100%" src="/images/ai-tutor.png" />
+    Create a Personalized AI Tutor that adapts to student progress and learning preferences.
+  </Card>
+  <Card title="Personal Travel Assistant" icon="square-2" href="/examples/personal-travel-assistant">
+    <img src="/images/personal-travel-agent.png" />
+    Build a Personalized AI Travel Assistant that understands your travel preferences and past itineraries.
+  </Card>
+  <Card title="Customer Support Agent" icon="square-3" href="/examples/customer-support-agent">
+    <img width="100%" src="/images/customer-support-agent.png" />
+    Develop a Personal AI Assistant that remembers user preferences, past interactions, and context to provide personalized and efficient assistance.
+  </Card>
+</CardGroup>

docs/examples/personal-ai-tutor.mdx

@@ -0,0 +1,111 @@
+---
+title: Personalized AI Tutor
+---
+
+You can create a personalized AI Tutor using Mem0. This guide will walk you through the necessary steps and provide the complete code to get you started.
+
+## Overview
+
+The Personalized AI Tutor leverages Mem0 to retain information across interactions, enabling a tailored learning experience. By integrating with OpenAI's GPT-4 model, the tutor can provide detailed and context-aware responses to user queries.
+
+## Setup
+Before you begin, ensure you have the required dependencies installed. You can install the necessary packages using pip:
+
+```bash
+pip install openai mem0ai
+```
+
+## Full Code Example
+
+Below is the complete code to create and interact with a Personalized AI Tutor using Mem0:
+
+```python
+from openai import OpenAI
+from mem0 import Memory
+
+# Set the OpenAI API key
+os.environ['OPENAI_API_KEY'] = 'sk-xxx'
+
+# Initialize the OpenAI client
+client = OpenAI()
+
+class PersonalAITutor:
+    def __init__(self):
+        """
+        Initialize the PersonalAITutor with memory configuration and OpenAI client.
+        """
+        config = {
+            "vector_store": {
+                "provider": "qdrant",
+                "config": {
+                    "host": "localhost",
+                    "port": 6333,
+                }
+            },
+        }
+        self.memory = Memory.from_config(config)
+        self.client = client
+        self.app_id = "app-1"
+
+    def ask(self, question, user_id=None):
+        """
+        Ask a question to the AI and store the relevant facts in memory
+
+        :param question: The question to ask the AI.
+        :param user_id: Optional user ID to associate with the memory.
+        """
+        # Start a streaming chat completion request to the AI
+        stream = self.client.chat.completions.create(
+            model="gpt-4",
+            stream=True,
+            messages=[
+                {"role": "system", "content": "You are a personal AI Tutor."},
+                {"role": "user", "content": question}
+            ]
+        )
+        # Store the question in memory
+        self.memory.add(question, user_id=user_id, metadata={"app_id": self.app_id})
+
+        # Print the response from the AI in real-time
+        for chunk in stream:
+            if chunk.choices[0].delta.content is not None:
+                print(chunk.choices[0].delta.content, end="")
+
+    def get_memories(self, user_id=None):
+        """
+        Retrieve all memories associated with the given user ID.
+
+        :param user_id: Optional user ID to filter memories.
+        :return: List of memories.
+        """
+        return self.memory.get_all(user_id=user_id)
+
+# Instantiate the PersonalAITutor
+ai_tutor = PersonalAITutor()
+
+# Define a user ID
+user_id = "john_doe"
+
+# Ask a question
+ai_tutor.ask("I am learning introduction to CS. What is queue? Briefly explain.", user_id=user_id)
+```
+
+### Fetching Memories
+
+You can fetch all the memories at any point in time using the following code:
+
+```python
+memories = ai_tutor.get_memories(user_id=user_id)
+for m in memories:
+    print(m['text'])
+```
+
+### Key Points
+
+- **Initialization**: The PersonalAITutor class is initialized with the necessary memory configuration and OpenAI client setup.
+- **Asking Questions**: The ask method sends a question to the AI and stores the relevant information in memory.
+- **Retrieving Memories**: The get_memories method fetches all stored memories associated with a user.
+
+### Conclusion
+
+As the conversation progresses, Mem0's memory automatically updates based on the interactions, providing a continuously improving personalized learning experience. This setup ensures that the AI Tutor can offer contextually relevant and accurate responses, enhancing the overall educational process.

docs/examples/personal-travel-assistant.mdx

@@ -0,0 +1,101 @@
+---
+title: Personal AI Travel Assistant
+---
+Create a personalized AI Travel Assistant using Mem0. This guide provides step-by-step instructions and the complete code to get you started.
+
+## Overview
+
+The Personalized AI Travel Assistant uses Mem0 to store and retrieve information across interactions, enabling a tailored travel planning experience. It integrates with OpenAI's GPT-4 model to provide detailed and context-aware responses to user queries.
+
+## Setup
+
+Install the required dependencies using pip:
+
+```bash
+pip install openai mem0ai
+```
+
+## Full Code Example
+
+Here's the complete code to create and interact with a Personalized AI Travel Assistant using Mem0:
+
+```python
+import os
+from openai import OpenAI
+from mem0 import Memory
+
+# Set the OpenAI API key
+os.environ['OPENAI_API_KEY'] = 'sk-xxx'
+
+class PersonalTravelAssistant:
+    def __init__(self):
+        self.client = OpenAI()
+        self.memory = Memory()
+        self.messages = [{"role": "system", "content": "You are a personal AI Assistant."}]
+
+    def ask_question(self, question, user_id):
+        # Fetch previous related memories
+        previous_memories = self.search_memories(question, user_id=user_id)
+        prompt = question
+        if previous_memories:
+            prompt = f"User input: {question}\n Previous memories: {previous_memories}"
+        self.messages.append({"role": "user", "content": prompt})
+
+        # Generate response using GPT-4o
+        response = self.client.chat.completions.create(
+            model="gpt-4o",
+            messages=self.messages
+        )
+        answer = response.choices[0].message.content
+        self.messages.append({"role": "assistant", "content": answer})
+
+        # Store the question in memory
+        self.memory.add(question, user_id=user_id)
+        return answer
+
+    def get_memories(self, user_id):
+        memories = self.memory.get_all(user_id=user_id)
+        return [m['text'] for m in memories]
+
+    def search_memories(self, query, user_id):
+        memories = self.memory.search(query, user_id=user_id)
+        return [m['text'] for m in memories]
+
+# Usage example
+user_id = "traveler_123"
+ai_assistant = PersonalTravelAssistant()
+
+def main():
+    while True:
+        question = input("Question: ")
+        if question.lower() in ['q', 'exit']:
+            print("Exiting...")
+            break
+
+        answer = ai_assistant.ask_question(question, user_id=user_id)
+        print(f"Answer: {answer}")
+        memories = ai_assistant.get_memories(user_id=user_id)
+        print("Memories:")
+        for memory in memories:
+            print(f"- {memory}")
+        print("-----")
+
+if __name__ == "__main__":
+    main()
+```
+
+## Key Components
+
+- **Initialization**: The `PersonalTravelAssistant` class is initialized with the OpenAI client and Mem0 memory setup.
+- **Asking Questions**: The `ask_question` method sends a question to the AI, incorporates previous memories, and stores new information.
+- **Memory Management**: The `get_memories` and search_memories methods handle retrieval and searching of stored memories.
+
+## Usage
+
+1. Set your OpenAI API key in the environment variable.
+2. Instantiate the `PersonalTravelAssistant`.
+3. Use the `main()` function to interact with the assistant in a loop.
+
+## Conclusion
+
+This Personalized AI Travel Assistant leverages Mem0's memory capabilities to provide context-aware responses. As you interact with it, the assistant learns and improves, offering increasingly personalized travel advice and information.

docs/favicon.svg

@@ -0,0 +1,49 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M7.95343 21.1394C4.89586 21.1304 2.25471 19.458 0.987296 16.2895C-0.280118 13.121 0.108924 9.16314 1.74363 5.61505C4.8012 5.62409 7.44235 7.29648 8.70976 10.465C9.97718 13.6335 9.58814 17.5914 7.95343 21.1394Z" fill="white"/>
+<path d="M7.95343 21.1394C4.89586 21.1304 2.25471 19.458 0.987296 16.2895C-0.280118 13.121 0.108924 9.16314 1.74363 5.61505C4.8012 5.62409 7.44235 7.29648 8.70976 10.465C9.97718 13.6335 9.58814 17.5914 7.95343 21.1394Z" fill="url(#paint0_radial_101_2703)"/>
+<path d="M7.95343 21.1394C4.89586 21.1304 2.25471 19.458 0.987296 16.2895C-0.280118 13.121 0.108924 9.16314 1.74363 5.61505C4.8012 5.62409 7.44235 7.29648 8.70976 10.465C9.97718 13.6335 9.58814 17.5914 7.95343 21.1394Z" fill="black" fill-opacity="0.5" style="mix-blend-mode:hard-light"/>
+<path d="M7.95343 21.1394C4.89586 21.1304 2.25471 19.458 0.987296 16.2895C-0.280118 13.121 0.108924 9.16314 1.74363 5.61505C4.8012 5.62409 7.44235 7.29648 8.70976 10.465C9.97718 13.6335 9.58814 17.5914 7.95343 21.1394Z" fill="url(#paint1_linear_101_2703)" fill-opacity="0.5" style="mix-blend-mode:hard-light"/>
+<path d="M8.68359 10.4755C9.94543 13.63 9.56145 17.5723 7.9354 21.1112C4.89702 21.0957 2.27411 19.4306 1.01347 16.279C-0.248375 13.1245 0.135612 9.18218 1.76165 5.64328C4.80004 5.65883 7.42295 7.32386 8.68359 10.4755Z" stroke="url(#paint2_linear_101_2703)" stroke-opacity="0.05" stroke-width="0.056338"/>
+<path d="M7.31038 21.2574C11.3543 20.2215 14.8836 17.3754 16.6285 13.2361C18.3735 9.09671 17.9448 4.58749 15.8598 0.976291C11.8159 2.01214 8.2866 4.85826 6.54167 8.99762C4.79674 13.137 5.2254 17.6462 7.31038 21.2574Z" fill="white"/>
+<path d="M7.31038 21.2574C11.3543 20.2215 14.8836 17.3754 16.6285 13.2361C18.3735 9.09671 17.9448 4.58749 15.8598 0.976291C11.8159 2.01214 8.2866 4.85826 6.54167 8.99762C4.79674 13.137 5.2254 17.6462 7.31038 21.2574Z" fill="url(#paint3_radial_101_2703)"/>
+<path d="M16.6026 13.2251C14.8642 17.349 11.3512 20.1866 7.32411 21.2248C5.25257 17.624 4.82926 13.1324 6.56764 9.00855C8.30603 4.88472 11.819 2.04706 15.8461 1.00889C17.9176 4.60967 18.3409 9.10131 16.6026 13.2251Z" stroke="url(#paint4_linear_101_2703)" stroke-opacity="0.05" stroke-width="0.056338"/>
+<path d="M7.23368 21.2069C9.78906 23.2373 13.2102 23.9506 16.5772 22.8141C19.9441 21.6775 22.5058 18.9445 23.7304 15.6382C21.175 13.6078 17.7538 12.8944 14.3869 14.031C11.0199 15.1676 8.45822 17.9006 7.23368 21.2069Z" fill="white"/>
+<path d="M7.23368 21.2069C9.78906 23.2373 13.2102 23.9506 16.5772 22.8141C19.9441 21.6775 22.5058 18.9445 23.7304 15.6382C21.175 13.6078 17.7538 12.8944 14.3869 14.031C11.0199 15.1676 8.45822 17.9006 7.23368 21.2069Z" fill="url(#paint5_radial_101_2703)"/>
+<path d="M7.23368 21.2069C9.78906 23.2373 13.2102 23.9506 16.5772 22.8141C19.9441 21.6775 22.5058 18.9445 23.7304 15.6382C21.175 13.6078 17.7538 12.8944 14.3869 14.031C11.0199 15.1676 8.45822 17.9006 7.23368 21.2069Z" fill="black" fill-opacity="0.2" style="mix-blend-mode:hard-light"/>
+<path d="M7.23368 21.2069C9.78906 23.2373 13.2102 23.9506 16.5772 22.8141C19.9441 21.6775 22.5058 18.9445 23.7304 15.6382C21.175 13.6078 17.7538 12.8944 14.3869 14.031C11.0199 15.1676 8.45822 17.9006 7.23368 21.2069Z" fill="url(#paint6_linear_101_2703)" fill-opacity="0.5" style="mix-blend-mode:hard-light"/>
+<path d="M16.5682 22.7874C13.2176 23.9184 9.81361 23.2124 7.2672 21.1975C8.49194 17.9068 11.0444 15.189 14.3959 14.0577C17.7465 12.9266 21.1504 13.6326 23.6968 15.6476C22.4721 18.9383 19.9196 21.656 16.5682 22.7874Z" stroke="url(#paint7_linear_101_2703)" stroke-opacity="0.05" stroke-width="0.056338"/>
+<defs>
+<radialGradient id="paint0_radial_101_2703" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(-3.00503 15.023) rotate(-10.029) scale(17.9572 17.784)">
+<stop stop-color="#00B0BB"/>
+<stop offset="1" stop-color="#00DB65"/>
+</radialGradient>
+<linearGradient id="paint1_linear_101_2703" x1="7.39036" y1="4.81308" x2="1.62975" y2="18.6894" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18E299"/>
+<stop offset="1"/>
+</linearGradient>
+<linearGradient id="paint2_linear_101_2703" x1="7.94816" y1="8.01563" x2="1.7612" y2="18.746" gradientUnits="userSpaceOnUse">
+<stop/>
+<stop offset="1" stop-opacity="0"/>
+</linearGradient>
+<radialGradient id="paint3_radial_101_2703" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(8.11404 20.8822) rotate(-75.7542) scale(21.6246 23.7772)">
+<stop stop-color="#00BBBB"/>
+<stop offset="0.712616" stop-color="#00DB65"/>
+</radialGradient>
+<linearGradient id="paint4_linear_101_2703" x1="7.60205" y1="5.8709" x2="15.5561" y2="16.3719" gradientUnits="userSpaceOnUse">
+<stop/>
+<stop offset="1" stop-opacity="0"/>
+</linearGradient>
+<radialGradient id="paint5_radial_101_2703" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(7.84537 21.5181) rotate(-20.3525) scale(18.5603 17.32)">
+<stop stop-color="#00B0BB"/>
+<stop offset="1" stop-color="#00DB65"/>
+</radialGradient>
+<linearGradient id="paint6_linear_101_2703" x1="16.8078" y1="13.0071" x2="10.0409" y2="22.9937" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00B1BC"/>
+<stop offset="1"/>
+</linearGradient>
+<linearGradient id="paint7_linear_101_2703" x1="16.8078" y1="13.0071" x2="14.1687" y2="23.841" gradientUnits="userSpaceOnUse">
+<stop/>
+<stop offset="1" stop-opacity="0"/>
+</linearGradient>
+</defs>
+</svg>

docs/features/openai_compatibility.mdx

@@ -0,0 +1,22 @@
+---
+title: OpenAI Compatibility
+---
+
+Mem0 seamlessly offers an OpenAI-compatible API, making it easy to incorporate into existing projects.
+
+## Mem0 Params for Chat Completion
+
+- `user_id` (Optional[str]): Identifier for the user.
+
+- `agent_id` (Optional[str]): Identifier for the agent.
+
+- `run_id` (Optional[str]): Identifier for the run.
+
+- `metadata` (Optional[dict]): Additional metadata to be stored with the memory.
+
+- `filters` (Optional[dict]): Filters to apply when searching for relevant memories.
+
+- `limit` (Optional[int]): Maximum number of relevant memories to retrieve. Default is 10.
+
+
+Other parameters are similar to OpenAI's API, making it easy to integrate Mem0 into your existing applications.

docs/get-started/introduction.mdx

@@ -1,133 +0,0 @@
----
-title: 📚 Introduction
-description: '📝 Embedchain is a Data Platform for LLMs - load, index, retrieve, and sync any unstructured data'
----
-
-## 🌐 What is Embedchain?
-
-Embedchain simplifies data handling by automatically processing unstructured data, breaking it into chunks, generating embeddings, and storing it in a vector database.
-
-Through various APIs, you can obtain contextual information for queries, find answers to specific questions, and engage in chat conversations using your data.
-## 🔍 Search
-
-Embedchain lets you get most relevant context by doing semantic search over your data sources for a provided query. See the example below:
-
-```python
-from embedchain import Pipeline as App
-
-# Initialize app
-app = App()
-
-# Add data source
-app.add("https://www.forbes.com/profile/elon-musk")
-
-# Get relevant context using semantic search
-context = app.search("What is the net worth of Elon?", num_documents=2)
-print(context)
-# Context:
-# [
-#     {
-#         'context': 'Elon Musk PROFILEElon MuskCEO, Tesla$221.9BReal Time Net Worthas of 10/29/23Reflects change since 5 pm ET of prior trading day. 1 in the world todayPhoto by Martin Schoeller for ForbesAbout Elon MuskElon Musk cofounded six companies, including electric car maker Tesla, rocket producer SpaceX and tunneling startup Boring Company.He owns about 21% of Tesla between stock and options, but has pledged more than half his shares as collateral for personal loans of up to $3.5 billion.SpaceX, founded in',
-#         'source': 'https://www.forbes.com/profile/elon-musk',
-#         'document_id': 'some_document_id'
-#     },
-#     {
-#         'context': 'company, which is now called X.Wealth HistoryHOVER TO REVEAL NET WORTH BY YEARForbes Lists 1Forbes 400 (2023)The Richest Person In Every State (2023) 2Billionaires (2023) 1Innovative Leaders (2019) 25Powerful People (2018) 12Richest In Tech (2017)Global Game Changers (2016)More ListsPersonal StatsAge52Source of WealthTesla, SpaceX, Self MadeSelf-Made Score8Philanthropy Score1ResidenceAustin, TexasCitizenshipUnited StatesMarital StatusSingleChildren11EducationBachelor of Arts/Science, University',
-#         'source': 'https://www.forbes.com/profile/elon-musk',
-#         'document_id': 'some_document_id'
-#     }
-# ]
-```
-
-## ❓Query
-
-Embedchain empowers developers to ask questions and receive relevant answers through a user-friendly query API. Refer to the following example to learn how to utilize the query API:
-
-```python
-from embedchain import Pipeline as App
-
-# Initialize app
-app = App()
-
-# Add data source
-app.add("https://www.forbes.com/profile/elon-musk")
-
-# Get relevant answer for your query
-answer = app.query("What is the net worth of Elon?")
-print(answer)
-# Answer: The net worth of Elon Musk is $221.9 billion.
-```
-
-## 💬 Chat
-
-Embedchain allows easy chatting over your data sources using a user-friendly chat API. Check out the example below to understand how to use the chat API:
-
-```python
-from embedchain import Pipeline as App
-
-# Initialize app
-app = App()
-
-# Add data source
-app.add("https://www.forbes.com/profile/elon-musk")
-
-# Chat on your data using `.chat()`
-answer = app.chat("How much did Elon pay for Twitter?")
-print(answer)
-# Answer: Elon Musk paid $44 billion for Twitter.
-```
-
-## 🚀 Deploy
-
-Embedchain enables developers to deploy their LLM-powered apps in production using the Embedchain platform. The platform offers free access to context on your data through its REST API. Once the pipeline is deployed, you can update your data sources anytime after deployment.
-
-See the example below on how to use the deploy API:
-
-```python
-from embedchain import Pipeline as App
-
-# Initialize app
-app = App()
-
-# Add data source
-app.add("https://www.forbes.com/profile/elon-musk")
-
-# Deploy your pipeline to Embedchain Platform
-app.deploy()
-
-# 🔑 Enter your Embedchain API key. You can find the API key at https://app.embedchain.ai/settings/keys/
-# ec-xxxxxx
-
-# 🛠️ Creating pipeline on the platform...
-# 🎉🎉🎉 Pipeline created successfully! View your pipeline: https://app.embedchain.ai/pipelines/xxxxx
-
-# 🛠️ Adding data to your pipeline...
-# ✅ Data of type: web_page, value: https://www.forbes.com/profile/elon-musk added successfully.
-```
-
-## 🛠️ How it works?
-
-Embedchain abstracts out the following steps from you to easily create LLM powered apps:
-
-1. Detect the data type and load data
-2. Create meaningful chunks
-3. Create embeddings for each chunk
-4. Store chunks in a vector database
-
-When a user asks a query, the following process happens to find the answer:
-
-1. Create an embedding for the query
-2. Find similar documents for the query from the vector database
-3. Pass the similar documents as context to LLM to get the final answer
-
-The process of loading the dataset and querying involves multiple steps, each with its own nuances:
-
-- How should I chunk the data? What is a meaningful chunk size?
-- How should I create embeddings for each chunk? Which embedding model should I use?
-- How should I store the chunks in a vector database? Which vector database should I use?
-- Should I store metadata along with the embeddings?
-- How should I find similar documents for a query? Which ranking model should I use?
-
-Embedchain takes care of all these nuances and provides a simple interface to create apps on any data.
-
-## [🚀 Get started](https://docs.embedchain.ai/get-started/quickstart)

docs/get-started/quickstart.mdx

@@ -1,96 +0,0 @@
----
-title: '🚀 Quickstart'
-description: '💡 Start building LLM powered apps under 30 seconds'
----
-
-Embedchain is a Data Platform for LLMs - load, index, retrieve, and sync any unstructured data. Using embedchain, you can easily create LLM powered apps over any data. 
-
-Install embedchain python package:
-
-```bash
-pip install embedchain
-```
-
-<Tip>
-Embedchain now supports OpenAI's latest `gpt-4-turbo` model. Checkout the [FAQs](/get-started/faq#how-to-use-gpt-4-turbo-model-released-on-openai-devday).
-</Tip>
-
-Creating an app involves 3 steps:
-
-<Steps>
-  <Step title="⚙️ Import app instance">
-    ```python
-    from embedchain import Pipeline as 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 Pipeline as App
-      app = App.from_config(config_path="config.yaml")
-      ```
-      ```python json_app.py
-      from embedchain import Pipeline as App
-      app = App.from_config(config_path="config.json")
-      ```
-      ```python app.py
-      from embedchain import Pipeline as 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.
-    ```
-    <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>
-  <Step title="🚀 Seamlessly launch your App on the Embedchain Platform!">
-    ```python
-    app.deploy()
-    # 🔑 Enter your Embedchain API key. You can find the API key at https://app.embedchain.ai/settings/keys/
-    # ec-xxxxxx
-
-    # 🛠️ Creating pipeline on the platform...
-    # 🎉🎉🎉 Pipeline created successfully! View your pipeline: https://app.embedchain.ai/pipelines/xxxxx
-
-    # 🛠️ Adding data to your pipeline...
-    # ✅ Data of type: web_page, value: https://www.forbes.com/profile/elon-musk added successfully.
-    ```
-    <Accordion title="Share your app with others" icon="laptop-mobile">
-      You can now share your app with others from our platform.
-      Access your app on our [platform](https://app.embedchain.ai/).
-    </Accordion>
-  </Step>
-</Steps>
-
-Putting it together, you can run your first app using the following Google Colab. Make sure to set the `OPENAI_API_KEY` 🔑 environment variable in the code.
-
-<a href="https://colab.research.google.com/drive/17ON1LPonnXAtLaZEebnOktstB_1cJJmh?usp=sharing">
-    <img src="https://camo.githubusercontent.com/84f0493939e0c4de4e6dbe113251b4bfb5353e57134ffd9fcab6b8714514d4d1/68747470733a2f2f636f6c61622e72657365617263682e676f6f676c652e636f6d2f6173736574732f636f6c61622d62616467652e737667" alt="Open in Colab" />
-</a>

docs/integration/langsmith.mdx

@@ -1,51 +0,0 @@
----
-title: '🛠️ LangSmith'
-description: 'Integrate with Langsmith to debug and monitor your LLM app'
----
-
-Embedchain now supports integration with [LangSmith](https://www.langchain.com/langsmith).
-
-To use langsmith, you need to do the following steps
-
-1. Have an account on langsmith and keep the environment variables in handy
-2. Set the environments variables in your app so that embedchain has context about it.
-3. Just use embedchain and everything will be logged to LangSmith, so that you can better test and monitor your application.
-
-Lets cover each step in detail.
-
-* First make sure that you a LangSmith account created and have all the necessary variables handy. LangSmith has a [good documentation](https://docs.smith.langchain.com/) on how to get started with their service.
-
-* Once you have the account setup, we will need the following environment variables
-
-```bash
-export LANGCHAIN_TRACING_V2=true
-export LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
-export LANGCHAIN_API_KEY=<your-api-key>
-export LANGCHAIN_PROJECT=<your-project>  # if not specified, defaults to "default"
-```
-
-If you are using Python, you can use the following code to set environment variables
-
-```python
-import os
-
-os.environ['LANGCHAIN_TRACING_V2'] = 'true'
-os.environ['LANGCHAIN_ENDPOINT'] = 'https://api.smith.langchain.com'
-os.environ['LANGCHAIN_API_KEY'] = <your-api-key>
-os.environ['LANGCHAIN_PROJECT] = <your-project>
-```
-
-* Now create an app using embedchain and everything will be automatically visible in the LangSmith
-
-
-```python
-from embedchain import Pipeline as App
-
-app = App()
-app.add("https://en.wikipedia.org/wiki/Elon_Musk")
-app.query("How many companies did Elon found?")
-```
-
-* Now the entire log for this will be visible in langsmith.
-
-<img src="/images/langsmith.png"/>

docs/integrations/multion.mdx

@@ -0,0 +1,211 @@
+---
+title: MultiOn
+---
+
+Build personal browser agent remembers user preferences and automates web tasks. It integrates Mem0 for memory management with MultiOn for executing browser actions, enabling personalized and efficient web interactions.
+
+## Overview
+
+In this guide, we'll explore two examples of creating Browser-based AI Agents:
+1. An agent that searches [arxiv.org](https://arxiv.org) for research papers relevant to user's research interests.
+2. A travel agent that provides personalized travel information based on user preferences.
+
+## Setup and Configuration
+
+Install necessary libraries:
+
+```bash
+pip install mem0ai multion openai
+```
+
+First, we'll import the necessary libraries and set up our configurations.
+
+```python
+import os
+from mem0 import Memory, MemoryClient
+from multion.client import MultiOn
+from openai import OpenAI
+
+# Configuration
+OPENAI_API_KEY = 'sk-xxx'  # Replace with your actual OpenAI API key
+MULTION_API_KEY = 'your-multion-key'  # Replace with your actual MultiOn API key
+MEM0_API_KEY = 'your-mem0-key'  # Replace with your actual Mem0 API key
+USER_ID = "your-user-id"
+
+# Set up OpenAI API key
+os.environ['OPENAI_API_KEY'] = OPENAI_API_KEY
+
+# Initialize Mem0 and MultiOn
+memory = Memory()  # For local usage
+memory_client = MemoryClient(api_key=MEM0_API_KEY)  # For API usage
+multion = MultiOn(api_key=MULTION_API_KEY)
+```
+
+## Example 1: Research Paper Search Agent
+
+### Add memories to Mem0
+
+Define user data and add it to Mem0.
+
+```python
+USER_DATA = """
+About me
+- I'm Deshraj Yadav, Co-founder and CTO at Mem0, interested in AI and ML Infrastructure.
+- Previously, I was a Senior Autopilot Engineer at Tesla, leading the AI Platform for Autopilot.
+- I built EvalAI at Georgia Tech, an open-source platform for evaluating ML algorithms.
+- Outside of work, I enjoy playing cricket in two leagues in the San Francisco.
+"""
+
+memory.add(USER_DATA, user_id=USER_ID)
+print("User data added to memory.")
+```
+
+### Retrieving Relevant Memories
+
+Define search command and retrieve relevant memories from Mem0.
+
+```python
+command = "Find papers on arxiv that I should read based on my interests."
+
+relevant_memories = memory.search(command, user_id=USER_ID, limit=3)
+relevant_memories_text = '\n'.join(mem['text'] for mem in relevant_memories)
+print(f"Relevant memories:")
+print(relevant_memories_text)
+```
+
+### Browsing arXiv
+
+Use MultiOn to browse arXiv based on the command and relevant memories.
+
+```python
+prompt = f"{command}\n My past memories: {relevant_memories_text}"
+browse_result = multion.browse(cmd=prompt, url="https://arxiv.org/")
+print(browse_result)
+```
+
+## Example 2: Travel Agent
+
+### Get Travel Information
+
+Add conversation to Mem0 and create a function to get travel information based on user's question and optionally their preferences from memory.
+
+<CodeGroup>
+```python Code
+def get_travel_info(question, use_memory=True):
+    if use_memory:
+        previous_memories = memory_client.search(question, user_id=USER_ID)
+        relevant_memories_text = ""
+        if previous_memories:
+            print("Using previous memories to enhance the search...")
+            relevant_memories_text = '\n'.join(mem["memory"] for mem in previous_memories)
+        
+        command = "Find travel information based on my interests:"
+        prompt = f"{command}\n Question: {question} \n My preferences: {relevant_memories_text}"
+    else:
+        command = "Find travel information based on my interests:"
+        prompt = f"{command}\n Question: {question}"
+    
+    print("Searching for travel information...")    
+    browse_result = multion.browse(cmd=prompt)
+    return browse_result.message
+
+# Example usage
+question = "Show me flight details for it."
+answer_without_memory = get_travel_info(question, use_memory=False)
+answer_with_memory = get_travel_info(question, use_memory=True)
+
+print("Answer without memory:", answer_without_memory)
+print("Answer with memory:", answer_with_memory)
+
+# Another example
+question = "What is the best place to eat there?"
+answer_without_memory = get_travel_info(question, use_memory=False)
+answer_with_memory = get_travel_info(question, use_memory=True)
+
+print("Answer without memory:", answer_without_memory)
+print("Answer with memory:", answer_with_memory)
+```
+
+```json Conversation
+# Add conversation to Mem0
+conversation = [
+    {
+        "role": "user",
+        "content": "What are the best travel destinations in the world?"
+    },
+    {
+        "role": "assistant",
+        "content": "Could you please specify your interests or the type of travel information you are looking for? This will help me find the most relevant information for you."
+    },
+    {
+        "role": "user",
+        "content": "Sure, I want to travel to San Francisco."
+    },
+    {
+        "role": "assistant",
+        "content": """
+        Based on the information gathered from TripAdvisor, here are some popular attractions, activities, and travel tips for San Francisco: \
+
+        1. **Golden Gate Bridge**: A must-see iconic landmark. \
+        2. **Alcatraz Island**: Famous former prison offering tours. \
+        3. **Fisherman's Wharf**: Popular tourist area with shops, restaurants, and sea lions. \
+        4. **Chinatown**: The largest Chinatown outside of Asia. \
+        5. **Golden Gate Park**: Large urban park with gardens, museums, and recreational activities. \
+        6. **Cable Cars**: Historic streetcars offering a unique way to see the city. \
+        7. **Exploratorium**: Interactive science museum. \
+        8. **San Francisco Museum of Modern Art (SFMOMA)**: Modern and contemporary art museum. \
+        9. **Lombard Street**: Known for its steep, one-block section with eight hairpin turns. \
+        10. **Union Square**: Major shopping and cultural hub. \
+
+        Travel Tips: \
+        - **Weather**: San Francisco has a mild climate, but it can be foggy and windy. Dress in layers. \
+        - **Transportation**: Use public transportation like BART, Muni, and cable cars to get around. \
+        - **Safety**: Be aware of your surroundings, especially in crowded tourist areas. \
+        - **Dining**: Try local specialties like sourdough bread, seafood, and Mission-style burritos. \
+        """
+    },
+    {
+        "role": "user",
+        "content": "Show me hotels around Golden Gate Bridge."
+    },
+    {
+        "role": "assistant",
+        "content": """The search results for hotels around Golden Gate Bridge in San Francisco include: \
+
+        1. Hilton Hotels In San Francisco - Hotel Near Fishermans Wharf (hilton.com) \
+        2. The 10 Closest Hotels to Golden Gate Bridge (tripadvisor.com) \
+        3. Hotels near Golden Gate Bridge (expedia.com) \
+        4. Hotels near Golden Gate Bridge (hotels.com) \
+        5. Holiday Inn Express & Suites San Francisco Fishermans Wharf, an IHG Hotel $146 (1.8K) 3-star hotel Golden Gate Bridge • 3.5 mi DEAL 19% less than usual \
+        6. Holiday Inn San Francisco-Golden Gateway, an IHG Hotel $151 (3.5K) 3-star hotel Golden Gate Bridge • 3.7 mi Casual hotel with dining, a bar & a pool \
+        7. Hotel Zephyr San Francisco $159 (3.8K) 4-star hotel Golden Gate Bridge • 3.7 mi Nautical-themed lodging with bay views \
+        8. Lodge at the Presidio \
+        9. The Inn Above Tide \
+        10. Cavallo Point \
+        11. Casa Madrona Hotel and Spa \
+        12. Cow Hollow Inn and Suites \
+        13. Samesun San Francisco \
+        14. Inn on Broadway \
+        15. Coventry Motor Inn \
+        16. HI San Francisco Fisherman's Wharf Hostel \
+        17. Loews Regency San Francisco Hotel \
+        18. Fairmont Heritage Place Ghirardelli Square \
+        19. Hotel Drisco Pacific Heights \
+        20. Travelodge by Wyndham Presidio San Francisco \
+        """
+    }
+]
+```
+</CodeGroup>
+
+## Conclusion
+
+By integrating Mem0 with MultiOn, you've created personalized browser agents that remember user preferences and automate web tasks. The first example demonstrates a research-focused agent, while the second example shows a travel agent capable of providing personalized recommendations.
+
+These examples illustrate how combining memory management with web browsing capabilities can create powerful, context-aware AI agents for various applications.
+
+## Help
+
+- For more details and advanced usage, refer to the full [cookbooks here](https://github.com/mem0ai/mem0/blob/main/cookbooks).
+- Feel free to visit our [Github](https://github.com/mem0ai/mem0) or [Mem0 Platform](https://app.mem0.ai/).
+- For any questions or assistance, please reach out to `taranjeetio` on [Discord](https://mem0.ai/discord).

docs/mint.json

@@ -1,12 +1,7 @@
 {
   "$schema": "https://mintlify.com/schema.json",
-  "name": "Embedchain",
-  "logo": {
-    "dark": "/logo/dark.svg",
-    "light": "/logo/light.svg",
-    "href": "https://embedchain.ai/"
-  },
-  "favicon": "/favicon.png",
+  "name": "Mem0.ai",
+  "favicon": "/logo/favicon.png",
   "colors": {
     "primary": "#3B2FC9",
     "light": "#6673FF",
@@ -16,162 +11,95 @@
       "light": "#fff"
     }
   },
-  "modeToggle": {
-    "default": "dark"
+  "logo": {
+    "dark": "/logo/dark.svg",
+    "light": "/logo/light.svg",
+    "href": "https://github.com/mem0ai/mem0"
   },
-  "openapi": ["/rest-api.json"],
-  "metadata": {
-    "og:image": "/images/og.png",
-    "twitter:site": "@embedchain"
-  },
-  "anchors": [
+  "tabs": [
     {
-      "name": "Embedchain Platform",
-      "icon": "tv",
-      "url": "https://app.embedchain.ai/"
+      "name": "💡 Examples",
+      "url": "examples"
     },
     {
-      "name": "Join our slack",
-      "icon": "slack",
-      "url": "https://join.slack.com/t/embedchain/shared_invite/zt-22uwz3c46-Zg7cIh5rOBteT_xe1jwLDw"
-    }
-  ],
-  "topbarLinks": [
-    {
-      "name": "Create account",
-      "url": "https://app.embedchain.ai/login/"
+      "name": "🖥️  Platform",
+      "url": "platform"
     }
   ],
   "topbarCtaButton": {
-    "name": "Get started",
-    "url": "https://app.embedchain.ai"
-  },
-  "primaryTab": {
-    "name": "Docs"
+    "name": "Your Memory Dashboard",
+    "url": "https://app.mem0.ai"
   },
+  "anchors": [
+    {
+      "name": "Your Memory Dashboard",
+      "icon": "discord",
+      "url": "https://app.mem0.ai"
+    },
+    {
+      "name": "Discord",
+      "icon": "discord",
+      "url": "https://mem0.ai/discord"
+    },
+    {
+      "name": "GitHub",
+      "icon": "github",
+      "url": "https://github.com/mem0ai/mem0"
+    },
+    {
+      "name": "Support",
+      "icon": "envelope",
+      "url": "mailto:taranjeet@mem0.ai"
+    }
+  ],
   "navigation": [
     {
-      "group": "Get started",
+      "group": "Get Started",
       "pages": [
-        "get-started/quickstart",
-        "get-started/introduction",
-        "get-started/openai-assistant",
-        "get-started/faq",
-        "get-started/examples"
+        "overview",
+        "quickstart"
       ]
     },
     {
       "group": "Components",
       "pages": [
-        "components/llms",
-        "components/embedding-models",
-        "components/vector-databases"
+        "components/llms.mdx",
+        "components/vectordb.mdx"
       ]
     },
     {
-      "group": "Data sources",
-      "pages": [
-        "data-sources/overview",
-        {
-          "group": "Supported data sources",
-          "pages": [
-            "data-sources/csv",
-            "data-sources/json",
-            "data-sources/docs-site",
-            "data-sources/docx",
-            "data-sources/mdx",
-            "data-sources/notion",
-            "data-sources/pdf-file",
-            "data-sources/qna",
-            "data-sources/sitemap",
-            "data-sources/text",
-            "data-sources/web-page",
-            "data-sources/openapi",
-            "data-sources/youtube-video",
-            "data-sources/discourse",
-            "data-sources/substack",
-            "data-sources/discord"
-          ]
-        },
-        "data-sources/data-type-handling"
+      "group": "Features",
+      "pages":[
+        "features/openai_compatibility"
       ]
     },
-    {
-      "group": "Advanced",
-      "pages": ["advanced/configuration"]
-    },
-    {
-      "group": "REST API",
-      "pages": [
-        "rest-api/getting-started",
-        "rest-api/create",
-        "rest-api/get-all-apps",
-        "rest-api/add-data",
-        "rest-api/get-data",
-        "rest-api/query",
-        "rest-api/deploy",
-        "rest-api/delete",
-        "rest-api/check-status"
-      ]
-    },
-    {
-      "group": "Use Cases",
-      "pages": [
-        "examples/full_stack",
-        "examples/discord_bot",
-        "examples/slack_bot",
-        "examples/telegram_bot",
-        "examples/whatsapp_bot",
-        "examples/poe_bot"
-      ]
-    },
-    {
-      "group": "Community",
-      "pages": ["community/connect-with-us", "community/showcase"]
-    },
     {
       "group": "Integrations",
-      "pages": ["integration/langsmith"]
-    },
-    {
-      "group": "Contribute",
       "pages": [
-        "contribution/guidelines",
-        "contribution/dev",
-        "contribution/docs",
-        "contribution/python",
-        "contribution/javascript"
+        "integrations/multion"
       ]
     },
     {
-      "group": "Product",
-      "pages": ["product/release-notes"]
+      "group": "💡 Examples",
+      "pages": [
+        "examples/overview",
+        "examples/personal-ai-tutor",
+        "examples/customer-support-agent",
+        "examples/personal-travel-assistant"
+      ]
+    },
+    {
+      "group": "🖥️  Platform",
+      "pages": [
+        "platform/overview",
+        "platform/quickstart"
+      ]
     }
   ],
   "footerSocials": {
-    "website": "https://embedchain.ai",
-    "github": "https://github.com/embedchain/embedchain",
-    "slack": "https://join.slack.com/t/embedchain/shared_invite/zt-22uwz3c46-Zg7cIh5rOBteT_xe1jwLDw",
-    "discord": "https://discord.gg/6PzXDgEjG5",
-    "twitter": "https://twitter.com/embedchain",
-    "linkedin": "https://www.linkedin.com/company/embedchain"
-  },
-  "isWhiteLabeled": true,
-  "analytics": {
-    "posthog": {
-      "apiKey": "phc_PHQDA5KwztijnSojsxJ2c1DuJd52QCzJzT2xnSGvjN2",
-      "apiHost": "https://app.embedchain.ai/ingest"
-    }
-  },
-  "feedback": {
-    "suggestEdit": true,
-    "raiseIssue": true,
-    "thumbsRating": true
-  },
-  "search": {
-    "prompt": "✨ Search embedchain docs..."
-  },
-  "api": {
-    "baseUrl": "http://localhost:8080"
+    "discord": "https://mem0.ai/discord",
+    "x": "https://x.com/mem0ai",
+    "github": "https://github.com/mem0ai",
+    "linkedin": "https://www.linkedin.com/company/mem0/"
   }
-}
+}

docs/overview.mdx

@@ -0,0 +1,62 @@
+---
+title: 📚 Overview
+description: 'Welcome to the Mem0 docs!'
+---
+
+> Mem0 provides a smart, self-improving memory layer for Large Language Models, enabling personalized AI experiences across applications.
+
+## Core features
+
+- **User, Session, and AI Agent Memory**: Retains information across user sessions, interactions, and AI agents, ensuring continuity and context.
+- **Adaptive Personalization**: Continuously improves personalization based on user interactions and feedback.
+- **Developer-Friendly API**: Offers a straightforward API for seamless integration into various applications.
+- **Platform Consistency**: Ensures consistent behavior and data across different platforms and devices.
+- **Managed Service**: Provides a hosted solution for easy deployment and maintenance.
+
+If you are looking to quick start, jump to one of the following links:
+
+<CardGroup cols={2}>
+  <Card title="Open Source Quickstart" icon="square-1" href="/quickstart/">
+    Get started with Mem0 open source
+  </Card>
+  <Card title="Mem0 Platform Quickstart" icon="square-2" href="/platform/quickstart/">
+    Begin with Mem0 Platform
+  </Card>
+  <Card title="Examples" icon="square-3" href="/examples/overview/">
+    Explore practical use cases
+  </Card>
+</CardGroup>
+
+## Common Use Cases
+
+- **Personalized Learning Assistants**: Long-term memory allows learning assistants to remember user preferences, past interactions, and progress, providing a more tailored and effective learning experience.
+
+- **Customer Support AI Agents**: By retaining information from previous interactions, customer support bots can offer more accurate and context-aware assistance, improving customer satisfaction and reducing resolution times.
+
+- **Healthcare Assistants**: Long-term memory enables healthcare assistants to keep track of patient history, medication schedules, and treatment plans, ensuring personalized and consistent care.
+
+- **Virtual Companions**: Virtual companions can use long-term memory to build deeper relationships with users by remembering personal details, preferences, and past conversations, making interactions more meaningful.
+
+- **Productivity Tools**: Long-term memory helps productivity tools remember user habits, frequently used documents, and task history, streamlining workflows and enhancing efficiency.
+
+- **Gaming AI**: In gaming, AI with long-term memory can create more immersive experiences by remembering player choices, strategies, and progress, adapting the game environment accordingly.
+
+## How is Mem0 different from RAG?
+
+Mem0's memory implementation for Large Language Models (LLMs) offers several advantages over Retrieval-Augmented Generation (RAG):
+
+- **Entity Relationships**: Mem0 can understand and relate entities across different interactions, unlike RAG which retrieves information from static documents. This leads to a deeper understanding of context and relationships.
+
+- **Recency, Relevancy, and Decay**: Mem0 prioritizes recent interactions and gradually forgets outdated information, ensuring the memory remains relevant and up-to-date for more accurate responses.
+
+- **Contextual Continuity**: Mem0 retains information across sessions, maintaining continuity in conversations and interactions, which is essential for long-term engagement applications like virtual companions or personalized learning assistants.
+
+- **Adaptive Learning**: Mem0 improves its personalization based on user interactions and feedback, making the memory more accurate and tailored to individual users over time.
+
+- **Dynamic Updates**: Mem0 can dynamically update its memory with new information and interactions, unlike RAG which relies on static data. This allows for real-time adjustments and improvements, enhancing the user experience.
+
+These advanced memory capabilities make Mem0 a powerful tool for developers aiming to create personalized and context-aware AI applications.
+
+If you have any questions, please feel free to reach out to us using one of the following methods:
+
+<Snippet file="get-help.mdx" />

docs/platform/overview.mdx

@@ -0,0 +1,45 @@
+---
+title: Introduction
+description: 'Empower your AI applications with long-term memory and personalization'
+---
+
+## Welcome to Mem0 Platform
+
+Mem0 Platform is a managed service that revolutionizes the way AI applications handle memory. By providing a smart, self-improving memory layer for Large Language Models (LLMs), we enable developers to create personalized AI experiences that evolve with each user interaction.
+
+## Why Choose Mem0 Platform?
+
+1. **Enhanced User Experience**: Deliver tailored interactions that make your AI applications truly stand out.
+2. **Simplified Development**: Our API-first approach streamlines integration, allowing you to focus on building great features.
+3. **Scalable Solution**: Designed to grow with your application, from prototypes to production-ready systems.
+
+## Key Features
+
+- **Comprehensive Memory Management**: Easily manage long-term, short-term, semantic, and episodic memories for individual users, agents, and sessions through our robust APIs.
+- **Self-Improving Memory**: Our adaptive system continuously learns from user interactions, refining its understanding over time.
+- **Cross-Platform Consistency**: Ensure a unified user experience across various AI platforms and applications.
+- **Centralized Memory Control**: Store, update, and delete memories effortlessly, taking away the hassle of memory management.
+
+## Common Use Cases
+
+- Personalized Learning Assistants
+- Customer Support AI Agents
+- Healthcare Assistants
+- Virtual Companions
+- Productivity Tools
+- Gaming AI
+
+## Getting Started
+Ready to supercharge your AI application with Mem0? Follow these steps:
+
+1. **Sign Up**: Create your Mem0 account at our platform.
+2. **API Key**: Generate your API key in the dashboard.
+3. **Installation**: Install our Python SDK using pip: `pip install mem0ai`
+4. **Quick Implementation**: Check out our [Quickstart Guide](/platform/quickstart) to start using Mem0 quickly.
+
+## Next Steps
+
+- Explore our API Reference for detailed endpoint documentation.
+- Join our [slack](https://mem0.ai/slack) or [discord](https://mem0.ai/discord) with other developers and get support.
+
+We're excited to see what you'll build with Mem0 Platform. Let's create smarter, more personalized AI experiences together!

docs/platform/quickstart.mdx

@@ -0,0 +1,620 @@
+---
+title: Quickstart
+description: 'Get started with Mem0 Platform in minutes'
+---
+
+## 1. Installation
+
+<CodeGroup>
+```bash pip
+pip install mem0ai
+```
+
+```bash npm
+npm install mem0ai
+```
+
+</CodeGroup>
+
+## 2. API Key Setup
+
+1. Sign in to [Mem0 Platform](https://app.mem0.ai/dashboard/api-keys)
+2. Copy your API Key from the dashboard
+
+![Get API Key from Mem0 Platform](/images/platform/api-key.png)
+
+## 3. Instantiate Client
+
+<CodeGroup>
+```python Python
+from mem0 import MemoryClient
+client = MemoryClient(api_key="your-api-key")
+```
+
+```javascript JavaScript
+const MemoryClient = require('mem0ai');
+const client = new MemoryClient('your-api-key');
+```
+
+</CodeGroup>
+
+## 4. Memory Operations
+
+Mem0 provides a simple and customizable interface for performing CRUD operations on memory.
+
+### 4.1 Create Memories
+
+You can create long-term and short-term memories for your users, AI Agents, etc. Here are some examples:
+
+#### Long-term memory for a user
+
+<CodeGroup>
+
+```python Python
+messages = [
+    {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
+    {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
+]
+client.add(messages, user_id="alex")
+```
+
+```javascript JavaScript
+const messages = [
+    {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
+    {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
+];
+client.add(messages, { user_id: "alex" })
+    .then(response => console.log(response))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [
+             {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
+             {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
+         ],
+         "user_id": "alex"
+     }'
+```
+
+```json Output
+{'message': 'ok'}
+```
+</CodeGroup>
+
+#### Short-term memory for a user session
+
+<CodeGroup>
+
+```python Python
+messages = [
+    {"role": "user", "content": "I'm planning a trip to Japan next month."},
+    {"role": "assistant", "content": "That's exciting, Alex! A trip to Japan next month sounds wonderful. Would you like some recommendations for vegetarian-friendly restaurants in Japan?"},
+    {"role": "user", "content": "Yes, please! Especially in Tokyo."},
+    {"role": "assistant", "content": "Great! I'll remember that you're interested in vegetarian restaurants in Tokyo for your upcoming trip. I'll prepare a list for you in our next interaction."}
+]
+client.add(messages, user_id="alex123", session_id="trip-planning-2024")
+```
+
+```javascript JavaScript
+const messages = [
+    {"role": "user", "content": "I'm planning a trip to Japan next month."},
+    {"role": "assistant", "content": "That's exciting, Alex! A trip to Japan next month sounds wonderful. Would you like some recommendations for vegetarian-friendly restaurants in Japan?"},
+    {"role": "user", "content": "Yes, please! Especially in Tokyo."},
+    {"role": "assistant", "content": "Great! I'll remember that you're interested in vegetarian restaurants in Tokyo for your upcoming trip. I'll prepare a list for you in our next interaction."}
+];
+client.add(messages, { user_id: "alex123", session_id: "trip-planning-2024" })
+    .then(response => console.log(response))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [
+             {"role": "user", "content": "I'm planning a trip to Japan next month."},
+             {"role": "assistant", "content": "That's exciting, Alex! A trip to Japan next month sounds wonderful. Would you like some recommendations for vegetarian-friendly restaurants in Japan?"},
+             {"role": "user", "content": "Yes, please! Especially in Tokyo."},
+             {"role": "assistant", "content": "Great! I'll remember that you're interested in vegetarian restaurants in Tokyo for your upcoming trip. I'll prepare a list for you in our next interaction."}
+         ],
+         "user_id": "alex123",
+         "session_id": "trip-planning-2024"
+     }'
+```
+
+```json Output
+{'message': 'ok'}
+```
+</CodeGroup>
+
+#### Long-term memory for agents
+
+<CodeGroup>
+
+```python Python
+messages = [
+    {"role": "system", "content": "You are a personalized travel assistant. Remember user preferences and provide tailored recommendations."},
+    {"role": "assistant", "content": "Understood. I'll maintain personalized travel preferences for each user and provide customized recommendations based on their dietary restrictions, interests, and past interactions."}
+]
+client.add(messages, agent_id="travel-assistant")
+```
+
+```javascript JavaScript
+const messages = [
+    {"role": "system", "content": "You are a personalized travel assistant. Remember user preferences and provide tailored recommendations."},
+    {"role": "assistant", "content": "Understood. I'll maintain personalized travel preferences for each user and provide customized recommendations based on their dietary restrictions, interests, and past interactions."}
+];
+client.add(messages, { agent_id: "travel-assistant" })
+    .then(response => console.log(response))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [
+             {"role": "system", "content": "You are a personalized travel assistant. Remember user preferences and provide tailored recommendations."},
+             {"role": "assistant", "content": "Understood. I'll maintain personalized travel preferences for each user and provide customized recommendations based on their dietary restrictions, interests, and past interactions."}
+         ],
+         "agent_id": "travel-assistant"
+     }'
+```
+
+```json Output
+{'message': 'ok'}
+```
+</CodeGroup>
+
+You can monitor memory operations on the platform:
+
+![Mem0 Platform Activity](/images/platform/activity.png)
+
+### 4.2 Search Relevant Memories
+
+You can also get related memories for a given natural language question using our search method.
+
+<CodeGroup>
+
+```python Python
+query = "What do you know about me?"
+client.search(query, user_id="alex")
+```
+
+```javascript JavaScript
+const query = "What do you know about me?";
+client.search(query, { user_id: "alex" })
+    .then(results => console.log(results))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X POST "https://api.mem0.ai/v1/memories/search/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "query": "What do you know about me?",
+         "user_id": "alex"
+     }'
+```
+
+```json Output
+[
+    {
+        "id": "7f165f7e-b411-4afe-b7e5-35789b72c4a5",
+        "memory": "Name: Alex. Vegetarian. Allergic to nuts.",
+        "input": [
+            {
+                "role": "user",
+                "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."
+            },
+            {
+                "role": "assistant",
+                "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."
+            }
+        ],
+        "user_id": "alex",
+        "hash": "9ee7e1455e84d1dab700ed8749aed75a",
+        "metadata": null,
+        "created_at": "2024-07-20T01:30:36.275141-07:00",
+        "updated_at": "2024-07-20T01:30:36.275172-07:00"
+    }
+]
+```
+</CodeGroup>
+
+### 4.3 Get All Memories
+
+Fetch all memories for a user, agent, or session using the getAll() method.
+
+#### Get all memories of an AI Agent
+
+<CodeGroup>
+```python Python
+client.get_all(agent_id="travel-assistant")
+```
+
+```javascript JavaScript
+client.getAll({ agent_id: "travel-assistant" })
+    .then(memories => console.log(memories))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X GET "https://api.mem0.ai/v1/memories/?agent_id=travel-assistant" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+[
+   {
+      "id":"f38b689d-6b24-45b7-bced-17fbb4d8bac7",
+      "memory":"是素食主义者，对坚果过敏。",
+      "agent_id":"travel-assistant",
+      "hash":"62bc074f56d1f909f1b4c2b639f56f6a",
+      "metadata":"None",
+      "created_at":"2024-07-25T23:57:00.108347-07:00",
+      "updated_at":"2024-07-25T23:57:00.108367-07:00"
+   },
+   {
+      "id":"0a14d8f0-e364-4f5c-b305-10da1f0d0878",
+      "memory":"Will maintain personalized travel preferences for each user. Provide customized recommendations based on dietary restrictions, interests, and past interactions.",
+      "agent_id":"travel-assistant",
+      "hash":"35a305373d639b0bffc6c2a3e2eb4244",
+      "metadata":"None",
+      "created_at":"2024-07-26T00:31:03.543759-07:00",
+      "updated_at":"2024-07-26T00:31:03.543778-07:00"
+   }
+]
+```
+</CodeGroup>
+
+#### Get all memories of user
+
+<CodeGroup>
+
+```python Python
+user_memories = client.get_all(user_id="alex")
+```
+
+```javascript JavaScript
+client.getAll({ user_id: "alex" })
+    .then(memories => console.log(memories))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X GET "https://api.mem0.ai/v1/memories/?user_id=alex" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+[
+   {
+      "id":"f38b689d-6b24-45b7-bced-17fbb4d8bac7",
+      "memory":"是素食主义者，对坚果过敏。",
+      "agent_id":"travel-assistant",
+      "hash":"62bc074f56d1f909f1b4c2b639f56f6a",
+      "metadata":"None",
+      "created_at":"2024-07-25T23:57:00.108347-07:00",
+      "updated_at":"2024-07-25T23:57:00.108367-07:00"
+   },
+   {
+      "id":"0a14d8f0-e364-4f5c-b305-10da1f0d0878",
+      "memory":"Will maintain personalized travel preferences for each user. Provide customized recommendations based on dietary restrictions, interests, and past interactions.",
+      "agent_id":"travel-assistant",
+      "hash":"35a305373d639b0bffc6c2a3e2eb4244",
+      "metadata":"None",
+      "created_at":"2024-07-26T00:31:03.543759-07:00",
+      "updated_at":"2024-07-26T00:31:03.543778-07:00"
+   }
+]
+```
+</CodeGroup>
+
+#### Get short-term memories for a session
+
+<CodeGroup>
+
+```python Python
+short_term_memories = client.get_all(user_id="alex123", session_id="trip-planning-2024")
+```
+
+```javascript JavaScript
+client.getAll({ user_id: "alex123", session_id: "trip-planning-2024" })
+    .then(memories => console.log(memories))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X GET "https://api.mem0.ai/v1/memories/?user_id=alex123&session_id=trip-planning-2024" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+[
+   {
+      "id":"06d8df63-7bd2-4fad-9acb-60871bcecee0",
+      "memory":"Planning a trip to Japan next month. Interested in vegetarian restaurants in Tokyo.",
+      "user_id":"alex123",
+      "hash":"d2088c936e259f2f5d2d75543d31401c",
+      "metadata":"None",
+      "created_at":"2024-07-26T00:25:16.566471-07:00",
+      "updated_at":"2024-07-26T00:25:16.566492-07:00"
+   },
+   {
+      "id":"b4229775-d860-4ccb-983f-0f628ca112f5",
+      "memory":"Planning a trip to Japan next month. Interested in vegetarian restaurants in Tokyo.",
+      "user_id":"alex123",
+      "hash":"d2088c936e259f2f5d2d75543d31401c",
+      "metadata":"None",
+      "created_at":"2024-07-26T00:33:20.350542-07:00",
+      "updated_at":"2024-07-26T00:33:20.350560-07:00"
+   },
+   {
+      "id":"df1aca24-76cf-4b92-9f58-d03857efcb64",
+      "memory":"Planning a trip to Japan next month. Interested in vegetarian restaurants in Tokyo.",
+      "user_id":"alex123",
+      "hash":"d2088c936e259f2f5d2d75543d31401c",
+      "metadata":"None",
+      "created_at":"2024-07-26T00:51:09.642275-07:00",
+      "updated_at":"2024-07-26T00:51:09.642295-07:00"
+   }
+]
+```
+</CodeGroup>
+
+#### Get specific memory
+
+<CodeGroup>
+
+```python Python
+memory = client.get(memory_id="582bbe6d-506b-48c6-a4c6-5df3b1e63428")
+```
+
+```javascript JavaScript
+client.get("582bbe6d-506b-48c6-a4c6-5df3b1e63428")
+    .then(memory => console.log(memory))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X GET "https://api.mem0.ai/v1/memories/582bbe6d-506b-48c6-a4c6-5df3b1e63428" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+{
+   "id":"06d8df63-7bd2-4fad-9acb-60871bcecee0",
+   "memory":"Planning a trip to Japan next month. Interested in vegetarian restaurants in Tokyo.",
+   "user_id":"alex123",
+   "hash":"d2088c936e259f2f5d2d75543d31401c",
+   "metadata":"None",
+   "created_at":"2024-07-26T00:25:16.566471-07:00",
+   "updated_at":"2024-07-26T00:25:16.566492-07:00"
+}
+```
+</CodeGroup>
+
+### 4.4 Memory History
+
+Get history of how a memory has changed over time
+
+<CodeGroup>
+
+```python Python
+# Add some message to create history
+messages = [{"role": "user", "content": "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."}]
+client.add(messages, user_id="alex")
+
+# Add second message to update history
+messages.append({'role': 'user', 'content': 'I turned vegetarian now.'})
+client.add(messages, user_id="alex")
+
+# Get history of how memory changed over time
+memory_id = "<memory-id-here>"
+history = client.history(memory_id)
+```
+
+```javascript JavaScript
+// Add some message to create history
+let messages = [{ role: "user", content: "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.." }];
+client.add(messages, { user_id: "alex" })
+    .then(result => {
+        // Add second message to update history
+        messages.push({ role: 'user', content: 'I turned vegetarian now.' });
+        return client.add(messages, { user_id: "alex" });
+    })
+    .then(result => {
+        // Get history of how memory changed over time
+        const memoryId = result.id; // Assuming the API returns the memory ID
+        return client.history(memoryId);
+    })
+    .then(history => console.log(history))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+# First, add the initial memory
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [{"role": "user", "content": "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."}],
+         "user_id": "alex"
+     }'
+
+# Then, update the memory
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [
+             {"role": "user", "content": "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."},
+             {"role": "user", "content": "I turned vegetarian now."}
+         ],
+         "user_id": "alex"
+     }'
+
+# Finally, get the history (replace <memory-id-here> with the actual memory ID)
+curl -X GET "https://api.mem0.ai/v1/memories/<memory-id-here>/history/" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+[
+   {
+      "id":"d6306e85-eaa6-400c-8c2f-ab994a8c4d09",
+      "memory_id":"b163df0e-ebc8-4098-95df-3f70a733e198",
+      "input":[
+         {
+            "role":"user",
+            "content":"I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."
+         },
+         {
+            "role":"user",
+            "content":"I turned vegetarian now."
+         }
+      ],
+      "old_memory":"None",
+      "new_memory":"Turned vegetarian.",
+      "user_id":"alex123456",
+      "event":"ADD",
+      "metadata":"None",
+      "created_at":"2024-07-26T01:02:41.737310-07:00",
+      "updated_at":"2024-07-26T01:02:41.726073-07:00"
+   }
+]
+```
+</CodeGroup>
+
+### 4.5 Update Memory
+
+Update a memory with new data.
+
+<CodeGroup>
+
+```python Python
+message = "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."
+client.update(memory_id, message)
+```
+
+```javascript JavaScript
+const message = "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes..";
+client.update("memory-id-here", message)
+    .then(result => console.log(result))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X PUT "https://api.mem0.ai/v1/memories/memory-id-here" \
+        -H "Authorization: Token your-api-key" \
+        -H "Content-Type: application/json" \
+        -d '{
+            "message": "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.."
+        }'
+```
+
+```json Output
+{
+   "id":"c190ab1a-a2f1-4f6f-914a-495e9a16b76e",
+   "memory":"I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes..",
+   "agent_id":"travel-assistant",
+   "hash":"af1161983e03667063d1abb60e6d5c06",
+   "metadata":"None",
+   "created_at":"2024-07-30T22:46:40.455758-07:00",
+   "updated_at":"2024-07-30T22:48:35.257828-07:00"
+}
+```
+
+</CodeGroup>
+
+### 4.6 Delete Memory
+
+Delete specific memory:
+
+<CodeGroup>
+
+```python Python
+client.delete(memory_id)
+```
+
+```javascript JavaScript
+client.delete("memory-id-here")
+    .then(result => console.log(result))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X DELETE "https://api.mem0.ai/v1/memories/memory-id-here" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+{'message': 'Memory deleted successfully'}
+```
+</CodeGroup>
+
+Delete all memories of a user:
+
+<CodeGroup>
+
+```python Python
+client.delete_all(user_id="alex")
+```
+
+```javascript JavaScript
+client.deleteAll({ user_id: "alex" })
+    .then(result => console.log(result))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X DELETE "https://api.mem0.ai/v1/memories/?user_id=alex" \
+     -H "Authorization: Token your-api-key"
+```
+
+```json Output
+{'message': 'Memories deleted successfully!'}
+```
+</CodeGroup>
+
+Fun fact: You can also delete the memory using the `add()` method by passing a natural language command:
+
+<CodeGroup>
+
+```python Python
+client.add("Delete all of my food preferences", user_id="alex")
+```
+
+```javascript JavaScript
+client.add("Delete all of my food preferences", { user_id: "alex" })
+    .then(result => console.log(result))
+    .catch(error => console.error(error));
+```
+
+```bash cURL
+curl -X POST "https://api.mem0.ai/v1/memories/" \
+     -H "Authorization: Token your-api-key" \
+     -H "Content-Type: application/json" \
+     -d '{
+         "messages": [{"role": "user", "content": "Delete all of my food preferences"}],
+         "user_id": "alex"
+     }'
+```
+
+```json Output
+{'message': 'ok'}
+```
+</CodeGroup>
+
+If you have any questions, please feel free to reach out to us using one of the following methods:
+
+<Snippet file="get-help.mdx" />

docs/quickstart.mdx

@@ -0,0 +1,298 @@
+---
+title: 🚀 Quickstart
+description: 'Get started with Mem0 quickly!'
+---
+
+> Welcome to the Mem0 quickstart guide. This guide will help you get up and running with Mem0 in no time.
+
+## Installation
+
+To install Mem0, you can use pip. Run the following command in your terminal:
+
+```bash
+pip install mem0ai
+```
+
+## Basic Usage
+
+### Initialize Mem0
+
+<Tabs>
+  <Tab title="Basic">
+```python
+from mem0 import Memory
+m = Memory()
+```
+  </Tab>
+  <Tab title="Advanced">
+If you want to run Mem0 in production, initialize using the following method:
+
+Run Qdrant first:
+
+```bash
+docker pull qdrant/qdrant
+
+docker run -p 6333:6333 -p 6334:6334 \
+    -v $(pwd)/qdrant_storage:/qdrant/storage:z \
+    qdrant/qdrant
+```
+
+Then, instantiate memory with qdrant server:
+
+```python
+from mem0 import Memory
+
+config = {
+    "vector_store": {
+        "provider": "qdrant",
+        "config": {
+            "host": "localhost",
+            "port": 6333,
+        }
+    },
+}
+
+m = Memory.from_config(config)
+```
+  </Tab>
+</Tabs>
+
+
+### Store a Memory
+
+<CodeGroup>
+```python Code
+# For a user
+result = m.add("Likes to play cricket on weekends", user_id="alice", metadata={"category": "hobbies"})
+```
+
+```json Output
+{'message': 'ok'}
+```
+</CodeGroup>
+
+### Retrieve Memories
+
+<CodeGroup>
+```python Code
+# Get all memories
+all_memories = m.get_all()
+```
+
+```json Output
+[
+   {
+      "id":"13efe83b-a8df-4ec0-814e-428d6e8451eb",
+      "memory":"Likes to play cricket on weekends",
+      "hash":"87bcddeb-fe45-4353-bc22-15a841c50308",
+      "metadata":"None",
+      "created_at":"2024-07-26T08:44:41.039788-07:00",
+      "updated_at":"None",
+      "user_id":"alice"
+   }
+]
+```
+</CodeGroup>
+
+<CodeGroup>
+```python Code
+# Get a single memory by ID
+specific_memory = m.get("m1")
+```
+
+```json Output
+{
+      "id":"13efe83b-a8df-4ec0-814e-428d6e8451eb",
+      "memory":"Likes to play cricket on weekends",
+      "hash":"87bcddeb-fe45-4353-bc22-15a841c50308",
+      "metadata":"None",
+      "created_at":"2024-07-26T08:44:41.039788-07:00",
+      "updated_at":"None",
+      "user_id":"alice"
+}
+```
+</CodeGroup>
+
+### Search Memories
+
+<CodeGroup>
+```python Code
+related_memories = m.search(query="What are Alice's hobbies?", user_id="alice")
+```
+
+```json Output
+[
+   {
+      "id":"ea925981-272f-40dd-b576-be64e4871429",
+      "memory":"Likes to play cricket and plays cricket on weekends.",
+      "hash":"c8809002-25c1-4c97-a3a2-227ce9c20c53",
+      "metadata":{
+         "category":"hobbies"
+      },
+      "score":0.32116443111457704,
+      "created_at":"2024-07-26T10:29:36.630547-07:00",
+      "updated_at":"None",
+      "user_id":"alice"
+   }
+]
+```
+</CodeGroup>
+
+### Update a Memory
+
+<CodeGroup>
+```python Code
+result = m.update(memory_id="m1", data="Likes to play tennis on weekends")
+```
+
+```json Output
+{'message': 'Memory updated successfully!'}
+```
+</CodeGroup>
+
+### Memory History
+
+<CodeGroup>
+```python Code
+history = m.history(memory_id="m1")
+```
+
+```json Output
+[
+   {
+      "id":"4e0e63d6-a9c6-43c0-b11c-a1bad3fc7abb",
+      "memory_id":"ea925981-272f-40dd-b576-be64e4871429",
+      "old_memory":"None",
+      "new_memory":"Likes to play cricket and plays cricket on weekends.",
+      "event":"ADD",
+      "created_at":"2024-07-26T10:29:36.630547-07:00",
+      "updated_at":"None"
+   },
+   {
+      "id":"548b75f0-f442-44b9-9ca1-772a105abb12",
+      "memory_id":"ea925981-272f-40dd-b576-be64e4871429",
+      "old_memory":"Likes to play cricket and plays cricket on weekends.",
+      "new_memory":"Likes to play tennis on weekends",
+      "event":"UPDATE",
+      "created_at":"2024-07-26T10:29:36.630547-07:00",
+      "updated_at":"2024-07-26T10:32:46.332336-07:00"
+   }
+]
+```
+</CodeGroup>
+
+### Delete Memory
+
+```python
+m.delete(memory_id="m1") # Delete a memory
+
+m.delete_all(user_id="alice") # Delete all memories
+```
+
+### Reset Memory
+
+```python
+m.reset() # Reset all memories
+```
+
+## Chat Completion
+
+Mem0 can be easily integrate into chat applications to enhance conversational agents with structured memory. Mem0's APIs are designed to be compatible with OpenAI's, with the goal of making it easy to leverage Mem0 in applications you may have already built.
+
+If you have a `Mem0 API key`, you can use it to initialize the client. Alternatively, you can initialize Mem0 without an API key if you're using it locally.
+
+Mem0 supports several language models (LLMs) through integration with various [providers](https://litellm.vercel.app/docs/providers).
+
+## Use Mem0 Platform
+
+```python
+from mem0 import Mem0
+
+client = Mem0(api_key="m0-xxx")
+
+# First interaction: Storing user preferences
+messages = [
+  {
+    "role": "user",
+    "content": "I love indian food but I cannot eat pizza since allergic to cheese."
+  },
+]
+user_id = "deshraj"
+chat_completion = client.chat.completions.create(messages=messages, model="gpt-4o-mini", user_id=user_id)
+# Memory saved after this will look like: "Loves Indian food. Allergic to cheese and cannot eat pizza."
+
+# Second interaction: Leveraging stored memory
+messages = [
+  {
+    "role": "user",
+    "content": "Suggest restaurants in San Francisco to eat.",
+  }
+]
+
+chat_completion = client.chat.completions.create(messages=messages, model="gpt-4o-mini", user_id=user_id)
+print(chat_completion.choices[0].message.content)
+# Answer: You might enjoy Indian restaurants in San Francisco, such as Amber India, Dosa, or Curry Up Now, which offer delicious options without cheese.
+```
+
+In this example, you can see how the second response is tailored based on the information provided in the first interaction. Mem0 remembers the user's preference for Indian food and their cheese allergy, using this information to provide more relevant and personalized restaurant suggestions in San Francisco.
+
+### Use Mem0 OSS
+
+```python
+config = {
+    "vector_store": {
+        "provider": "qdrant",
+        "config": {
+            "host": "localhost",
+            "port": 6333,
+        }
+    },
+}
+
+client = Mem0(config=config)
+
+chat_completion = client.chat.completions.create(
+    messages=[
+        {
+            "role": "user",
+            "content": "What's the capital of France?",
+        }
+    ],
+    model="gpt-4o",
+)
+```
+
+## APIs
+
+Get started with using Mem0 APIs in your applications. For more details, refer to the [Platform](/platform/quickstart.mdx).
+
+Here is an example of how to use Mem0 APIs:
+
+```python
+from mem0 import MemoryClient
+client = MemoryClient(api_key="your-api-key") # get api_key from https://app.mem0.ai/
+
+# Store messages
+messages = [
+    {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
+    {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
+]
+result = client.add(messages, user_id="alex")
+print(result)
+
+# Retrieve memories
+all_memories = client.get_all(user_id="alex")
+print(all_memories)
+
+# Search memories
+query = "What do you know about me?"
+related_memories = client.search(query, user_id="alex")
+
+# Get memory history
+history = client.history(memory_id="m1")
+print(history)
+```
+
+If you have any questions, please feel free to reach out to us using one of the following methods:
+
+<Snippet file="get-help.mdx" />

docs/snippets/snippet-intro.mdx

@@ -0,0 +1,4 @@
+One of the core principles of software development is DRY (Don't Repeat
+Yourself). This is a principle that apply to documentation as
+well. If you find yourself repeating the same content in multiple places, you
+should consider creating a custom snippet to keep your content in sync.

embedchain-js/.eslintignore

@@ -1,2 +0,0 @@
-node_modules
-dist

embedchain-js/.eslintrc

@@ -1,56 +0,0 @@
-{
-    // Configuration for JavaScript files
-    "extends": [
-      "airbnb-base",
-      "plugin:prettier/recommended"
-    ],
-    "rules": {
-      "prettier/prettier": [
-        "error",
-        {
-          "singleQuote": true,
-          "endOfLine": "auto"
-        }
-      ]
-    },
-    "overrides": [
-      // Configuration for TypeScript files
-      {
-        "files": ["**/*.ts", "**/__tests__/*.test.ts"],
-        "plugins": [
-          "@typescript-eslint",
-          "unused-imports",
-          "simple-import-sort"
-        ],
-        "extends": [
-          "airbnb-typescript",
-          "plugin:prettier/recommended"
-        ],
-        "parserOptions": {
-          "project": "./tsconfig.json"
-        },
-        "rules": {
-          "prettier/prettier": [
-            "error",
-            {
-              "singleQuote": true,
-              "endOfLine": "auto"
-            }
-          ],
-          "@typescript-eslint/comma-dangle": "off", // Avoid conflict rule between Eslint and Prettier
-          "@typescript-eslint/consistent-type-imports": "error", // Ensure `import type` is used when it's necessary
-          "import/prefer-default-export": "off", // Named export is easier to refactor automatically
-          "simple-import-sort/imports": "error", // Import configuration for `eslint-plugin-simple-import-sort`
-          "simple-import-sort/exports": "error", // Export configuration for `eslint-plugin-simple-import-sort`
-          "@typescript-eslint/no-unused-vars": "off",
-          "react/jsx-filename-extension": "off", // Gives error
-          "unused-imports/no-unused-imports": "error",
-          "unused-imports/no-unused-vars": [
-            "error",
-            { "argsIgnorePattern": "^_" }
-          ]
-        }
-      }
-    ]
-  }
-  

embedchain-js/.github/workflows/npm-publish.yml

@@ -1,47 +0,0 @@
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16
-      - run: npm ci
-      - run: npm test
-      - run: npm run build
-      - uses: actions/upload-artifact@v3
-        with:
-          name: dist
-          path: dist
-      - uses: actions/upload-artifact@v3
-        with:
-          name: types
-          path: types
-
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16
-          registry-url: https://registry.npmjs.org/
-      - uses: actions/download-artifact@v3
-        with:
-          name: dist
-          path: dist
-      - uses: actions/download-artifact@v3
-        with:
-          name: types
-          path: types
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

embedchain-js/.gitignore

@@ -1,138 +0,0 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional stylelint cache
-.stylelintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variable files
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-.temp
-.cache
-
-# Docusaurus cache and generated files
-.docusaurus
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-.ideas.md
-.todos.md
-
-# Custom
-dist
-types
-build

embedchain-js/.husky/commit-msg

@@ -1,4 +0,0 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx --no -- commitlint --edit $1

embedchain-js/.husky/pre-commit

@@ -1,5 +0,0 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-# Disable concurent to run `check-types` after ESLint in lint-staged
-npx lint-staged --concurrent false

embedchain-js/CITATION.cff

@@ -1,8 +0,0 @@
-cff-version: 1.2.0
-message: "If you use this software, please cite it as below."
-authors:
-- family-names: "Singh"
-  given-names: "Taranjeet"
-title: "Embedchain"
-date-released: 2023-06-25
-url: "https://github.com/embedchain/embedchainjs"

embedchain-js/README.md

@@ -1,263 +0,0 @@
-# embedchainjs
-
-[![Discord](https://dcbadge.vercel.app/api/server/CUU9FPhRNt?style=flat)](https://discord.gg/CUU9FPhRNt)
-[![Twitter](https://img.shields.io/twitter/follow/embedchain)](https://twitter.com/embedchain)
-[![Substack](https://img.shields.io/badge/Substack-%23006f5c.svg?logo=substack)](https://embedchain.substack.com/)
-
-embedchain is a framework to easily create LLM powered bots over any dataset. embedchainjs is Javascript version of embedchain. If you want a python version, check out [embedchain-python](https://github.com/embedchain/embedchain)
-
-# 🤝 Let's Talk Embedchain!
-
-Schedule a [Feedback Session](https://cal.com/taranjeetio/ec) with Taranjeet, the founder, to discuss any issues, provide feedback, or explore improvements.
-
-# How it works
-
-It abstracts the entire process of loading dataset, chunking it, creating embeddings and then storing in vector database.
-
-You can add a single or multiple dataset using `.add` and `.addLocal` function and then use `.query` function to find an answer from the added datasets.
-
-If you want to create a Naval Ravikant bot which has 2 of his blog posts, as well as a question and answer pair you supply, all you need to do is add the links to the blog posts and the QnA pair and embedchain will create a bot for you.
-
-```javascript
-const dotenv = require("dotenv");
-dotenv.config();
-const { App } = require("embedchain");
-
-//Run the app commands inside an async function only
-async function testApp() {
-  const navalChatBot = await App();
-
-  // Embed Online Resources
-  await navalChatBot.add("web_page", "https://nav.al/feedback");
-  await navalChatBot.add("web_page", "https://nav.al/agi");
-  await navalChatBot.add(
-    "pdf_file",
-    "https://navalmanack.s3.amazonaws.com/Eric-Jorgenson_The-Almanack-of-Naval-Ravikant_Final.pdf"
-  );
-
-  // Embed Local Resources
-  await navalChatBot.addLocal("qna_pair", [
-    "Who is Naval Ravikant?",
-    "Naval Ravikant is an Indian-American entrepreneur and investor.",
-  ]);
-
-  const result = await navalChatBot.query(
-    "What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?"
-  );
-  console.log(result);
-  // answer: Naval argues that humans possess the unique capacity to understand explanations or concepts to the maximum extent possible in this physical reality.
-}
-
-testApp();
-```
-
-# Getting Started
-
-## Installation
-
-- First make sure that you have the package installed. If not, then install it using `npm`
-
-```bash
-npm install embedchain && npm install -S openai@^3.3.0
-```
-
-- Currently, it is only compatible with openai 3.X, not the latest version 4.X. Please make sure to use the right version, otherwise you will see the `ChromaDB` error `TypeError: OpenAIApi.Configuration is not a constructor`
-
-- Make sure that dotenv package is installed and your `OPENAI_API_KEY` in a file called `.env` in the root folder. You can install dotenv by
-
-```js
-npm install dotenv
-```
-
-- Download and install Docker on your device by visiting [this link](https://www.docker.com/). You will need this to run Chroma vector database on your machine.
-
-- Run the following commands to setup Chroma container in Docker
-
-```bash
-git clone https://github.com/chroma-core/chroma.git
-cd chroma
-docker-compose up -d --build
-```
-
-- Once Chroma container has been set up, run it inside Docker
-
-## Usage
-
-- We use OpenAI's embedding model to create embeddings for chunks and ChatGPT API as LLM to get answer given the relevant docs. Make sure that you have an OpenAI account and an API key. If you have dont have an API key, you can create one by visiting [this link](https://platform.openai.com/account/api-keys).
-
-- Once you have the API key, set it in an environment variable called `OPENAI_API_KEY`
-
-```js
-// Set this inside your .env file
-OPENAI_API_KEY = "sk-xxxx";
-```
-
-- Load the environment variables inside your .js file using the following commands
-
-```js
-const dotenv = require("dotenv");
-dotenv.config();
-```
-
-- Next import the `App` class from embedchain and use `.add` function to add any dataset.
-- Now your app is created. You can use `.query` function to get the answer for any query.
-
-```js
-const dotenv = require("dotenv");
-dotenv.config();
-const { App } = require("embedchain");
-
-async function testApp() {
-  const navalChatBot = await App();
-
-  // Embed Online Resources
-  await navalChatBot.add("web_page", "https://nav.al/feedback");
-  await navalChatBot.add("web_page", "https://nav.al/agi");
-  await navalChatBot.add(
-    "pdf_file",
-    "https://navalmanack.s3.amazonaws.com/Eric-Jorgenson_The-Almanack-of-Naval-Ravikant_Final.pdf"
-  );
-
-  // Embed Local Resources
-  await navalChatBot.addLocal("qna_pair", [
-    "Who is Naval Ravikant?",
-    "Naval Ravikant is an Indian-American entrepreneur and investor.",
-  ]);
-
-  const result = await navalChatBot.query(
-    "What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?"
-  );
-  console.log(result);
-  // answer: Naval argues that humans possess the unique capacity to understand explanations or concepts to the maximum extent possible in this physical reality.
-}
-
-testApp();
-```
-
-- If there is any other app instance in your script or app, you can change the import as
-
-```javascript
-const { App: EmbedChainApp } = require("embedchain");
-
-// or
-
-const { App: ECApp } = require("embedchain");
-```
-
-## Format supported
-
-We support the following formats:
-
-### PDF File
-
-To add any pdf file, use the data_type as `pdf_file`. Eg:
-
-```javascript
-await app.add("pdf_file", "a_valid_url_where_pdf_file_can_be_accessed");
-```
-
-### Web Page
-
-To add any web page, use the data_type as `web_page`. Eg:
-
-```javascript
-await app.add("web_page", "a_valid_web_page_url");
-```
-
-### QnA Pair
-
-To supply your own QnA pair, use the data_type as `qna_pair` and enter a tuple. Eg:
-
-```javascript
-await app.addLocal("qna_pair", ["Question", "Answer"]);
-```
-
-### More Formats coming soon
-
-- If you want to add any other format, please create an [issue](https://github.com/embedchain/embedchainjs/issues) and we will add it to the list of supported formats.
-
-## Testing
-
-Before you consume valueable tokens, you should make sure that the embedding you have done works and that it's receiving the correct document from the database.
-
-For this you can use the `dryRun` method.
-
-Following the example above, add this to your script:
-
-```js
-let result = await naval_chat_bot.dryRun("What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?");console.log(result);
-
-'''
-Use the following pieces of context to answer the query at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
-terms of the unseen. And I think that’s critical. That is what humans do uniquely that no other creature, no other computer, no other intelligence—biological or artificial—that we have ever encountered does. And not only do we do it uniquely, but if we were to meet an alien species that also had the power to generate these good explanations, there is no explanation that they could generate that we could not understand. We are maximally capable of understanding. There is no concept out there that is possible in this physical reality that a human being, given sufficient time and resources and
-Query: What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?
-Helpful Answer:
-'''
-```
-
-_The embedding is confirmed to work as expected. It returns the right document, even if the question is asked slightly different. No prompt tokens have been consumed._
-
-**The dry run will still consume tokens to embed your query, but it is only ~1/15 of the prompt.**
-
-# How does it work?
-
-Creating a chat bot over any dataset needs the following steps to happen
-
-- load the data
-- create meaningful chunks
-- create embeddings for each chunk
-- store the chunks in vector database
-
-Whenever a user asks any query, following process happens to find the answer for the query
-
-- create the embedding for query
-- find similar documents for this query from vector database
-- pass similar documents as context to LLM to get the final answer.
-
-The process of loading the dataset and then querying involves multiple steps and each steps has nuances of it is own.
-
-- How should I chunk the data? What is a meaningful chunk size?
-- How should I create embeddings for each chunk? Which embedding model should I use?
-- How should I store the chunks in vector database? Which vector database should I use?
-- Should I store meta data along with the embeddings?
-- How should I find similar documents for a query? Which ranking model should I use?
-
-These questions may be trivial for some but for a lot of us, it needs research, experimentation and time to find out the accurate answers.
-
-embedchain is a framework which takes care of all these nuances and provides a simple interface to create bots over any dataset.
-
-In the first release, we are making it easier for anyone to get a chatbot over any dataset up and running in less than a minute. All you need to do is create an app instance, add the data sets using `.add` function and then use `.query` function to get the relevant answer.
-
-# Tech Stack
-
-embedchain is built on the following stack:
-
-- [Langchain](https://github.com/hwchase17/langchain) as an LLM framework to load, chunk and index data
-- [OpenAI's Ada embedding model](https://platform.openai.com/docs/guides/embeddings) to create embeddings
-- [OpenAI's ChatGPT API](https://platform.openai.com/docs/guides/gpt/chat-completions-api) as LLM to get answers given the context
-- [Chroma](https://github.com/chroma-core/chroma) as the vector database to store embeddings
-
-# Team
-
-## Author
-
-- Taranjeet Singh ([@taranjeetio](https://twitter.com/taranjeetio))
-
-## Maintainer
-
-- [cachho](https://github.com/cachho)
-- [sahilyadav902](https://github.com/sahilyadav902)
-
-## Citation
-
-If you utilize this repository, please consider citing it with:
-```
-@misc{embedchain,
-  author = {Taranjeet Singh},
-  title = {Embechain: Framework to easily create LLM powered bots over any dataset},
-  year = {2023},
-  publisher = {GitHub},
-  journal = {GitHub repository},
-  howpublished = {\url{https://github.com/embedchain/embedchainjs}},
-}
-```

embedchain-js/commitlint.config.js

@@ -1 +0,0 @@
-module.exports = { extends: ['@commitlint/config-conventional'] };

embedchain-js/embedchain/__tests__/readme.test.ts

@@ -1,66 +0,0 @@
-import { EmbedChainApp } from '../embedchain';
-
-const mockAdd = jest.fn();
-const mockAddLocal = jest.fn();
-const mockQuery = jest.fn();
-
-jest.mock('../embedchain', () => {
-  return {
-    EmbedChainApp: jest.fn().mockImplementation(() => {
-      return {
-        add: mockAdd,
-        addLocal: mockAddLocal,
-        query: mockQuery,
-      };
-    }),
-  };
-});
-
-describe('Test App', () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it('tests the App', async () => {
-    mockQuery.mockResolvedValue(
-      'Naval argues that humans possess the unique capacity to understand explanations or concepts to the maximum extent possible in this physical reality.'
-    );
-
-    const navalChatBot = await new EmbedChainApp(undefined, false);
-
-    // Embed Online Resources
-    await navalChatBot.add('web_page', 'https://nav.al/feedback');
-    await navalChatBot.add('web_page', 'https://nav.al/agi');
-    await navalChatBot.add(
-      'pdf_file',
-      'https://navalmanack.s3.amazonaws.com/Eric-Jorgenson_The-Almanack-of-Naval-Ravikant_Final.pdf'
-    );
-
-    // Embed Local Resources
-    await navalChatBot.addLocal('qna_pair', [
-      'Who is Naval Ravikant?',
-      'Naval Ravikant is an Indian-American entrepreneur and investor.',
-    ]);
-
-    const result = await navalChatBot.query(
-      'What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?'
-    );
-
-    expect(mockAdd).toHaveBeenCalledWith('web_page', 'https://nav.al/feedback');
-    expect(mockAdd).toHaveBeenCalledWith('web_page', 'https://nav.al/agi');
-    expect(mockAdd).toHaveBeenCalledWith(
-      'pdf_file',
-      'https://navalmanack.s3.amazonaws.com/Eric-Jorgenson_The-Almanack-of-Naval-Ravikant_Final.pdf'
-    );
-    expect(mockAddLocal).toHaveBeenCalledWith('qna_pair', [
-      'Who is Naval Ravikant?',
-      'Naval Ravikant is an Indian-American entrepreneur and investor.',
-    ]);
-    expect(mockQuery).toHaveBeenCalledWith(
-      'What unique capacity does Naval argue humans possess when it comes to understanding explanations or concepts?'
-    );
-    expect(result).toBe(
-      'Naval argues that humans possess the unique capacity to understand explanations or concepts to the maximum extent possible in this physical reality.'
-    );
-  });
-});

embedchain-js/embedchain/chunkers/BaseChunker.ts

@@ -1,44 +0,0 @@
-import { createHash } from 'crypto';
-import type { RecursiveCharacterTextSplitter } from 'langchain/text_splitter';
-
-import type { BaseLoader } from '../loaders';
-import type { Input, LoaderResult } from '../models';
-import type { ChunkResult } from '../models/ChunkResult';
-
-class BaseChunker {
-  textSplitter: RecursiveCharacterTextSplitter;
-
-  constructor(textSplitter: RecursiveCharacterTextSplitter) {
-    this.textSplitter = textSplitter;
-  }
-
-  async createChunks(loader: BaseLoader, url: Input): Promise<ChunkResult> {
-    const documents: ChunkResult['documents'] = [];
-    const ids: ChunkResult['ids'] = [];
-    const datas: LoaderResult = await loader.loadData(url);
-    const metadatas: ChunkResult['metadatas'] = [];
-
-    const dataPromises = datas.map(async (data) => {
-      const { content, metaData } = data;
-      const chunks: string[] = await this.textSplitter.splitText(content);
-      chunks.forEach((chunk) => {
-        const chunkId = createHash('sha256')
-          .update(chunk + metaData.url)
-          .digest('hex');
-        ids.push(chunkId);
-        documents.push(chunk);
-        metadatas.push(metaData);
-      });
-    });
-
-    await Promise.all(dataPromises);
-
-    return {
-      documents,
-      ids,
-      metadatas,
-    };
-  }
-}
-
-export { BaseChunker };

embedchain-js/embedchain/chunkers/PdfFile.ts

@@ -1,26 +0,0 @@
-import { RecursiveCharacterTextSplitter } from 'langchain/text_splitter';
-
-import { BaseChunker } from './BaseChunker';
-
-interface TextSplitterChunkParams {
-  chunkSize: number;
-  chunkOverlap: number;
-  keepSeparator: boolean;
-}
-
-const TEXT_SPLITTER_CHUNK_PARAMS: TextSplitterChunkParams = {
-  chunkSize: 1000,
-  chunkOverlap: 0,
-  keepSeparator: false,
-};
-
-class PdfFileChunker extends BaseChunker {
-  constructor() {
-    const textSplitter = new RecursiveCharacterTextSplitter(
-      TEXT_SPLITTER_CHUNK_PARAMS
-    );
-    super(textSplitter);
-  }
-}
-
-export { PdfFileChunker };

embedchain-js/embedchain/chunkers/QnaPair.ts

@@ -1,26 +0,0 @@
-import { RecursiveCharacterTextSplitter } from 'langchain/text_splitter';
-
-import { BaseChunker } from './BaseChunker';
-
-interface TextSplitterChunkParams {
-  chunkSize: number;
-  chunkOverlap: number;
-  keepSeparator: boolean;
-}
-
-const TEXT_SPLITTER_CHUNK_PARAMS: TextSplitterChunkParams = {
-  chunkSize: 300,
-  chunkOverlap: 0,
-  keepSeparator: false,
-};
-
-class QnaPairChunker extends BaseChunker {
-  constructor() {
-    const textSplitter = new RecursiveCharacterTextSplitter(
-      TEXT_SPLITTER_CHUNK_PARAMS
-    );
-    super(textSplitter);
-  }
-}
-
-export { QnaPairChunker };

embedchain-js/embedchain/chunkers/WebPage.ts

@@ -1,26 +0,0 @@
-import { RecursiveCharacterTextSplitter } from 'langchain/text_splitter';
-
-import { BaseChunker } from './BaseChunker';
-
-interface TextSplitterChunkParams {
-  chunkSize: number;
-  chunkOverlap: number;
-  keepSeparator: boolean;
-}
-
-const TEXT_SPLITTER_CHUNK_PARAMS: TextSplitterChunkParams = {
-  chunkSize: 500,
-  chunkOverlap: 0,
-  keepSeparator: false,
-};
-
-class WebPageChunker extends BaseChunker {
-  constructor() {
-    const textSplitter = new RecursiveCharacterTextSplitter(
-      TEXT_SPLITTER_CHUNK_PARAMS
-    );
-    super(textSplitter);
-  }
-}
-
-export { WebPageChunker };

embedchain-js/embedchain/chunkers/index.ts

@@ -1,6 +0,0 @@
-import { BaseChunker } from './BaseChunker';
-import { PdfFileChunker } from './PdfFile';
-import { QnaPairChunker } from './QnaPair';
-import { WebPageChunker } from './WebPage';
-
-export { BaseChunker, PdfFileChunker, QnaPairChunker, WebPageChunker };

embedchain-js/embedchain/embedchain.ts

@@ -1,317 +0,0 @@
-/* eslint-disable max-classes-per-file */
-import type { Collection } from 'chromadb';
-import type { QueryResponse } from 'chromadb/dist/main/types';
-import * as fs from 'fs';
-import { Document } from 'langchain/document';
-import OpenAI from 'openai';
-import * as path from 'path';
-import { v4 as uuidv4 } from 'uuid';
-
-import type { BaseChunker } from './chunkers';
-import { PdfFileChunker, QnaPairChunker, WebPageChunker } from './chunkers';
-import type { BaseLoader } from './loaders';
-import { LocalQnaPairLoader, PdfFileLoader, WebPageLoader } from './loaders';
-import type {
-  DataDict,
-  DataType,
-  FormattedResult,
-  Input,
-  LocalInput,
-  Metadata,
-  Method,
-  RemoteInput,
-} from './models';
-import { ChromaDB } from './vectordb';
-import type { BaseVectorDB } from './vectordb/BaseVectorDb';
-
-const openai = new OpenAI({
-  apiKey: process.env.OPENAI_API_KEY,
-});
-
-class EmbedChain {
-  dbClient: any;
-
-  // TODO: Definitely assign
-  collection!: Collection;
-
-  userAsks: [DataType, Input][] = [];
-
-  initApp: Promise<void>;
-
-  collectMetrics: boolean;
-
-  sId: string; // sessionId
-
-  constructor(db?: BaseVectorDB, collectMetrics: boolean = true) {
-    if (!db) {
-      this.initApp = this.setupChroma();
-    } else {
-      this.initApp = this.setupOther(db);
-    }
-
-    this.collectMetrics = collectMetrics;
-
-    // Send anonymous telemetry
-    this.sId = uuidv4();
-    this.sendTelemetryEvent('init');
-  }
-
-  async setupChroma(): Promise<void> {
-    const db = new ChromaDB();
-    await db.initDb;
-    this.dbClient = db.client;
-    if (db.collection) {
-      this.collection = db.collection;
-    } else {
-      // TODO: Add proper error handling
-      console.error('No collection');
-    }
-  }
-
-  async setupOther(db: BaseVectorDB): Promise<void> {
-    await db.initDb;
-    // TODO: Figure out how we can initialize an unknown database.
-    // this.dbClient = db.client;
-    // this.collection = db.collection;
-    this.userAsks = [];
-  }
-
-  static getLoader(dataType: DataType) {
-    const loaders: { [t in DataType]: BaseLoader } = {
-      pdf_file: new PdfFileLoader(),
-      web_page: new WebPageLoader(),
-      qna_pair: new LocalQnaPairLoader(),
-    };
-    return loaders[dataType];
-  }
-
-  static getChunker(dataType: DataType) {
-    const chunkers: { [t in DataType]: BaseChunker } = {
-      pdf_file: new PdfFileChunker(),
-      web_page: new WebPageChunker(),
-      qna_pair: new QnaPairChunker(),
-    };
-    return chunkers[dataType];
-  }
-
-  public async add(dataType: DataType, url: RemoteInput) {
-    const loader = EmbedChain.getLoader(dataType);
-    const chunker = EmbedChain.getChunker(dataType);
-    this.userAsks.push([dataType, url]);
-    const { documents, countNewChunks } = await this.loadAndEmbed(
-      loader,
-      chunker,
-      url
-    );
-
-    if (this.collectMetrics) {
-      const wordCount = documents.reduce(
-        (sum, document) => sum + document.split(' ').length,
-        0
-      );
-
-      this.sendTelemetryEvent('add', {
-        data_type: dataType,
-        word_count: wordCount,
-        chunks_count: countNewChunks,
-      });
-    }
-  }
-
-  public async addLocal(dataType: DataType, content: LocalInput) {
-    const loader = EmbedChain.getLoader(dataType);
-    const chunker = EmbedChain.getChunker(dataType);
-    this.userAsks.push([dataType, content]);
-    const { documents, countNewChunks } = await this.loadAndEmbed(
-      loader,
-      chunker,
-      content
-    );
-
-    if (this.collectMetrics) {
-      const wordCount = documents.reduce(
-        (sum, document) => sum + document.split(' ').length,
-        0
-      );
-
-      this.sendTelemetryEvent('add_local', {
-        data_type: dataType,
-        word_count: wordCount,
-        chunks_count: countNewChunks,
-      });
-    }
-  }
-
-  protected async loadAndEmbed(
-    loader: any,
-    chunker: BaseChunker,
-    src: Input
-  ): Promise<{
-    documents: string[];
-    metadatas: Metadata[];
-    ids: string[];
-    countNewChunks: number;
-  }> {
-    const embeddingsData = await chunker.createChunks(loader, src);
-    let { documents, ids, metadatas } = embeddingsData;
-
-    const existingDocs = await this.collection.get({ ids });
-    const existingIds = new Set(existingDocs.ids);
-
-    if (existingIds.size > 0) {
-      const dataDict: DataDict = {};
-      for (let i = 0; i < ids.length; i += 1) {
-        const id = ids[i];
-        if (!existingIds.has(id)) {
-          dataDict[id] = { doc: documents[i], meta: metadatas[i] };
-        }
-      }
-
-      if (Object.keys(dataDict).length === 0) {
-        console.log(`All data from ${src} already exists in the database.`);
-        return { documents: [], metadatas: [], ids: [], countNewChunks: 0 };
-      }
-      ids = Object.keys(dataDict);
-      const dataValues = Object.values(dataDict);
-      documents = dataValues.map(({ doc }) => doc);
-      metadatas = dataValues.map(({ meta }) => meta);
-    }
-
-    const countBeforeAddition = await this.count();
-    await this.collection.add({ documents, metadatas, ids });
-    const countNewChunks = (await this.count()) - countBeforeAddition;
-    console.log(
-      `Successfully saved ${src}. New chunks count: ${countNewChunks}`
-    );
-    return { documents, metadatas, ids, countNewChunks };
-  }
-
-  static async formatResult(
-    results: QueryResponse
-  ): Promise<FormattedResult[]> {
-    return results.documents[0].map((document: any, index: number) => {
-      const metadata = results.metadatas[0][index] || {};
-      // TODO: Add proper error handling
-      const distance = results.distances ? results.distances[0][index] : null;
-      return [new Document({ pageContent: document, metadata }), distance];
-    });
-  }
-
-  static async getOpenAiAnswer(prompt: string) {
-    const messages: OpenAI.Chat.CreateChatCompletionRequestMessage[] = [
-      { role: 'user', content: prompt },
-    ];
-    const response = await openai.chat.completions.create({
-      model: 'gpt-3.5-turbo',
-      messages,
-      temperature: 0,
-      max_tokens: 1000,
-      top_p: 1,
-    });
-    return (
-      response.choices[0].message?.content ?? 'Response could not be processed.'
-    );
-  }
-
-  protected async retrieveFromDatabase(inputQuery: string) {
-    const result = await this.collection.query({
-      nResults: 1,
-      queryTexts: [inputQuery],
-    });
-    const resultFormatted = await EmbedChain.formatResult(result);
-    const content = resultFormatted[0][0].pageContent;
-    return content;
-  }
-
-  static generatePrompt(inputQuery: string, context: any) {
-    const prompt = `Use the following pieces of context to answer the query at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.\n${context}\nQuery: ${inputQuery}\nHelpful Answer:`;
-    return prompt;
-  }
-
-  static async getAnswerFromLlm(prompt: string) {
-    const answer = await EmbedChain.getOpenAiAnswer(prompt);
-    return answer;
-  }
-
-  public async query(inputQuery: string) {
-    const context = await this.retrieveFromDatabase(inputQuery);
-    const prompt = EmbedChain.generatePrompt(inputQuery, context);
-    const answer = await EmbedChain.getAnswerFromLlm(prompt);
-    this.sendTelemetryEvent('query');
-    return answer;
-  }
-
-  public async dryRun(input_query: string) {
-    const context = await this.retrieveFromDatabase(input_query);
-    const prompt = EmbedChain.generatePrompt(input_query, context);
-    return prompt;
-  }
-
-  /**
-   * Count the number of embeddings.
-   * @returns {Promise<number>}: The number of embeddings.
-   */
-  public count(): Promise<number> {
-    return this.collection.count();
-  }
-
-  protected async sendTelemetryEvent(method: Method, extraMetadata?: object) {
-    if (!this.collectMetrics) {
-      return;
-    }
-    const url = 'https://api.embedchain.ai/api/v1/telemetry/';
-
-    // Read package version from filesystem (because it's not in the ts root dir)
-    const packageJsonPath = path.join(__dirname, '..', 'package.json');
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-
-    const metadata = {
-      s_id: this.sId,
-      version: packageJson.version,
-      method,
-      language: 'js',
-      ...extraMetadata,
-    };
-
-    const maxRetries = 3;
-
-    // Retry the fetch
-    for (let i = 0; i < maxRetries; i += 1) {
-      try {
-        // eslint-disable-next-line no-await-in-loop
-        const response = await fetch(url, {
-          method: 'POST',
-          body: JSON.stringify({ metadata }),
-        });
-
-        if (response.ok) {
-          // Break out of the loop if the request was successful
-          break;
-        } else {
-          // Log the unsuccessful response (optional)
-          console.error(
-            `Telemetry: Attempt ${i + 1} failed with status:`,
-            response.status
-          );
-        }
-      } catch (error) {
-        // Log the error (optional)
-        console.error(`Telemetry: Attempt ${i + 1} failed with error:`, error);
-      }
-
-      // If this was the last attempt, throw an error or handle the failure
-      if (i === maxRetries - 1) {
-        console.error('Telemetry: Max retries reached');
-      }
-    }
-  }
-}
-
-class EmbedChainApp extends EmbedChain {
-  // The EmbedChain app.
-  // Has two functions: add and query.
-  // adds(dataType, url): adds the data from the given URL to the vector db.
-  // query(query): finds answer to the given query using vector database and LLM.
-}
-
-export { EmbedChainApp };

embedchain-js/embedchain/index.ts

@@ -1,7 +0,0 @@
-import { EmbedChainApp } from './embedchain';
-
-export const App = async () => {
-  const app = new EmbedChainApp();
-  await app.initApp;
-  return app;
-};

embedchain-js/embedchain/loaders/BaseLoader.ts

@@ -1,5 +0,0 @@
-import type { Input, LoaderResult } from '../models';
-
-export abstract class BaseLoader {
-  abstract loadData(src: Input): Promise<LoaderResult>;
-}

embedchain-js/embedchain/loaders/LocalQnaPair.ts

@@ -1,21 +0,0 @@
-import type { LoaderResult, QnaPair } from '../models';
-import { BaseLoader } from './BaseLoader';
-
-class LocalQnaPairLoader extends BaseLoader {
-  // eslint-disable-next-line class-methods-use-this
-  async loadData(content: QnaPair): Promise<LoaderResult> {
-    const [question, answer] = content;
-    const contentText = `Q: ${question}\nA: ${answer}`;
-    const metaData = {
-      url: 'local',
-    };
-    return [
-      {
-        content: contentText,
-        metaData,
-      },
-    ];
-  }
-}
-
-export { LocalQnaPairLoader };

embedchain-js/embedchain/loaders/PdfFile.ts

@@ -1,58 +0,0 @@
-import type { TextContent } from 'pdfjs-dist/types/src/display/api';
-
-import type { LoaderResult, Metadata } from '../models';
-import { cleanString } from '../utils';
-import { BaseLoader } from './BaseLoader';
-
-const pdfjsLib = require('pdfjs-dist');
-
-interface Page {
-  page_content: string;
-}
-
-class PdfFileLoader extends BaseLoader {
-  static async getPagesFromPdf(url: string): Promise<Page[]> {
-    const loadingTask = pdfjsLib.getDocument(url);
-    const pdf = await loadingTask.promise;
-    const { numPages } = pdf;
-
-    const promises = Array.from({ length: numPages }, async (_, i) => {
-      const page = await pdf.getPage(i + 1);
-      const pageText: TextContent = await page.getTextContent();
-      const pageContent: string = pageText.items
-        .map((item) => ('str' in item ? item.str : ''))
-        .join(' ');
-
-      return {
-        page_content: pageContent,
-      };
-    });
-
-    return Promise.all(promises);
-  }
-
-  // eslint-disable-next-line class-methods-use-this
-  async loadData(url: string): Promise<LoaderResult> {
-    const pages: Page[] = await PdfFileLoader.getPagesFromPdf(url);
-    const output: LoaderResult = [];
-
-    if (!pages.length) {
-      throw new Error('No data found');
-    }
-
-    pages.forEach((page) => {
-      let content: string = page.page_content;
-      content = cleanString(content);
-      const metaData: Metadata = {
-        url,
-      };
-      output.push({
-        content,
-        metaData,
-      });
-    });
-    return output;
-  }
-}
-
-export { PdfFileLoader };

embedchain-js/embedchain/loaders/WebPage.ts

@@ -1,51 +0,0 @@
-import axios from 'axios';
-import { JSDOM } from 'jsdom';
-
-import { cleanString } from '../utils';
-import { BaseLoader } from './BaseLoader';
-
-class WebPageLoader extends BaseLoader {
-  // eslint-disable-next-line class-methods-use-this
-  async loadData(url: string) {
-    const response = await axios.get(url);
-    const html = response.data;
-    const dom = new JSDOM(html);
-    const { document } = dom.window;
-    const unwantedTags = [
-      'nav',
-      'aside',
-      'form',
-      'header',
-      'noscript',
-      'svg',
-      'canvas',
-      'footer',
-      'script',
-      'style',
-    ];
-    unwantedTags.forEach((tagName) => {
-      const elements = document.getElementsByTagName(tagName);
-      Array.from(elements).forEach((element) => {
-        // eslint-disable-next-line no-param-reassign
-        (element as HTMLElement).textContent = ' ';
-      });
-    });
-
-    const output = [];
-    let content = document.body.textContent;
-    if (!content) {
-      throw new Error('Web page content is empty.');
-    }
-    content = cleanString(content);
-    const metaData = {
-      url,
-    };
-    output.push({
-      content,
-      metaData,
-    });
-    return output;
-  }
-}
-
-export { WebPageLoader };

embedchain-js/embedchain/loaders/index.ts

@@ -1,6 +0,0 @@
-import { BaseLoader } from './BaseLoader';
-import { LocalQnaPairLoader } from './LocalQnaPair';
-import { PdfFileLoader } from './PdfFile';
-import { WebPageLoader } from './WebPage';
-
-export { BaseLoader, LocalQnaPairLoader, PdfFileLoader, WebPageLoader };

embedchain-js/embedchain/models/ChunkResult.ts

@@ -1,7 +0,0 @@
-import type { Metadata } from './Metadata';
-
-export type ChunkResult = {
-  documents: string[];
-  ids: string[];
-  metadatas: Metadata[];
-};

embedchain-js/embedchain/models/DataDict.ts

@@ -1,10 +0,0 @@
-import type { ChunkResult } from './ChunkResult';
-
-type Data = {
-  doc: ChunkResult['documents'][0];
-  meta: ChunkResult['metadatas'][0];
-};
-
-export type DataDict = {
-  [id: string]: Data;
-};

embedchain-js/embedchain/models/DataType.ts

@@ -1 +0,0 @@
-export type DataType = 'pdf_file' | 'web_page' | 'qna_pair';

embedchain-js/embedchain/models/FormattedResult.ts

@@ -1,3 +0,0 @@
-import type { Document } from 'langchain/document';
-
-export type FormattedResult = [Document, number | null];

embedchain-js/embedchain/models/Input.ts

@@ -1,7 +0,0 @@
-import type { QnaPair } from './QnAPair';
-
-export type RemoteInput = string;
-
-export type LocalInput = QnaPair;
-
-export type Input = RemoteInput | LocalInput;

embedchain-js/embedchain/models/LoaderResult.ts

@@ -1,3 +0,0 @@
-import type { Metadata } from './Metadata';
-
-export type LoaderResult = { content: any; metaData: Metadata }[];

embedchain-js/embedchain/models/Metadata.ts

@@ -1,3 +0,0 @@
-export type Metadata = {
-  url: string;
-};

embedchain-js/embedchain/models/Method.ts

@@ -1 +0,0 @@
-export type Method = 'init' | 'query' | 'add' | 'add_local';

embedchain-js/embedchain/models/QnAPair.ts

@@ -1,4 +0,0 @@
-type Question = string;
-type Answer = string;
-
-export type QnaPair = [Question, Answer];

embedchain-js/embedchain/models/index.ts

@@ -1,21 +0,0 @@
-import { DataDict } from './DataDict';
-import { DataType } from './DataType';
-import { FormattedResult } from './FormattedResult';
-import { Input, LocalInput, RemoteInput } from './Input';
-import { LoaderResult } from './LoaderResult';
-import { Metadata } from './Metadata';
-import { Method } from './Method';
-import { QnaPair } from './QnAPair';
-
-export {
-  DataDict,
-  DataType,
-  FormattedResult,
-  Input,
-  LoaderResult,
-  LocalInput,
-  Metadata,
-  Method,
-  QnaPair,
-  RemoteInput,
-};

embedchain-js/embedchain/utils.ts

@@ -1,26 +0,0 @@
-/**
- * This function takes in a string and performs a series of text cleaning operations.
- * @param {str} text: The text to be cleaned. This is expected to be a string.
- * @returns {str}: The cleaned text after all the cleaning operations have been performed.
- */
-export function cleanString(text: string): string {
-  // Replacement of newline characters:
-  let cleanedText = text.replace(/\n/g, ' ');
-
-  // Stripping and reducing multiple spaces to single:
-  cleanedText = cleanedText.trim().replace(/\s+/g, ' ');
-
-  // Removing backslashes:
-  cleanedText = cleanedText.replace(/\\/g, '');
-
-  // Replacing hash characters:
-  cleanedText = cleanedText.replace(/#/g, ' ');
-
-  // Eliminating consecutive non-alphanumeric characters:
-  // This regex identifies consecutive non-alphanumeric characters (i.e., not a word character [a-zA-Z0-9_] and not a whitespace) in the string
-  // and replaces each group of such characters with a single occurrence of that character.
-  // For example, "!!! hello !!!" would become "! hello !".
-  cleanedText = cleanedText.replace(/([^\w\s])\1*/g, '$1');
-
-  return cleanedText;
-}

embedchain-js/embedchain/vectordb/BaseVectorDb.ts

@@ -1,14 +0,0 @@
-class BaseVectorDB {
-  initDb: Promise<void>;
-
-  constructor() {
-    this.initDb = this.getClientAndCollection();
-  }
-
-  // eslint-disable-next-line class-methods-use-this
-  protected async getClientAndCollection(): Promise<void> {
-    throw new Error('getClientAndCollection() method is not implemented');
-  }
-}
-
-export { BaseVectorDB };

embedchain-js/embedchain/vectordb/ChromaDb.ts

@@ -1,38 +0,0 @@
-import type { Collection } from 'chromadb';
-import { ChromaClient, OpenAIEmbeddingFunction } from 'chromadb';
-
-import { BaseVectorDB } from './BaseVectorDb';
-
-const embedder = new OpenAIEmbeddingFunction({
-  openai_api_key: process.env.OPENAI_API_KEY ?? '',
-});
-
-class ChromaDB extends BaseVectorDB {
-  client: ChromaClient | undefined;
-
-  collection: Collection | null = null;
-
-  // eslint-disable-next-line @typescript-eslint/no-useless-constructor
-  constructor() {
-    super();
-  }
-
-  protected async getClientAndCollection(): Promise<void> {
-    this.client = new ChromaClient({ path: 'http://localhost:8000' });
-    try {
-      this.collection = await this.client.getCollection({
-        name: 'embedchain_store',
-        embeddingFunction: embedder,
-      });
-    } catch (err) {
-      if (!this.collection) {
-        this.collection = await this.client.createCollection({
-          name: 'embedchain_store',
-          embeddingFunction: embedder,
-        });
-      }
-    }
-  }
-}
-
-export { ChromaDB };

embedchain-js/embedchain/vectordb/index.ts

@@ -1,3 +0,0 @@
-import { ChromaDB } from './ChromaDb';
-
-export { ChromaDB };

embedchain-js/index.js

@@ -1,9 +0,0 @@
-const { EmbedChainApp } = require("./embedchain/embedchain");
-
-async function App() {
-  const app = new EmbedChainApp();
-  await app.init_app;
-  return app;
-}
-
-module.exports = { App };

embedchain-js/jest.config.js

@@ -1,5 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  testPathIgnorePatterns: ['.d.ts'],
-};

embedchain-js/lint-staged.config.js

@@ -1,5 +0,0 @@
-module.exports = {
-  '*.{js,ts}': ['eslint --fix', 'eslint'],
-  '**/*.ts?(x)': () => 'npm run check-types',
-  '*.json': ['prettier --write'],
-};

embedchain-js/package.json

@@ -1,53 +0,0 @@
-{
-  "name": "embedchain",
-  "version": "0.0.8",
-  "description": "embedchain is a framework to easily create LLM powered bots over any dataset",
-  "main": "dist/index.js",
-  "types": "types/index.d.ts",
-  "files": [
-    "dist",
-    "types"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json --listFiles",
-    "prepare": "husky install",
-    "test": "jest",
-    "check-types": "tsc --noEmit --pretty"
-  },
-  "author": "Taranjeet Singh",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "axios": "^1.4.0",
-    "chromadb": "^1.5.6",
-    "jsdom": "^22.1.0",
-    "langchain": "^0.0.136",
-    "openai": "^4.3.1",
-    "pdfjs-dist": "^3.8.162",
-    "uuid": "^9.0.0"
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^17.1.2",
-    "@commitlint/config-conventional": "^17.1.0",
-    "@commitlint/cz-commitlint": "^17.1.2",
-    "@types/jest": "^29.5.1",
-    "@types/jsdom": "^21.1.1",
-    "@typescript-eslint/eslint-plugin": "^5.41.0",
-    "@typescript-eslint/parser": "^5.41.0",
-    "eslint": "^8.34.0",
-    "eslint-config-airbnb-base": "^15.0.0",
-    "eslint-config-airbnb-typescript": "^17.0.0",
-    "eslint-config-prettier": "^8.5.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-simple-import-sort": "^8.0.0",
-    "eslint-plugin-testing-library": "^5.9.1",
-    "eslint-plugin-unused-imports": "^2.0.0",
-    "husky": "^8.0.1",
-    "jest": "^29.5.0",
-    "lint-staged": "^13.0.3",
-    "prettier": "^2.7.1",
-    "ts-jest": "^29.1.0",
-    "ts-loader": "^9.4.2",
-    "typescript": "^5.2.2"
-  }
-}

embedchain-js/tsconfig.build.json

@@ -1,4 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "exclude": ["embedchain/__tests__"]
-}

embedchain-js/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es6",
-    "module": "CommonJS",
-    "strict": true,
-    "outDir": "dist",
-    "rootDir": "embedchain",
-    "sourceMap": true,
-    "declaration": true,
-    "declarationDir": "types",
-    "esModuleInterop": true
-  },
-  "include": ["embedchain/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}

embedchain/CONTRIBUTING.md

@@ -24,9 +24,7 @@ We use `poetry` as our package manager. You can install poetry by following the
 Please DO NOT use pip or conda to install the dependencies. Instead, use poetry:
 
 ```bash
-poetry install --all-extras
-or
-poetry install --with dev
+make install_all
 
 #activate
 
@@ -67,6 +65,10 @@ We use `pytest` to test our code. You can run the tests by running the following
 poetry run pytest
 ```
 
+
+Several packages have been removed from Poetry to make the package lighter. Therefore, it is recommended to run `make install_all` to install the remaining packages and ensure all tests pass.
+
+
 Make sure that all tests pass before submitting a pull request.
 
 ## 🚀 Release Process

embedchain/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright [2023] [Taranjeet Singh]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

embedchain/Makefile

@@ -0,0 +1,56 @@
+# Variables
+PYTHON := python3
+PIP := $(PYTHON) -m pip
+PROJECT_NAME := embedchain
+
+# Targets
+.PHONY: install format lint clean test ci_lint ci_test coverage
+
+install:
+	poetry install
+
+# TODO: use a more efficient way to install these packages
+install_all:
+	poetry install --all-extras
+	poetry run pip install pinecone-text pinecone-client langchain-anthropic "unstructured[local-inference, all-docs]" ollama langchain_together==0.1.3 \
+		langchain_cohere==0.1.5 deepgram-sdk==3.2.7 langchain-huggingface psutil clarifai==10.0.1 flask==2.3.3 twilio==8.5.0 fastapi-poe==0.0.16 discord==2.3.2 \
+	 	slack-sdk==3.21.3 huggingface_hub==0.23.0 gitpython==3.1.38 yt_dlp==2023.11.14 PyGithub==1.59.1 feedparser==6.0.10 newspaper3k==0.2.8 listparser==0.19 \
+	 	modal==0.56.4329 dropbox==11.36.2 boto3==1.34.20 youtube-transcript-api==0.6.1 pytube==15.0.0 beautifulsoup4==4.12.3
+
+install_es:
+	poetry install --extras elasticsearch
+
+install_opensearch:
+	poetry install --extras opensearch
+
+install_milvus:
+	poetry install --extras milvus
+
+shell:
+	poetry shell
+
+py_shell:
+	poetry run python
+
+format:
+	$(PYTHON) -m black .
+	$(PYTHON) -m isort .
+
+clean:
+	rm -rf dist build *.egg-info
+
+lint:
+	poetry run ruff .
+
+build:
+	poetry build
+
+publish:
+	poetry publish
+
+# for example: make test file=tests/test_factory.py
+test:
+	poetry run pytest $(file)
+
+coverage:
+	poetry run pytest --cov=$(PROJECT_NAME) --cov-report=xml

embedchain/README.md

@@ -0,0 +1,125 @@
+<p align="center">
+  <img src="docs/logo/dark.svg" width="400px" alt="Embedchain Logo">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/embedchain/">
+    <img src="https://img.shields.io/pypi/v/embedchain" alt="PyPI">
+  </a>
+  <a href="https://pepy.tech/project/embedchain">
+    <img src="https://static.pepy.tech/badge/embedchain" alt="Downloads">
+  </a>
+  <a href="https://embedchain.ai/slack">
+    <img src="https://img.shields.io/badge/slack-embedchain-brightgreen.svg?logo=slack" alt="Slack">
+  </a>
+  <a href="https://embedchain.ai/discord">
+    <img src="https://dcbadge.vercel.app/api/server/6PzXDgEjG5?style=flat" alt="Discord">
+  </a>
+  <a href="https://twitter.com/embedchain">
+    <img src="https://img.shields.io/twitter/follow/embedchain" alt="Twitter">
+  </a>
+  <a href="https://colab.research.google.com/drive/138lMWhENGeEu7Q1-6lNbNTHGLZXBBz_B?usp=sharing">
+    <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab">
+  </a>
+  <a href="https://codecov.io/gh/embedchain/embedchain">
+    <img src="https://codecov.io/gh/embedchain/embedchain/graph/badge.svg?token=EMRRHZXW1Q" alt="codecov">
+  </a>
+</p>
+
+<hr />
+
+## What is Embedchain?
+
+Embedchain is an Open Source Framework for personalizing LLM responses. It makes it easy to create and deploy personalized AI apps. At its core, Embedchain follows the design principle of being *"Conventional but Configurable"* to serve both software engineers and machine learning engineers.
+
+Embedchain streamlines the creation of personalized LLM applications, offering a seamless process for managing various types of unstructured data. It efficiently segments data into manageable chunks, generates relevant embeddings, and stores them in a vector database for optimized retrieval. With a suite of diverse APIs, it enables users to extract contextual information, find precise answers, or engage in interactive chat conversations, all tailored to their own data.
+
+## 🔧 Quick install
+
+### Python API
+
+```bash
+pip install embedchain
+```
+
+## ✨ Live demo
+
+Checkout the [Chat with PDF](https://embedchain.ai/demo/chat-pdf) live demo we created using Embedchain. You can find the source code [here](https://github.com/embedchain/embedchain/tree/main/examples/chat-pdf).
+
+## 🔍 Usage
+
+<!-- Demo GIF or Image -->
+<p align="center">
+  <img src="docs/images/cover.gif" width="900px" alt="Embedchain Demo">
+</p>
+
+For example, you can create an Elon Musk bot using the following code:
+
+```python
+import os
+from embedchain import App
+
+# Create a bot instance
+os.environ["OPENAI_API_KEY"] = "<YOUR_API_KEY>"
+app = App()
+
+# Embed online resources
+app.add("https://en.wikipedia.org/wiki/Elon_Musk")
+app.add("https://www.forbes.com/profile/elon-musk")
+
+# Query the app
+app.query("How many companies does Elon Musk run and name those?")
+# Answer: Elon Musk currently runs several companies. As of my knowledge, he is the CEO and lead designer of SpaceX, the CEO and product architect of Tesla, Inc., the CEO and founder of Neuralink, and the CEO and founder of The Boring Company. However, please note that this information may change over time, so it's always good to verify the latest updates.
+```
+
+You can also try it in your browser with Google Colab:
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/17ON1LPonnXAtLaZEebnOktstB_1cJJmh?usp=sharing)
+
+## 📖 Documentation
+Comprehensive guides and API documentation are available to help you get the most out of Embedchain:
+
+- [Introduction](https://docs.embedchain.ai/get-started/introduction#what-is-embedchain)
+- [Getting Started](https://docs.embedchain.ai/get-started/quickstart)
+- [Examples](https://docs.embedchain.ai/examples)
+- [Supported data types](https://docs.embedchain.ai/components/data-sources/overview)
+
+## 🔗 Join the Community
+
+* Connect with fellow developers by joining our [Slack Community](https://embedchain.ai/slack) or [Discord Community](https://embedchain.ai/discord).
+
+* Dive into [GitHub Discussions](https://github.com/embedchain/embedchain/discussions), ask questions, or share your experiences.
+
+## 🤝 Schedule a 1-on-1 Session
+
+Book a [1-on-1 Session](https://cal.com/taranjeetio/ec) with the founders, to discuss any issues, provide feedback, or explore how we can improve Embedchain for you.
+
+## 🌐 Contributing
+
+Contributions are welcome! Please check out the issues on the repository, and feel free to open a pull request.
+For more information, please see the [contributing guidelines](CONTRIBUTING.md).
+
+For more reference, please go through [Development Guide](https://docs.embedchain.ai/contribution/dev) and [Documentation Guide](https://docs.embedchain.ai/contribution/docs).
+
+<a href="https://github.com/embedchain/embedchain/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=embedchain/embedchain" />
+</a>
+
+## Anonymous Telemetry
+
+We collect anonymous usage metrics to enhance our package's quality and user experience. This includes data like feature usage frequency and system info, but never personal details. The data helps us prioritize improvements and ensure compatibility. If you wish to opt-out, set the environment variable `EC_TELEMETRY=false`. We prioritize data security and don't share this data externally.
+
+## Citation
+
+If you utilize this repository, please consider citing it with:
+
+```
+@misc{embedchain,
+  author = {Taranjeet Singh, Deshraj Yadav},
+  title = {Embedchain: The Open Source RAG Framework},
+  year = {2023},
+  publisher = {GitHub},
+  journal = {GitHub repository},
+  howpublished = {\url{https://github.com/embedchain/embedchain}},
+}
+```