lint remove trailing space

* Add spreadsheet extensions

* linting

* fix tests

---------

Co-authored-by: Logan Markewich <logan.markewich@live.com>

.github/workflows/build_package.yml

@@ -0,0 +1,48 @@
+name: Build Package
+
+# Build package on its own without additional pip install
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+env:
+  POETRY_VERSION: "1.6.1"
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # You can use PyPy versions in python-version.
+      # For example, pypy-2.7 and pypy-3.8
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.9"]
+    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: ${{ env.POETRY_VERSION }}
+      - name: Install deps
+        shell: bash
+        run: poetry install
+      - name: Ensure lock works
+        shell: bash
+        run: poetry lock
+      - name: Build
+        shell: bash
+        run: poetry build
+      - name: Test installing built package
+        shell: bash
+        run: python -m pip install .
+      - name: Test import
+        shell: bash
+        working-directory: ${{ vars.RUNNER_TEMP }}
+        run: python -c "import llama_parse"

.github/workflows/codeql.yml

@@ -0,0 +1,81 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: ["main"]
+  schedule:
+    - cron: "30 16 * * 4"
+
+jobs:
+  analyze:
+    name: Analyze
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners
+    # Consider using larger runners for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ["python"]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby', 'swift' ]
+        # Use only 'java' to analyze code written in Java, Kotlin or both
+        # Use only 'javascript' to analyze code written in JavaScript, TypeScript or both
+        # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: ${{ matrix.language }}
+          # If you wish to specify custom queries, you can do so here or in a config file.
+          # By default, queries listed here will override any specified in a config file.
+          # Prefix the list here with "+" to use these queries and those in the config file.
+
+          # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+          # queries: security-extended,security-and-quality
+
+      # Autobuild attempts to build any compiled languages (C/C++, C#, Go, Java, or Swift).
+      # If this step fails, then you should remove it and run the build manually (see below)
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v2
+
+      # ℹ️ Command-line programs to run using the OS shell.
+      # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+
+      #   If the Autobuild fails above, remove it and uncomment the following three lines.
+      #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+
+      # - run: |
+      #     echo "Run, Build Application using script"
+      #     ./location_of_script_within_repo/buildscript.sh
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2
+        with:
+          category: "/language:${{matrix.language}}"

.github/workflows/lint.yml

@@ -0,0 +1,37 @@
+name: Linting
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+env:
+  POETRY_VERSION: "1.6.1"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      # You can use PyPy versions in python-version.
+      # For example, pypy-2.7 and pypy-3.8
+      matrix:
+        python-version: ["3.9"]
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: ${{ github.event_name == 'pull_request' && 2 || 0 }}
+      - 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: ${{ env.POETRY_VERSION }}
+      - name: Install pre-commit
+        shell: bash
+        run: poetry run pip install pre-commit
+      - name: Run linter
+        shell: bash
+        run: poetry run make lint

.github/workflows/publish_release.yml

@@ -0,0 +1,64 @@
+name: Publish llama-parse to PyPI / GitHub
+
+on:
+  push:
+    tags:
+      - "v*"
+
+  workflow_dispatch:
+
+env:
+  POETRY_VERSION: "1.6.1"
+  PYTHON_VERSION: "3.9"
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    if: github.repository == 'run-llama/llama_parse'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up python ${{ env.PYTHON_VERSION }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: ${{ env.POETRY_VERSION }}
+      - name: Install deps
+        shell: bash
+        run: pip install -e .
+      - name: Build and publish to pypi
+        uses: JRubics/poetry-publish@v1.17
+        with:
+          pypi_token: ${{ secrets.LLAMA_PARSE_PYPI_TOKEN }}
+          ignore_dev_requirements: "yes"
+
+      - name: Create GitHub Release
+        id: create_release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # This token is provided by Actions, you do not need to create your own token
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: ${{ github.ref }}
+          draft: false
+          prerelease: false
+
+      - name: Get Asset name
+        run: |
+          export PKG=$(ls dist/ | grep tar)
+          set -- $PKG
+          echo "name=$1" >> $GITHUB_ENV
+      - name: Upload Release Asset (sdist) to GitHub
+        id: upload-release-asset
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: dist/${{ env.name }}
+          asset_name: ${{ env.name }}
+          asset_content_type: application/zip

.github/workflows/unit_test.yml

@@ -0,0 +1,40 @@
+name: Unit Testing
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+env:
+  POETRY_VERSION: "1.6.1"
+  LLAMA_CLOUD_API_KEY: ${{ secrets.LLAMA_CLOUD_API_KEY }}
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      # You can use PyPy versions in python-version.
+      # For example, pypy-2.7 and pypy-3.8
+      matrix:
+        python-version: ["3.8", "3.10", "3.11"]
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - 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: ${{ env.POETRY_VERSION }}
+      - name: Install deps
+        shell: bash
+        run: poetry install --with dev
+      - name: Run testing
+        env:
+          CI: true
+        shell: bash
+        run: poetry run pytest tests

.gitignore

@@ -1,3 +1,4 @@
 .git
 __pycache__/
-*.pyc
+*.pyc
+.DS_Store

.pre-commit-config.yaml

@@ -0,0 +1,86 @@
+---
+default_language_version:
+  python: python3
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: check-byte-order-marker
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: check-toml
+      - id: check-yaml
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.1.5
+
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+        exclude: ".*poetry.lock"
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: 23.10.1
+    hooks:
+      - id: black-jupyter
+        name: black-src
+        alias: black
+        exclude: ".*poetry.lock"
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.0.1
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          [
+            "types-requests",
+            "types-Deprecated",
+            "types-redis",
+            "types-setuptools",
+            "types-PyYAML",
+            "types-protobuf==4.24.0.4",
+          ]
+        args:
+          [
+            --disallow-untyped-defs,
+            --ignore-missing-imports,
+            --python-version=3.8,
+          ]
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: 1.16.0
+    hooks:
+      - id: blacken-docs
+        name: black-docs-text
+        alias: black
+        types_or: [rst, markdown, tex]
+        additional_dependencies: [black==23.10.1]
+        # Using PEP 8's line length in docs prevents excess left/right scrolling
+        args: [--line-length=79]
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.0.3
+    hooks:
+      - id: prettier
+        exclude: poetry.lock
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.2.6
+    hooks:
+      - id: codespell
+        additional_dependencies: [tomli]
+        exclude: ^(poetry.lock|examples)
+        args:
+          [
+            "--ignore-words-list",
+            "astroid,gallary,momento,narl,ot,rouge,nin,gere,te,inh,vor",
+          ]
+  - repo: https://github.com/srstevenson/nb-clean
+    rev: 3.1.0
+    hooks:
+      - id: nb-clean
+        args: [--preserve-cell-outputs, --remove-empty-cells]
+  - repo: https://github.com/pappasam/toml-sort
+    rev: v0.23.1
+    hooks:
+      - id: toml-sort-fix
+        exclude: ".*poetry.lock"

Makefile

@@ -0,0 +1,14 @@
+GIT_ROOT ?= $(shell git rev-parse --show-toplevel)
+
+help:	## Show all Makefile targets.
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[33m%-30s\033[0m %s\n", $$1, $$2}'
+
+format:	## Run code autoformatters (black).
+	pre-commit install
+	git ls-files | xargs pre-commit run black --files
+
+lint:	## Run linters: pre-commit (black, ruff, codespell) and mypy
+	pre-commit install && git ls-files | xargs pre-commit run --show-diff-on-failure --files
+
+test:	## Run tests via pytest
+	pytest tests

README.md

@@ -1,25 +1,35 @@
-# LlamaParse (Preview)
+# LlamaParse
 
 LlamaParse is an API created by LlamaIndex to efficiently parse and represent files for efficient retrieval and context augmentation using LlamaIndex frameworks.
 
 LlamaParse directly integrates with [LlamaIndex](https://github.com/run-llama/llama_index).
 
-Currently available in preview mode for **free**. Try it out today!
+Free plan is up to 1000 pages a day. Paid plan is free 7k pages per week + 0.3c per additional page.
 
-**NOTE:** Currently, only PDF files are supported.
+Read below for some quickstart information, or see the [full documentation](https://docs.cloud.llamaindex.ai/).
 
 ## Getting Started
 
-First, login and get an api-key from `https://cloud.llamaindex.ai`.
+First, login and get an api-key from [**https://cloud.llamaindex.ai ↗**](https://cloud.llamaindex.ai).
 
-Install the package:
+Then, make sure you have the latest LlamaIndex version installed.
+
+**NOTE:** If you are upgrading from v0.9.X, we recommend following our [migration guide](https://pretty-sodium-5e0.notion.site/v0-10-0-Migration-Guide-6ede431dcb8841b09ea171e7f133bd77), as well as uninstalling your previous version first.
+
+```
+pip uninstall llama-index  # run this if upgrading from v0.9.x or older
+pip install -U llama-index --upgrade --no-cache-dir --force-reinstall
+```
+
+Lastly, install the package:
 
 `pip install llama-parse`
 
-Then, you can run the following to parse your first PDF file:
+Now you can run the following to parse your first PDF file:
 
 ```python
 import nest_asyncio
+
 nest_asyncio.apply()
 
 from llama_parse import LlamaParse
@@ -27,14 +37,22 @@ from llama_parse import LlamaParse
 parser = LlamaParse(
     api_key="llx-...",  # can also be set in your env as LLAMA_CLOUD_API_KEY
     result_type="markdown",  # "markdown" and "text" are available
-    verbose=True
+    num_workers=4,  # if multiple files passed, split in `num_workers` API calls
+    verbose=True,
+    language="en",  # Optionally you can define a language, default=en
 )
 
 # sync
 documents = parser.load_data("./my_file.pdf")
 
+# sync batch
+documents = parser.load_data(["./my_file1.pdf", "./my_file2.pdf"])
+
 # async
 documents = await parser.aload_data("./my_file.pdf")
+
+# async batch
+documents = await parser.aload_data(["./my_file1.pdf", "./my_file2.pdf"])
 ```
 
 ## Using with `SimpleDirectoryReader`
@@ -43,19 +61,22 @@ You can also integrate the parser as the default PDF loader in `SimpleDirectoryR
 
 ```python
 import nest_asyncio
+
 nest_asyncio.apply()
 
 from llama_parse import LlamaParse
-from llama_index import SimpleDirectoryReader
+from llama_index.core import SimpleDirectoryReader
 
 parser = LlamaParse(
     api_key="llx-...",  # can also be set in your env as LLAMA_CLOUD_API_KEY
     result_type="markdown",  # "markdown" and "text" are available
-    verbose=True
+    verbose=True,
 )
 
 file_extractor = {".pdf": parser}
-documents = SimpleDirectoryReader("./data", file_extractor=file_extractor).load_data()
+documents = SimpleDirectoryReader(
+    "./data", file_extractor=file_extractor
+).load_data()
 ```
 
 Full documentation for `SimpleDirectoryReader` can be found on the [LlamaIndex Documentation](https://docs.llamaindex.ai/en/stable/module_guides/loading/simpledirectoryreader.html).
@@ -68,6 +89,10 @@ Several end-to-end indexing examples can be found in the examples folder
 - [Advanced RAG Example](examples/demo_advanced.ipynb)
 - [Raw API Usage](examples/demo_api.ipynb)
 
+## Documentation
+
+[https://docs.cloud.llamaindex.ai/](https://docs.cloud.llamaindex.ai/)
+
 ## Terms of Service
 
 See the [Terms of Service Here](./TOS.pdf).

examples/agents/demo_simple_openai_agent.ipynb

@@ -0,0 +1,302 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# LlamaParse Agent\n",
+    "\n",
+    "This demo walks through using an OpenAI Agent with [LlamaParse](https://cloud.llamaindex.ai)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Setup"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install llama-parse llama-index llama-index-postprocessor-sbert-rerank"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\"\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"sk-...\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import Settings\n",
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.llms.openai import OpenAI\n",
+    "\n",
+    "Settings.embed_model = OpenAIEmbedding(model=\"text-embedding-3-small\")\n",
+    "Settings.llm = OpenAI(model=\"gpt-3.5-turbo\", temperature=0.2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Parsing \n",
+    "\n",
+    "For parsing, lets use a [recent paper](https://huggingface.co/papers/2403.09611) on Multi-Modal pretraining"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget https://arxiv.org/pdf/2403.09611.pdf -O paper.pdf"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below, we can tell the parser to skip content we don't want. In this case, the references section will just add noise to a RAG system."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "parser = LlamaParse(\n",
+    "    result_type=\"markdown\",\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 81251f39-01be-434e-99e8-1c1b83b82098\n"
+     ]
+    }
+   ],
+   "source": [
+    "documents = await parser.aload_data(\"paper.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Embeddings have been explicitly disabled. Using MockEmbedding.\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "41it [00:00, 26765.21it/s]\n",
+      "100%|██████████| 41/41 [00:13<00:00,  2.98it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "from llama_index.core.node_parser import (\n",
+    "    MarkdownElementNodeParser,\n",
+    "    SentenceSplitter,\n",
+    ")\n",
+    "\n",
+    "# explicitly extract tables with the MarkdownElementNodeParser\n",
+    "node_parser = MarkdownElementNodeParser(num_workers=8)\n",
+    "nodes = node_parser.get_nodes_from_documents(documents)\n",
+    "nodes, objects = node_parser.get_nodes_and_objects(nodes)\n",
+    "\n",
+    "# Chain splitters to ensure chunk size requirements are met\n",
+    "nodes = SentenceSplitter(chunk_size=512, chunk_overlap=20).get_nodes_from_documents(\n",
+    "    nodes\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Chat over the paper, lets find out what it is about!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import VectorStoreIndex, SummaryIndex\n",
+    "\n",
+    "vector_index = VectorStoreIndex(nodes=nodes)\n",
+    "summary_index = SummaryIndex(nodes=nodes)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.agent.openai import OpenAIAgent\n",
+    "from llama_index.core.tools import QueryEngineTool, ToolMetadata\n",
+    "from llama_index.postprocessor.colbert_rerank import ColbertRerank\n",
+    "\n",
+    "tools = [\n",
+    "    QueryEngineTool(\n",
+    "        vector_index.as_query_engine(\n",
+    "            similarity_top_k=8, node_postprocessors=[ColbertRerank(top_n=3)]\n",
+    "        ),\n",
+    "        metadata=ToolMetadata(\n",
+    "            name=\"search\",\n",
+    "            description=\"Search the document, pass the entire user message in the query\",\n",
+    "        ),\n",
+    "    ),\n",
+    "    QueryEngineTool(\n",
+    "        summary_index.as_query_engine(),\n",
+    "        metadata=ToolMetadata(\n",
+    "            name=\"summarize\",\n",
+    "            description=\"Summarize the document using the user message\",\n",
+    "        ),\n",
+    "    ),\n",
+    "]\n",
+    "\n",
+    "agent = OpenAIAgent.from_tools(tools=tools, verbose=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added user message to memory: What is the summary of the paper?\n",
+      "=== Calling Function ===\n",
+      "Calling function: summarize with args: {\"input\":\"summary\"}\n",
+      "Got output: The research focuses on developing Multimodal Large Language Models (MLLMs) by incorporating image-caption, interleaved image-text, and text-only data for pre-training. It highlights the importance of factors like the image encoder, resolution, and token count, while downplaying the design of the vision-language connector. With models scaling up to 30B parameters, the MM1 family demonstrates impressive performance in pre-training metrics and competitive outcomes on diverse multimodal benchmarks. It demonstrates abilities such as in-context learning and multi-image reasoning, aiming to provide valuable insights for creating MLLMs that benefit the research community.\n",
+      "========================\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# note -- this will take a while with local LLMs, its sending every node in the document to the LLM\n",
+    "resp = agent.chat(\"What is the summary of the paper?\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The summary of the paper highlights the development of Multimodal Large Language Models (MLLMs) by incorporating image-caption, interleaved image-text, and text-only data for pre-training. The research emphasizes factors like the image encoder, resolution, and token count, while de-emphasizing the design of the vision-language connector. The MM1 family of models, scaling up to 30B parameters, shows impressive performance in pre-training metrics and competitive outcomes on various multimodal benchmarks. These models demonstrate capabilities such as in-context learning and multi-image reasoning, aiming to provide valuable insights for creating MLLMs that benefit the research community.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(resp))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Added user message to memory: How do the authors evaluate their work?\n",
+      "=== Calling Function ===\n",
+      "Calling function: search with args: {\"input\":\"evaluation methods\"}\n",
+      "Got output: The evaluation methods involve synthesizing all benchmark results into a single meta-average number to simplify comparisons. This is achieved by normalizing the evaluation metrics with respect to a baseline configuration, standardizing the results for each task, adjusting every metric by dividing it by its respective baseline, and then averaging across all metrics.\n",
+      "========================\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "resp = agent.chat(\"How do the authors evaluate their work?\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The authors evaluate their work by synthesizing all benchmark results into a single meta-average number to simplify comparisons. They normalize the evaluation metrics with respect to a baseline configuration, standardize the results for each task, adjust every metric by dividing it by its respective baseline, and then average across all metrics for evaluation.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(resp))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama-parse-aNC435Vv-py3.10",
+   "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"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

examples/caltrain/caltrain_text_mode.ipynb

@@ -0,0 +1,529 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "c148b65e-e8a6-476e-86ba-bf6a73d479c7",
+   "metadata": {},
+   "source": [
+    "# RAG over the Caltrain Weekend Schedule \n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/caltrain/caltrain_text_mode.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "This example shows off LlamaParse parsing capabilities to build a functioning query pipeline over the Caltrain weekend schedule, a big timetable containing all trains northbound and southbound and their stops in various cities.\n",
+    "\n",
+    "Naive parsing solutions mess up in representing this tabular representation, leading to LLM hallucinations. In contrast, LlamaParse text-mode spatially lays out the table in a neat format, enabling more sophisticated LLMs like gpt-4-turbo to understand the spacing and reason over all the numbers.\n",
+    "\n",
+    "**NOTE**: LlamaParse markdown mode doesn't quite work yet - it's in development!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ef115dbe-b834-4639-828e-e2c11aef710b",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "Download the data."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e6ae2e38-30c9-4865-aa13-47780bc3848f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "335ce1d0-757a-4f09-846e-21c409768871",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget \"https://www.caltrain.com/media/31602/download?inline?inline\" -O caltrain_schedule_weekend.pdf"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "45fa9120-65bb-4772-9db7-53e7cecf9adc",
+   "metadata": {},
+   "source": [
+    "## Initialize LlamaParse\n",
+    "\n",
+    "Initialize LlamaParse in `text` mode which will represent complex documents incl. text, tables, and figures as nicely formatted text."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "54aa9579-84d4-49bc-ab54-5474e69c1188",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/Users/jerryliu/Programming/llama_parse/.venv/lib/python3.10/site-packages/tqdm/auto.py:21: TqdmWarning: IProgress not found. Please update jupyter and ipywidgets. See https://ipywidgets.readthedocs.io/en/stable/user_install.html\n",
+      "  from .autonotebook import tqdm as notebook_tqdm\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 5f73353a-1f4b-480d-9eea-58d1d22b75f6\n"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "docs = LlamaParse(result_type=\"text\").load_data(\"./caltrain_schedule_weekend.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "602756b2-9ea1-4519-a8e3-c773ec624205",
+   "metadata": {},
+   "source": [
+    "Take a look at the below text (and zoom out from the browser to really get the effect!). You'll see that the entire table is nicely laid out."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4928281a-591a-4653-b451-b2b8112a7101",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ZONE 2ZONE 3ZONE 4ZONE 4 ZONE 3ZONE 2ZONE 1ZONE 1\n",
+      "                                      Printer-Friendly Caltrain Schedule\n",
+      "              Northbound –                         WEEKEND SERVICE to SAN FRANCISCO                                                                                                                2XX Local\n",
+      "\n",
+      "\n",
+      "                  Train No.       221        225        229        233        237        241        245        249        253        257        261        265        269        273       *277       *281\n",
+      "                 Service Types      L2        L2          L2        L2         L2         L2         L2         L2         L2         L2         L2         L2         L2         L2         L2         L2\n",
+      "                      Tamien      7:12a      9:05a     10:05a     11:05a                1:05p                 3:05p                 5:05p                 7:05p                 9:05p                11:05p\n",
+      "           San Jose Diridon       7:19a      9:12a     10:12a     11:12a    12:12p      1:12p      2:12p      3:12p      4:12p      5:12p      6:12p      7:12p      8:12p      9:12p     10:19p     11:12p\n",
+      "                 Santa Clara      7:25a      9:18a     10:18a     11:18a    12:18p      1:18p      2:18p      3:18p      4:18p      5:18p      6:18p      7:18p      8:18p      9:18p     10:25p     11:18p\n",
+      "                   Lawrence       7:31a      9:24a     10:24a     11:24a    12:24p      1:24p      2:24p      3:24p      4:24p      5:24p      6:24p      7:24p      8:24p      9:24p     10:31p     11:24p\n",
+      "                  Sunnyvale       7:35a      9:28a     10:28a     11:28a    12:28p      1:28p      2:28p      3:28p      4:28p      5:28p      6:28p      7:28p      8:28p      9:28p     10:35p     11:28p\n",
+      "            Mountain View         7:40a      9:34a     10:34a     11:34a    12:34p      1:34p      2:34p      3:34p      4:34p      5:34p      6:34p      7:34p      8:34p      9:34p     10:40p     11:34p\n",
+      "                San Antonio       7:43a      9:37a     10:37a     11:37a    12:37p      1:37p      2:37p      3:37p      4:37p      5:37p      6:37p      7:37p      8:37p      9:37p     10:44p     11:37p\n",
+      "              California Ave      7:48a      9:42a     10:42a     11:42a    12:42p      1:42p      2:42p      3:42p      4:42p      5:42p      6:42p      7:42p      8:42p      9:42p     10:48p     11:42p\n",
+      "                    Palo Alto     7:52a      9:46a     10:46a     11:46a    12:46p      1:46p      2:46p      3:46p      4:46p      5:46p      6:46p      7:46p      8:46p      9:46p     10:53p     11:46p\n",
+      "                 Menlo Park       7:55a      9:50a     10:50a     11:50a    12:50p      1:50p      2:50p      3:50p      4:50p      5:50p      6:50p      7:50p      8:50p      9:50p     10:56p     11:50p\n",
+      "              Redwood City        8:01a      9:56a     10:56a     11:56a    12:56p      1:56p      2:56p      3:56p      4:56p      5:56p      6:56p      7:56p      8:56p      9:56p     11:02p     11:56p\n",
+      "                  San Carlos      8:05a     10:01a     11:01a     12:01p     1:01p      2:01p      3:01p      4:01p      5:01p      6:01p      7:01p      8:01p      9:01p     10:01p     11:07p     12:01a\n",
+      "                    Belmont       8:09a     10:04a     11:04a     12:04p     1:04p      2:04p      3:04p      4:04p      5:04p      6:04p      7:04p      8:04p      9:04p     10:04p     11:10p     12:04a\n",
+      "                    Hillsdale     8:12a     10:08a     11:08a     12:08p     1:08p      2:08p      3:08p      4:08p      5:08p      6:08p      7:08p      8:08p      9:08p     10:08p     11:14p     12:08a\n",
+      "              Hayward Park        8:15a     10:11a     11:11a     12:11p     1:11p      2:11p      3:11p      4:11p      5:11p      6:11p      7:11p      8:11p      9:11p     10:11p     11:17p     12:11a\n",
+      "                  San Mateo       8:19a     10:15a     11:15a     12:15p     1:15p      2:15p      3:15p      4:15p      5:15p      6:15p      7:15p      8:15p      9:15p     10:15p     11:21p     12:15a\n",
+      "                 Burlingame       8:22a     10:19a     11:19a     12:19p     1:19p      2:19p      3:19p      4:19p      5:19p      6:19p      7:19p      8:19p      9:19p     10:19p     11:25p     12:19a\n",
+      "                  Broadway        8:25a     10:22a     11:22a     12:22p     1:22p      2:22p      3:22p      4:22p      5:22p      6:22p      7:22p      8:22p      9:22p     10:22p     11:28p     12:22a\n",
+      "                    Millbrae      8:29a     10:26a     11:26a     12:26p     1:26p      2:26p      3:26p      4:26p      5:26p      6:26p      7:26p      8:26p      9:26p     10:26p     11:32p     12:26a\n",
+      "                  San Bruno       8:34a     10:30a     11:30a     12:30p     1:30p      2:30p      3:30p      4:30p      5:30p      6:30p      7:30p      8:30p      9:30p     10:30p     11:37p     12:30a\n",
+      "            S. San Francisco      8:38a     10:34a     11:34a     12:34p     1:34p      2:34p      3:34p      4:34p      5:34p      6:34p      7:34p      8:34p      9:34p     10:34p     11:41p     12:34a\n",
+      "                   Bayshore       8:44a     10:41a     11:41a     12:41p     1:41p      2:41p      3:41p      4:41p      5:41p      6:41p      7:41p      8:41p      9:41p     10:41p     11:47p     12:41a\n",
+      "                  22 ndStreet     8:50a     10:46a     11:46a     12:46p     1:46p      2:46p      3:46p      4:46p      5:46p      6:46p      7:46p      8:46p      9:46p     10:46p     11:53p     12:46a\n",
+      "                San Francisco     8:56a     10:52a     11:53a     12:53p     1:52p      2:52p      3:52p      4:52p      5:52p      6:52p      7:52p      8:52p      9:52p     10:52p     11:59p     12:52a\n",
+      "                                      *On SAP Center event days, Train 277 or Train 281departure from San Jose Diridon station may be delayed and will depart no later than 10:30p or 11:30p respectively.\n",
+      "\n",
+      "\n",
+      "              Southbound                        –   WEEKEND               SERVICE to SAN JOSE                                                                                                      2XX Local\n",
+      "                  Train No.       224        228        232        236        240        244        248        252        256        260        264        268        272        276        280        284\n",
+      "                 Service Types      L2        L2          L2        L2          L2        L2         L2         L2         L2         L2         L2         L2         L2         L2         L2         L2\n",
+      "               San Francisco      8:28a      9:58a     10:58a     11:58a     12:58p     1:58p      2:58p      3:58p      4:58p      5:58p      6:58p      7:58p      8:58p      9:58p      10:58p     12:05a\n",
+      "                  22 ndStreet     8:33a     10:03a     11:03a     12:03p     1:03p      2:03p      3:03p      4:03p      5:03p      6:03p      7:03p      8:03p      9:03p     10:03p      11:03p     12:10a\n",
+      "                   Bayshore       8:38a     10:08a     11:08a     12:08p     1:08p      2:08p      3:08p      4:08p      5:08p      6:08p      7:08p      8:08p      9:08p     10:08p      11:08p     12:15a\n",
+      "            S. San Francisco      8:45a     10:15a     11:15a     12:15p     1:15p      2:15p      3:15p      4:15p      5:15p      6:15p      7:15p      8:15p      9:15p     10:15p      11:15p     12:22a\n",
+      "                  San Bruno       8:49a     10:19a     11:19a     12:19p     1:19p      2:19p      3:19p      4:19p      5:19p      6:19p      7:19p      8:19p      9:19p     10:19p      11:19p     12:26a\n",
+      "                    Millbrae      8:53a     10:24a     11:24a     12:24p     1:24p      2:24p      3:24p      4:24p      5:24p      6:24p      7:24p      8:24p      9:24p     10:24p      11:24p     12:31a\n",
+      "                  Broadway        8:57a     10:27a     11:27a     12:27p     1:27p      2:27p      3:27p      4:27p      5:27p      6:27p      7:27p      8:27p      9:27p     10:27p      11:27p     12:35a\n",
+      "                 Burlingame       9:00a     10:31a     11:31a     12:31p     1:31p      2:31p      3:31p      4:31p      5:31p      6:31p      7:31p      8:31p      9:31p     10:31p      11:31p     12:38a\n",
+      "                  San Mateo       9:04a     10:34a     11:34a     12:34p     1:34p      2:34p      3:34p      4:34p      5:34p      6:34p      7:34p      8:34p      9:34p     10:34p      11:34p     12:41a\n",
+      "              Hayward Park        9:07a     10:37a     11:37a     12:37p     1:37p      2:37p      3:37p      4:37p      5:37p      6:37p      7:37p      8:37p      9:37p     10:37p      11:37p     12:45a\n",
+      "                    Hillsdale     9:10a     10:41a     11:41a     12:41p     1:41p      2:41p      3:41p      4:41p      5:41p      6:41p      7:41p      8:41p      9:41p     10:41p      11:41p     12:48a\n",
+      "                    Belmont       9:14a     10:44a     11:44a     12:44p     1:44p      2:44p      3:44p      4:44p      5:44p      6:44p      7:44p      8:44p      9:44p     10:44p      11:44p     12:52a\n",
+      "                  San Carlos      9:17a     10:48a     11:48a     12:48p     1:48p      2:48p      3:48p      4:48p      5:48p      6:48p      7:48p      8:48p      9:48p     10:48p      11:48p     12:55a\n",
+      "              Redwood City        9:21a     10:52a     11:52a     12:52p     1:52p      2:52p      3:52p      4:52p      5:52p      6:52p      7:52p      8:52p      9:52p     10:52p      11:52p     12:59a\n",
+      "                 Menlo Park       9:28a     10:58a     11:58a     12:58p     1:58p      2:58p      3:58p      4:58p      5:58p      6:58p      7:58p      8:58p      9:58p     10:58p      11:58p     1:05a\n",
+      "                    Palo Alto     9:32a     11:02a     12:02p     1:02p      2:02p      3:02p      4:02p      5:02p      6:02p      7:02p      8:02p      9:02p     10:02p     11:02p      12:02a     1:09a\n",
+      "         California Avenue        9:36a     11:06a     12:06p     1:06p      2:06p      3:06p      4:06p      5:06p      6:06p      7:06p      8:06p      9:06p     10:06p     11:06p      12:06a     1:12a\n",
+      "                San Antonio       9:41a     11:11a     12:11p     1:11p      2:11p      3:11p      4:11p      5:11p      6:11p      7:11p      8:11p      9:11p     10:11p     11:11p      12:10a     1:17a\n",
+      "            Mountain View         9:45a     11:16a     12:16p     1:16p      2:16p      3:16p      4:16p      5:16p      6:16p      7:16p      8:16p      9:16p     10:16p     11:16p      12:15a     1:21a\n",
+      "                  Sunnyvale       9:51a     11:21a     12:21p     1:21p      2:21p      3:21p      4:21p      5:21p      6:21p      7:21p      8:21p      9:21p     10:21p     11:21p      12:20a     1:26a\n",
+      "                   Lawrence       9:55a     11:26a     12:26p     1:26p      2:26p      3:26p      4:26p      5:26p      6:26p      7:26p      8:26p      9:26p     10:26p     11:26p      12:25a     1:31a\n",
+      "                 Santa Clara     10:01a     11:32a     12:32p     1:32p      2:32p      3:32p      4:32p      5:32p      6:32p      7:32p      8:32p      9:32p     10:32p     11:32p      12:31a     1:37a\n",
+      "           San Jose Diridon      10:10a     11:40a     12:40p     1:38p      2:40p      3:38p      4:40p      5:38p      6:40p      7:38p      8:40p      9:38p     10:40p     11:38p      12:39a     1:44a\n",
+      "                      Tamien     10:15a     11:45a     12:45p                2:45p                 4:45p                 6:45p                 8:45p                10:45p                 12:44a     1:49a\n",
+      "       EFFECTIVE September 12, 2022                                                                                                                                  Timetable subject to change without notice.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(docs[0].get_content())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8f5064d4-3e33-4f67-9b2e-46787161538f",
+   "metadata": {},
+   "source": [
+    "## Initialize Query Engine\n",
+    "\n",
+    "We now initialize a query engine over this data. Here we use a baseline summary index, which doesn't do vector indexing/chunking and instead dumps the entire text into the prompt.\n",
+    "\n",
+    "We see that the LLM (gpt-4-turbo) is able to provide all the stops for train no 225 northbound."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b3e985b6-9d38-449f-9cf9-aae166824eed",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import SummaryIndex\n",
+    "from llama_index.llms.openai import OpenAI\n",
+    "\n",
+    "llm = OpenAI(model=\"gpt-4o\")\n",
+    "index = SummaryIndex.from_documents(docs)\n",
+    "query_engine = index.as_query_engine(llm=llm)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "66eb0976-2cd6-4b14-9083-124baae9ed5d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"What are the stops (and times) for train no 237 northbound?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7dc6f275-07f4-429e-9335-f50982fe974c",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The stops and times for train no. 237 northbound are as follows:\n",
+      "\n",
+      "- San Jose Diridon: 12:12 PM\n",
+      "- Santa Clara: 12:18 PM\n",
+      "- Lawrence: 12:24 PM\n",
+      "- Sunnyvale: 12:28 PM\n",
+      "- Mountain View: 12:34 PM\n",
+      "- San Antonio: 12:37 PM\n",
+      "- California Ave: 12:42 PM\n",
+      "- Palo Alto: 12:46 PM\n",
+      "- Menlo Park: 12:50 PM\n",
+      "- Redwood City: 12:56 PM\n",
+      "- San Carlos: 1:01 PM\n",
+      "- Belmont: 1:04 PM\n",
+      "- Hillsdale: 1:08 PM\n",
+      "- Hayward Park: 1:11 PM\n",
+      "- San Mateo: 1:15 PM\n",
+      "- Burlingame: 1:19 PM\n",
+      "- Broadway: 1:22 PM\n",
+      "- Millbrae: 1:26 PM\n",
+      "- San Bruno: 1:30 PM\n",
+      "- S. San Francisco: 1:34 PM\n",
+      "- Bayshore: 1:41 PM\n",
+      "- 22nd Street: 1:46 PM\n",
+      "- San Francisco: 1:52 PM\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "229c4cb0-cf94-4a9f-bc7c-590388f50c1f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"What are all the trains (and times) that end at Tamien going Southbound?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6cf9fce0-5067-48f6-a7ef-62aa9e2edc3d",
+   "metadata": {},
+   "source": [
+    "It gets most of the answers correct (to be fair it misses two trains)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "51cf03ff-7728-4815-ab72-3bf54fc4a2c0",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The trains that end at Tamien going Southbound are:\n",
+      "\n",
+      "- Train 224 at 10:15a\n",
+      "- Train 228 at 11:45a\n",
+      "- Train 240 at 2:45p\n",
+      "- Train 248 at 4:45p\n",
+      "- Train 256 at 6:45p\n",
+      "- Train 264 at 8:45p\n",
+      "- Train 272 at 10:45p\n",
+      "- Train 284 at 1:49a\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e51e7feb-b74f-4101-8963-933ac7ec9763",
+   "metadata": {},
+   "source": [
+    "## Try Baseline\n",
+    "\n",
+    "In contrast, we try a baseline approach with the default PDF reader (PyPDF) in `SimpleDirectoryReader`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "364e5155-cc75-4302-a754-9444ae28e6b1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import SimpleDirectoryReader\n",
+    "from llama_index.core import SummaryIndex\n",
+    "from llama_index.llms.openai import OpenAI\n",
+    "\n",
+    "llm = OpenAI(model=\"gpt-4o\")\n",
+    "input_file = \"caltrain_schedule_weekend.pdf\"\n",
+    "reader = SimpleDirectoryReader(input_files=[input_file])\n",
+    "base_docs = reader.load_data()\n",
+    "index = SummaryIndex.from_documents(base_docs)\n",
+    "base_query_engine = index.as_query_engine(llm=llm)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a4011389-2d27-4a1a-bf8d-7309da28ab15",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Southbound  – WEEKEND SERVICE to SAN JOSE\n",
+      "Train No. 224 228 232 236 240 244 248 252 256 260 264 268 272 276 280 284\n",
+      "Service Types L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2\n",
+      "San Francisco 8:28a 9:58a 10:58a 11:58a 12:58p 1:58p 2:58p 3:58p 4:58p 5:58p 6:58p 7:58p 8:58p 9:58p 10:58p 12:05a\n",
+      "22nd Street 8:33a 10:03a 11:03a 12:03p 1:03p 2:03p 3:03p 4:03p 5:03p 6:03p 7:03p 8:03p 9:03p 10:03p 11:03p 12:10a\n",
+      "Bayshore 8:38a 10:08a 11:08a 12:08p 1:08p 2:08p 3:08p 4:08p 5:08p 6:08p 7:08p 8:08p 9:08p 10:08p 11:08p 12:15a\n",
+      "S. San Francisco 8:45a 10:15a 11:15a 12:15p 1:15p 2:15p 3:15p 4:15p 5:15p 6:15p 7:15p 8:15p 9:15p 10:15p 11:15p 12:22a\n",
+      "San Bruno 8:49a 10:19a 11:19a 12:19p 1:19p 2:19p 3:19p 4:19p 5:19p 6:19p 7:19p 8:19p 9:19p 10:19p 11:19p 12:26a\n",
+      "Millbrae 8:53a 10:24a 11:24a 12:24p 1:24p 2:24p 3:24p 4:24p 5:24p 6:24p 7:24p 8:24p 9:24p 10:24p 11:24p 12:31a\n",
+      "Broadway 8:57a 10:27a 11:27a 12:27p 1:27p 2:27p 3:27p 4:27p 5:27p 6:27p 7:27p 8:27p 9:27p 10:27p 11:27p 12:35a\n",
+      "Burlingame 9:00a 10:31a 11:31a 12:31p 1:31p 2:31p 3:31p 4:31p 5:31p 6:31p 7:31p 8:31p 9:31p 10:31p 11:31p 12:38a\n",
+      "San Mateo 9:04a 10:34a 11:34a 12:34p 1:34p 2:34p 3:34p 4:34p 5:34p 6:34p 7:34p 8:34p 9:34p 10:34p 11:34p 12:41a\n",
+      "Hayward Park 9:07a 10:37a 11:37a 12:37p 1:37p 2:37p 3:37p 4:37p 5:37p 6:37p 7:37p 8:37p 9:37p 10:37p 11:37p 12:45a\n",
+      "Hillsdale 9:10a 10:41a 11:41a 12:41p 1:41p 2:41p 3:41p 4:41p 5:41p 6:41p 7:41p 8:41p 9:41p 10:41p 11:41p 12:48a\n",
+      "Belmont 9:14a 10:44a 11:44a 12:44p 1:44p 2:44p 3:44p 4:44p 5:44p 6:44p 7:44p 8:44p 9:44p 10:44p 11:44p 12:52a\n",
+      "San Carlos 9:17a 10:48a 11:48a 12:48p 1:48p 2:48p 3:48p 4:48p 5:48p 6:48p 7:48p 8:48p 9:48p 10:48p 11:48p 12:55a\n",
+      "Redwood City 9:21a 10:52a 11:52a 12:52p 1:52p 2:52p 3:52p 4:52p 5:52p 6:52p 7:52p 8:52p 9:52p 10:52p 11:52p 12:59a\n",
+      "Menlo Park 9:28a 10:58a 11:58a 12:58p 1:58p 2:58p 3:58p 4:58p 5:58p 6:58p 7:58p 8:58p 9:58p 10:58p 11:58p 1:05a\n",
+      "Palo Alto 9:32a 11:02a 12:02p 1:02p 2:02p 3:02p 4:02p 5:02p 6:02p 7:02p 8:02p 9:02p 10:02p 11:02p 12:02a 1:09a\n",
+      "California Avenue 9:36a 11:06a 12:06p 1:06p 2:06p 3:06p 4:06p 5:06p 6:06p 7:06p 8:06p 9:06p 10:06p 11:06p 12:06a 1:12a\n",
+      "San Antonio 9:41a 11:11a 12:11p 1:11p 2:11p 3:11p 4:11p 5:11p 6:11p 7:11p 8:11p 9:11p 10:11p 11:11p 12:10a 1:17a\n",
+      "Mountain View 9:45a 11:16a 12:16p 1:16p 2:16p 3:16p 4:16p 5:16p 6:16p 7:16p 8:16p 9:16p 10:16p 11:16p 12:15a 1:21a\n",
+      "Sunnyvale 9:51a 11:21a 12:21p 1:21p 2:21p 3:21p 4:21p 5:21p 6:21p 7:21p 8:21p 9:21p 10:21p 11:21p 12:20a 1:26a\n",
+      "Lawrence 9:55a 11:26a 12:26p 1:26p 2:26p 3:26p 4:26p 5:26p 6:26p 7:26p 8:26p 9:26p 10:26p 11:26p 12:25a 1:31a\n",
+      "Santa Clara 10:01a 11:32a 12:32p 1:32p 2:32p 3:32p 4:32p 5:32p 6:32p 7:32p 8:32p 9:32p 10:32p 11:32p 12:31a 1:37a\n",
+      "San Jose Diridon 10:10a 11:40a 12:40p 1:38p 2:40p 3:38p 4:40p 5:38p 6:40p 7:38p 8:40p 9:38p 10:40p 11:38p 12:39a 1:44a\n",
+      "Tamien 10:15a 11:45a 12:45p 2:45p 4:45p 6:45p 8:45p 10:45p 12:44a 1:49aPrinter-Friendly Caltrain Schedule\n",
+      "Northbound  – WEEKEND SERVICE to SAN FRANCISCO\n",
+      "Train No. 221 225 229 233 237 241 245 249 253 257 261 265 269 273 *277 *281\n",
+      "Service Types L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2 L2\n",
+      "Tamien 7:12a 9:05a 10:05a 11:05a 1:05p 3:05p 5:05p 7:05p 9:05p 11:05p\n",
+      "San Jose Diridon 7:19a 9:12a 10:12a 11:12a 12:12p 1:12p 2:12p 3:12p 4:12p 5:12p 6:12p 7:12p 8:12p 9:12p 10:19p 11:12p\n",
+      "Santa Clara 7:25a 9:18a 10:18a 11:18a 12:18p 1:18p 2:18p 3:18p 4:18p 5:18p 6:18p 7:18p 8:18p 9:18p 10:25p 11:18p\n",
+      "Lawrence 7:31a 9:24a 10:24a 11:24a 12:24p 1:24p 2:24p 3:24p 4:24p 5:24p 6:24p 7:24p 8:24p 9:24p 10:31p 11:24p\n",
+      "Sunnyvale 7:35a 9:28a 10:28a 11:28a 12:28p 1:28p 2:28p 3:28p 4:28p 5:28p 6:28p 7:28p 8:28p 9:28p 10:35p 11:28p\n",
+      "Mountain View 7:40a 9:34a 10:34a 11:34a 12:34p 1:34p 2:34p 3:34p 4:34p 5:34p 6:34p 7:34p 8:34p 9:34p 10:40p 11:34p\n",
+      "San Antonio 7:43a 9:37a 10:37a 11:37a 12:37p 1:37p 2:37p 3:37p 4:37p 5:37p 6:37p 7:37p 8:37p 9:37p 10:44p 11:37p\n",
+      "California Ave 7:48a 9:42a 10:42a 11:42a 12:42p 1:42p 2:42p 3:42p 4:42p 5:42p 6:42p 7:42p 8:42p 9:42p 10:48p 11:42p\n",
+      "Palo Alto 7:52a 9:46a 10:46a 11:46a 12:46p 1:46p 2:46p 3:46p 4:46p 5:46p 6:46p 7:46p 8:46p 9:46p 10:53p 11:46p\n",
+      "Menlo Park 7:55a 9:50a 10:50a 11:50a 12:50p 1:50p 2:50p 3:50p 4:50p 5:50p 6:50p 7:50p 8:50p 9:50p 10:56p 11:50p\n",
+      "Redwood City 8:01a 9:56a 10:56a 11:56a 12:56p 1:56p 2:56p 3:56p 4:56p 5:56p 6:56p 7:56p 8:56p 9:56p 11:02p 11:56p\n",
+      "San Carlos 8:05a 10:01a 11:01a 12:01p 1:01p 2:01p 3:01p 4:01p 5:01p 6:01p 7:01p 8:01p 9:01p 10:01p 11:07p 12:01a\n",
+      "Belmont 8:09a 10:04a 11:04a 12:04p 1:04p 2:04p 3:04p 4:04p 5:04p 6:04p 7:04p 8:04p 9:04p 10:04p 11:10p 12:04a\n",
+      "Hillsdale 8:12a 10:08a 11:08a 12:08p 1:08p 2:08p 3:08p 4:08p 5:08p 6:08p 7:08p 8:08p 9:08p 10:08p 11:14p 12:08a\n",
+      "Hayward Park 8:15a 10:11a 11:11a 12:11p 1:11p 2:11p 3:11p 4:11p 5:11p 6:11p 7:11p 8:11p 9:11p 10:11p 11:17p 12:11a\n",
+      "San Mateo 8:19a 10:15a 11:15a 12:15p 1:15p 2:15p 3:15p 4:15p 5:15p 6:15p 7:15p 8:15p 9:15p 10:15p 11:21p 12:15a\n",
+      "Burlingame 8:22a 10:19a 11:19a 12:19p 1:19p 2:19p 3:19p 4:19p 5:19p 6:19p 7:19p 8:19p 9:19p 10:19p 11:25p 12:19a\n",
+      "Broadway 8:25a 10:22a 11:22a 12:22p 1:22p 2:22p 3:22p 4:22p 5:22p 6:22p 7:22p 8:22p 9:22p 10:22p 11:28p 12:22a\n",
+      "Millbrae 8:29a 10:26a 11:26a 12:26p 1:26p 2:26p 3:26p 4:26p 5:26p 6:26p 7:26p 8:26p 9:26p 10:26p 11:32p 12:26a\n",
+      "San Bruno 8:34a 10:30a 11:30a 12:30p 1:30p 2:30p 3:30p 4:30p 5:30p 6:30p 7:30p 8:30p 9:30p 10:30p 11:37p 12:30a\n",
+      "S. San Francisco 8:38a 10:34a 11:34a 12:34p 1:34p 2:34p 3:34p 4:34p 5:34p 6:34p 7:34p 8:34p 9:34p 10:34p 11:41p 12:34a\n",
+      "Bayshore 8:44a 10:41a 11:41a 12:41p 1:41p 2:41p 3:41p 4:41p 5:41p 6:41p 7:41p 8:41p 9:41p 10:41p 11:47p 12:41a\n",
+      "22nd Street 8:50a 10:46a 11:46a 12:46p 1:46p 2:46p 3:46p 4:46p 5:46p 6:46p 7:46p 8:46p 9:46p 10:46p 11:53p 12:46a\n",
+      "San Francisco 8:56a 10:52a 11:53a 12:53p 1:52p 2:52p 3:52p 4:52p 5:52p 6:52p 7:52p 8:52p 9:52p 10:52p 11:59p 12:52aZONE 2 ZONE 3 ZONE 4 ZONE 4 ZONE 3 ZONE 2 ZONE 1 ZONE 12XX Local\n",
+      "2XX Local\n",
+      "EFFECTIVE September 12, 2022  Timetable subject to change without notice. *On SAP Center event days, Train 277 or Train 281departure from San Jose Diridon station may be delayed and will depart no later than 10:30p or 11:30p respectively.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(base_docs[0].get_content())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "42203c70-7ca7-4200-bf47-6282eefca3bf",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "base_response = base_query_engine.query(\n",
+    "    \"What are the stops (and times) for train no 237 northbound?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "06aa47b6-0f31-4b2d-90f0-bf6c74befd38",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Train No. 237 northbound stops at the following stations and times:\n",
+      "\n",
+      "- Tamien: 1:05p\n",
+      "- San Jose Diridon: 1:12p\n",
+      "- Santa Clara: 1:18p\n",
+      "- Lawrence: 1:24p\n",
+      "- Sunnyvale: 1:28p\n",
+      "- Mountain View: 1:34p\n",
+      "- San Antonio: 1:37p\n",
+      "- California Ave: 1:42p\n",
+      "- Palo Alto: 1:46p\n",
+      "- Menlo Park: 1:50p\n",
+      "- Redwood City: 1:56p\n",
+      "- San Carlos: 2:01p\n",
+      "- Belmont: 2:04p\n",
+      "- Hillsdale: 2:08p\n",
+      "- Hayward Park: 2:11p\n",
+      "- San Mateo: 2:15p\n",
+      "- Burlingame: 2:19p\n",
+      "- Broadway: 2:22p\n",
+      "- Millbrae: 2:26p\n",
+      "- San Bruno: 2:30p\n",
+      "- S. San Francisco: 2:34p\n",
+      "- Bayshore: 2:41p\n",
+      "- 22nd Street: 2:46p\n",
+      "- San Francisco: 2:52p\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(base_response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4f3c1de7-3351-4cd8-991c-34a777952194",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "base_response = base_query_engine.query(\n",
+    "    \"What are all the trains (and times) that end at Tamien going Southbound?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "513b1007-7508-4fb1-836c-de9353433a67",
+   "metadata": {},
+   "source": [
+    "Note that the trains don't line up with the times!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "108edb92-76af-406b-a139-8b9e7c6528f2",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The trains that end at Tamien going Southbound are:\n",
+      "\n",
+      "- Train 224 at 10:15a\n",
+      "- Train 228 at 11:45a\n",
+      "- Train 240 at 2:45p\n",
+      "- Train 252 at 4:45p\n",
+      "- Train 264 at 6:45p\n",
+      "- Train 276 at 8:45p\n",
+      "- Train 284 at 10:45p\n",
+      "- Train 284 at 12:44a\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(base_response))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/demo_advanced.ipynb

@@ -4,9 +4,13 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Llama Parser <> LlamaIndex\n",
+    "# Advanced RAG with LlamaParse\n",
     "\n",
-    "This notebook is a complete walkthrough for using `LlamaParse` for RAG applications with `LlamaIndex`."
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_advanced.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "This notebook shows you how to use LlamaParse with our advanced markdown ingestion and recursive retrieval algorithms to model tables/text within a document hierarchically. This lets you ask questions over both tables and text.\n",
+    "\n",
+    "Note for this example, we are using the `llama_index >=0.10.4` version"
    ]
   },
   {
@@ -15,7 +19,12 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!pip install llama-index llama-parse sentence-transformers llama_hub pypdf"
+    "%pip install llama-index\n",
+    "%pip install llama-index-core\n",
+    "%pip install llama-index-embeddings-openai\n",
+    "%pip install llama-index-postprocessor-flag-embedding-reranker\n",
+    "%pip install git+https://github.com/FlagOpen/FlagEmbedding.git\n",
+    "%pip install llama-parse"
    ]
   },
   {
@@ -24,7 +33,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!wget 'https://raw.githubusercontent.com/run-llama/llama_index/main/docs/examples/data/10q/uber_10q_march_2022.pdf' -O './uber_10q_march_2022.pdf'"
+    "!wget 'https://raw.githubusercontent.com/run-llama/llama_index/main/docs/docs/examples/data/10q/uber_10q_march_2022.pdf' -O './uber_10q_march_2022.pdf'"
    ]
   },
   {
@@ -36,69 +45,40 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 31,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "# llama-parse is async-first, running the sync code in a notebook requires the use of nest_asyncio\n",
+    "# llama-parse is async-first, running the async code in a notebook requires the use of nest_asyncio\n",
     "import nest_asyncio\n",
     "\n",
     "nest_asyncio.apply()\n",
     "\n",
     "import os\n",
+    "\n",
+    "# API access to llama-cloud\n",
     "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-\"\n",
+    "\n",
+    "# Using OpenAI API for embeddings/llms\n",
     "os.environ[\"OPENAI_API_KEY\"] = \"sk-\""
    ]
   },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Using old `PDFReader` from LLamaHub as baseline PDF parser"
-   ]
-  },
   {
    "cell_type": "code",
-   "execution_count": 32,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "from llama_hub.file.pdf.base import PDFReader\n",
-    "from pathlib import Path\n",
-    "from llama_index import Document\n",
+    "from llama_index.llms.openai import OpenAI\n",
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.core import VectorStoreIndex\n",
+    "from llama_index.core import Settings\n",
     "\n",
+    "embed_model = OpenAIEmbedding(model=\"text-embedding-3-small\")\n",
+    "llm = OpenAI(model=\"gpt-3.5-turbo-0125\")\n",
     "\n",
-    "loader = PDFReader()\n",
-    "docs0 = loader.load_data(file=Path('./uber_10q_march_2022.pdf'))\n",
-    "doc_text = \"\\n\\n\".join([d.get_content() for d in docs0])\n",
-    "baseline_docs = [Document(text=doc_text)]"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Build Vector Index for the nodes parsed from `PdfReader` and run basic query engine as a baseline approach"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 33,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from llama_index.llms import OpenAI\n",
-    "from llama_index.embeddings import OpenAIEmbedding\n",
-    "from llama_index import VectorStoreIndex, ServiceContext\n",
-    "\n",
-    "embed_model=OpenAIEmbedding(model=\"text-embedding-3-small\")\n",
-    "llm = OpenAI(model=\"gpt-3.5-turbo-0613\")\n",
-    "service_context = ServiceContext.from_defaults(\n",
-    "    llm=llm, embed_model=embed_model, chunk_size=512\n",
-    ")\n",
-    "\n",
-    "baseline_index = VectorStoreIndex.from_documents(baseline_docs, service_context=service_context)\n",
-    "baseline_pdf_query_engine = baseline_index.as_query_engine(similarity_top_k=15)"
+    "Settings.llm = llm\n",
+    "Settings.embed_model = embed_model"
    ]
   },
   {
@@ -114,95 +94,79 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 34,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Started parsing the file under job_id 75cc54de-b6fe-4466-b238-a1d711817a72\n"
+      "Started parsing the file under job_id edbcecf3-5379-40de-9c52-0d97985dccf5\n"
      ]
     }
    ],
    "source": [
     "from llama_parse import LlamaParse\n",
     "\n",
-    "documents = LlamaParse(result_type=\"markdown\").load_data('./uber_10q_march_2022.pdf')"
+    "documents = LlamaParse(result_type=\"markdown\").load_data(\"./uber_10q_march_2022.pdf\")"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 35,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Form 10-Q\n",
+      "# Document\n",
       "\n",
-      "# UNITED STATES SECURITIES AND EXCHANGE COMMISSION\n",
-      "\n",
-      "Washington, D.C. 20549\n",
+      "# UNITED STATES SECURITIES AND EXCHANGE COMMISSION Washington, D.C. 20549\n",
       "\n",
       "## FORM 10-Q\n",
       "\n",
       "(Mark One)\n",
       "\n",
-      "☒ QUARTERLY REPORT PURSUANT TO SECTION 13 OR 15(d) OF THE SECURITIES EXCHANGE ACT OF 1934\n",
+      "☒ QUARTERLY REPORT PURSUANT TO SECTION 13 OR 15(d) OF THE SECURITIES EXCHANGE ACT OF 1934 For the quarterly period\n",
+      "ended March 31, 2022 OR ☐ TRANSITION REPORT PURSUANT TO SECTION 13 OR 15(d) OF THE SECURITIES EXCHANGE ACT OF 1934\n",
+      "For the transition period from_____ to _____ Commission File Number: 001-38902\n",
       "\n",
-      "For the quarterly period ended March 31, 2022\n",
+      "UBER TECHNOLOGIES, INC. (Exact name of registrant as specified in its charter) Not Applicable (Former name, former\n",
+      "address and former fiscal year, if changed since last report)\n",
       "\n",
-      "Commission File Number: 001-38902\n",
+      "Delaware 45-2647441 (State or other jurisdiction of incorporation or organization) (I.R.S. Employer Identification\n",
+      "No.)\n",
       "\n",
-      "### UBER TECHNOLOGIES, INC.\n",
+      "1515 3rd Street San Francisco, California 94158 (Address of principal executive offices, including zip code) (415)\n",
+      "612-8582 (Registrant’s telephone number, including area code)\n",
       "\n",
-      "(Exact name of registrant as specified in its charter)\n",
+      "Securities registered pursuant to Section 12(b) of the Act:\n",
       "\n",
-      "Delaware 45-2647441\n",
-      "\n",
-      "(State or other jurisdiction of incorporation or organization) (I.R.S. Employer Identification No.)\n",
-      "\n",
-      "1515 3rd Street\n",
-      "\n",
-      "San Francisco, California 94158\n",
-      "\n",
-      "(Address of principal executive offices, including zip code)\n",
-      "\n",
-      "(415) 612-8582\n",
-      "\n",
-      "(Registrant’s telephone number, including area code)\n",
-      "\n",
-      "### Securities registered pursuant to Section 12(b) of the Act:\n",
-      "\n",
-      "|Title of each class|Trading Symbol(s)|Name of each exchange on which registered|\n",
-      "|---|---|---|\n",
-      "|Common Stock, par value $0.00001 per share|UBER|New York Stock Exchange|\n",
-      "\n",
-      "Indicate by check mark whether the registrant (1) has filed all reports required to be ...\n"
+      "|Title of each class|Trading Symbol(s)|...\n"
      ]
     }
    ],
    "source": [
-    "print(documents[0].text[:1000] + '...')"
+    "print(documents[0].text[:1000] + \"...\")"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 36,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "from llama_index.node_parser import MarkdownElementNodeParser\n",
-    "from llama_index.llms import OpenAI\n",
+    "from llama_index.core.node_parser import MarkdownElementNodeParser\n",
     "\n",
-    "node_parser = MarkdownElementNodeParser(llm=OpenAI(model=\"gpt-3.5-turbo-0613\"), num_workers=8)"
+    "node_parser = MarkdownElementNodeParser(\n",
+    "    llm=OpenAI(model=\"gpt-3.5-turbo-0125\"), num_workers=8\n",
+    ")"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 37,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -216,81 +180,81 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "52it [00:00, 58835.66it/s]\n",
-      "  0%|          | 0/52 [00:00<?, ?it/s]"
-     ]
-    },
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "100%|██████████| 52/52 [00:19<00:00,  2.69it/s]\n"
+      "80it [00:00, 77744.28it/s]\n",
+      "100%|██████████| 80/80 [00:21<00:00,  3.66it/s]\n"
      ]
     }
    ],
    "source": [
-    "nodes = node_parser.get_nodes_from_documents(documents)\n",
-    "base_nodes, node_mapping = node_parser.get_base_nodes_and_mappings(nodes)"
+    "nodes = node_parser.get_nodes_from_documents(documents)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 38,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "from llama_index import VectorStoreIndex, ServiceContext\n",
-    "from llama_index.embeddings import OpenAIEmbedding\n",
-    "\n",
-    "ctx = ServiceContext.from_defaults(\n",
-    "    llm=OpenAI(model=\"gpt-4\"), \n",
-    "    embed_model=OpenAIEmbedding(model=\"text-embedding-3-small\"), \n",
-    "    chunk_size=512\n",
+    "base_nodes, objects = node_parser.get_nodes_and_objects(nodes)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "recursive_index = VectorStoreIndex(nodes=base_nodes + objects)\n",
+    "raw_index = VectorStoreIndex.from_documents(documents)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.postprocessor.flag_embedding_reranker import (\n",
+    "    FlagEmbeddingReranker,\n",
     ")\n",
     "\n",
-    "recursive_index = VectorStoreIndex(nodes=base_nodes, service_context=ctx)\n",
-    "raw_index = VectorStoreIndex.from_documents(documents, service_context=ctx)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 39,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from llama_index.retrievers import RecursiveRetriever\n",
+    "reranker = FlagEmbeddingReranker(\n",
+    "    top_n=5,\n",
+    "    model=\"BAAI/bge-reranker-large\",\n",
+    ")\n",
     "\n",
-    "retriever = RecursiveRetriever(\n",
-    "    \"vector\", \n",
-    "    retriever_dict={\n",
-    "        \"vector\": recursive_index.as_retriever(similarity_top_k=15)\n",
-    "    },\n",
-    "    node_dict=node_mapping,\n",
+    "recursive_query_engine = recursive_index.as_query_engine(\n",
+    "    similarity_top_k=15, node_postprocessors=[reranker], verbose=True\n",
+    ")\n",
+    "\n",
+    "raw_query_engine = raw_index.as_query_engine(\n",
+    "    similarity_top_k=15, node_postprocessors=[reranker]\n",
     ")"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 40,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "303\n"
+     ]
+    }
+   ],
    "source": [
-    "from llama_index.query_engine import RetrieverQueryEngine\n",
-    "from llama_index.postprocessor import SentenceTransformerRerank\n",
-    "\n",
-    "reranker = SentenceTransformerRerank(top_n=5, model=\"BAAI/bge-reranker-large\")\n",
-    "\n",
-    "recursive_query_engine = RetrieverQueryEngine.from_args(retriever, node_postprocessors=[reranker], service_context=ctx)\n",
-    "\n",
-    "raw_query_engine = raw_index.as_query_engine(similarity_top_k=15, node_postprocessors=[reranker], service_context=ctx)"
+    "print(len(nodes))"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Comparing `PdfReader vs new LlamaParse` as pdf data parsing methods\n",
-    "we also compare base query engine vs recursive query engine with tables"
+    "## Using `new LlamaParse` as pdf data parsing methods and retrieve tables with two different methods\n",
+    "we compare base query engine vs recursive query engine with tables"
    ]
   },
   {
@@ -302,31 +266,36 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 41,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "***********Baseline PDF Query Engine***********\n",
-      "The information provided does not specify the amount of cash paid for income taxes, net of refunds.\n",
       "\n",
       "***********New LlamaParse+ Basic Query Engine***********\n",
-      "The context does not provide specific information on the cash paid for income taxes, net of refunds.\n",
-      "\n",
+      "Cash paid for income taxes, net of refunds, is not explicitly provided in the context information.\n",
+      "\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_44_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_42_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_40_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_320_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_38_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_324_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\n",
+      "\u001b[0m\n",
       "***********New LlamaParse+ Recursive Retriever Query Engine***********\n",
-      "The cash paid for income taxes, net of refunds, is $22.\n"
+      "$22 for the period ended March 31, 2021 and $41 for the period ended March 31, 2022.\n"
      ]
     }
    ],
    "source": [
-    "query = \"how is the Cash paid for Income taxes, net of refunds?\"\n",
-    "\n",
-    "response_0 = baseline_pdf_query_engine.query(query)\n",
-    "print(\"***********Baseline PDF Query Engine***********\")\n",
-    "print(response_0)\n",
-    "\n",
+    "query = \"how is the Cash paid for Income taxes, net of refunds from Supplemental disclosures of cash flow information?\"\n",
     "\n",
     "response_1 = raw_query_engine.query(query)\n",
     "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
@@ -334,7 +303,7 @@
     "\n",
     "response_2 = recursive_query_engine.query(query)\n",
     "print(\"\\n***********New LlamaParse+ Recursive Retriever Query Engine***********\")\n",
-    "print(response_2)\n"
+    "print(response_2)"
    ]
   },
   {
@@ -351,31 +320,42 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 42,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "***********Baseline PDF Query Engine***********\n",
-      "The change in free cash flow is a decrease of $635 million. The rate of change is not provided in the given context.\n",
       "\n",
       "***********New LlamaParse+ Basic Query Engine***********\n",
-      "The free cash flow changed from $(682) million in the three months ended March 31, 2021, to $(47) million in the same period in 2022. However, the context does not provide a specific rate of change for the free cash flow.\n",
-      "\n",
+      "The change in free cash flow from the financial and operational highlights is a decrease from $(682) million in 2021 to $(47) million in 2022. This represents a significant improvement in free cash flow performance from one period to the next.\n",
+      "\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_320_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_38_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_44_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_324_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_40_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_280_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_42_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_124_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_240_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the change of free cash flow and what is the rate from the financial and operational highlights?\n",
+      "\u001b[0m\n",
       "***********New LlamaParse+ Recursive Retriever Query Engine***********\n",
-      "The free cash flow changed from negative $682 million in the three months ended March 31, 2021, to negative $47 million in the same period in 2022. This represents a significant improvement, but the exact rate of change is not provided in the context.\n"
+      "The change in free cash flow from the financial and operational highlights is an improvement of $635 million, with the rate being a significant increase compared to the same period in the prior year.\n"
      ]
     }
    ],
    "source": [
-    "query = \"what is the change of free cash flow and what is the rate?\"\n",
-    "\n",
-    "response_0 = baseline_pdf_query_engine.query(query)\n",
-    "print(\"***********Baseline PDF Query Engine***********\")\n",
-    "print(response_0)\n",
-    "\n",
+    "query = \"what is the change of free cash flow and what is the rate from the financial and operational highlights?\"\n",
     "\n",
     "response_1 = raw_query_engine.query(query)\n",
     "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
@@ -400,31 +380,38 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 47,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "***********Baseline PDF Query Engine***********\n",
-      "The net loss attributable to Uber Technologies, Inc. for the current year is $5.9 billion. However, there is no information provided in the given context regarding the net loss for the previous year.\n",
       "\n",
       "***********New LlamaParse+ Basic Query Engine***********\n",
-      "The net loss attributable to Uber Technologies, Inc. for the first quarter of 2022 was $5.9 billion. This is significantly higher compared to the net loss of $108 million in the first quarter of 2021.\n",
-      "\n",
+      "The net loss value attributable to Uber for the current period is $5.9 billion, which is an increase compared to the net loss of $108 million in the same period last year.\n",
+      "\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_22_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_316_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_230_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_26_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_234_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_24_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_196_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query what is the net loss value attributable to Uber compared to last year?\n",
+      "\u001b[0m\n",
       "***********New LlamaParse+ Recursive Retriever Query Engine***********\n",
-      "The net loss attributable to Uber Technologies, Inc. for the three months ended March 31, 2022 was $5.93 billion. This is significantly higher compared to the same period in 2021, when the net loss was $108 million.\n"
+      "The net loss value attributable to Uber Technologies, Inc. for the first quarter of 2022 was $5,930 million, which is significantly higher compared to the net loss of $108 million for the same period in 2021.\n"
      ]
     }
    ],
    "source": [
-    "query = \"what is Net loss attributable to Uber compared to last year\"\n",
-    "\n",
-    "response_0 = baseline_pdf_query_engine.query(query)\n",
-    "print(\"***********Baseline PDF Query Engine***********\")\n",
-    "print(response_0)\n",
-    "\n",
+    "query = \"what is the net loss value attributable to Uber compared to last year?\"\n",
     "\n",
     "response_1 = raw_query_engine.query(query)\n",
     "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
@@ -449,31 +436,42 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 43,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "***********Baseline PDF Query Engine***********\n",
-      "Cash flows from investing activities refers to the cash inflows and outflows related to the acquisition and disposal of long-term assets and investments. This includes activities such as purchasing property and equipment, acquiring or selling businesses, purchasing or selling marketable securities, and making investments in notes receivable. It provides information on the cash used or generated by these investing activities during a specific period.\n",
       "\n",
       "***********New LlamaParse+ Basic Query Engine***********\n",
-      "Cash flows from investing activities refer to the net cash used in or generated from various investment-related transactions within a specific period. For Uber, in the three months ended March 31, 2022, this primarily consisted of $62 million in purchases of property and equipment and $59 million in acquisition of business, net of cash acquired, totaling to a net cash used of $135 million. In the same period in 2021, it primarily consisted of $803 million in purchases of non-marketable equity securities, $336 million in purchases of marketable securities, and $216 million in purchases of a note receivable. These were partially offset by proceeds from maturities and sales of marketable securities of $696 million and $500 million in proceeds from the sale of non-marketable equity securities, resulting in a net cash used of $250 million.\n",
-      "\n",
+      "Cash flows from investing activities were as follows:\n",
+      "- For the three months ended March 31, 2022, net cash used in investing activities was $135 million, primarily driven by $62 million in purchases of property and equipment and $59 million in acquisition of business, net of cash acquired.\n",
+      "- For the three months ended March 31, 2021, net cash used in investing activities was $250 million, mainly consisting of $803 million in purchases of non-marketable equity securities, $336 million in purchases of marketable securities, and $216 million in purchases of a note receivable, partially offset by proceeds from maturities and sales of marketable securities of $696 million and $500 million in proceeds from the sale of non-marketable equity securities.\n",
+      "\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_44_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_38_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_324_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_40_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_320_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_42_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203mRetrieval entering id_b656577b-91de-47ca-981e-8b1d63e20c20_270_table: TextNode\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200mRetrieving from object TextNode with query What were cash flows like from investing activities?\n",
+      "\u001b[0m\n",
       "***********New LlamaParse+ Recursive Retriever Query Engine***********\n",
-      "Cash flows from investing activities refer to the money spent or generated from various investment-related activities in a specific period. This can include purchases of property and equipment, purchases of marketable and non-marketable equity securities, acquisition of businesses, and proceeds from the sale of assets or securities. For example, in 2022, the company used $135 million in investing activities, primarily consisting of $62 million in purchases of property and equipment and $59 million in acquisition of business, net of cash acquired.\n"
+      "Cash flows from investing activities were as follows:\n",
+      "- For the three months ended March 31, 2021, net cash used in investing activities was $250 million.\n",
+      "- For the three months ended March 31, 2022, net cash used in investing activities was $135 million.\n"
      ]
     }
    ],
    "source": [
-    "query = \"what is Cash flows from investing activities\"\n",
-    "\n",
-    "response_0 = baseline_pdf_query_engine.query(query)\n",
-    "print(\"***********Baseline PDF Query Engine***********\")\n",
-    "print(response_0)\n",
-    "\n",
+    "query = \"What were cash flows like from investing activities?\"\n",
     "\n",
     "response_1 = raw_query_engine.query(query)\n",
     "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
@@ -495,81 +493,11 @@
    "source": [
     "![image.png](attachment:image.png)"
    ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Persist and load the Recursive Retriever"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Persist"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 44,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import json\n",
-    "\n",
-    "recursive_index.storage_context.persist(persist_dir=\"./storage\")\n",
-    "\n",
-    "node_mapping_json = {k: v.dict() for k, v in node_mapping.items()}\n",
-    "with open(\"./node_mapping.json\", \"w\") as f:\n",
-    "    json.dump(node_mapping_json, f)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Load"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 45,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from llama_index import StorageContext, load_index_from_storage\n",
-    "from llama_index.schema import TextNode\n",
-    "\n",
-    "index = load_index_from_storage(StorageContext.from_defaults(\n",
-    "    persist_dir=\"./storage\"), service_context=ctx\n",
-    ")\n",
-    "with open(\"./node_mapping.json\", \"r\") as f:\n",
-    "    node_mapping_json = json.load(f)\n",
-    "    node_mapping = {k: TextNode(**v) for k, v in node_mapping_json.items()}"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 46,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "retriever = RecursiveRetriever(\n",
-    "    \"vector\", \n",
-    "    retriever_dict={\n",
-    "        \"vector\": index.as_retriever(similarity_top_k=15)\n",
-    "    },\n",
-    "    node_dict=node_mapping,\n",
-    ")\n",
-    "\n",
-    "recursive_query_engine = RetrieverQueryEngine.from_args(retriever, node_postprocessors=[reranker], service_context=ctx)"
-   ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "llama-parse-aNC435Vv-py3.11",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -582,11 +510,9 @@
    "mimetype": "text/x-python",
    "name": "python",
    "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.11.6"
-  },
-  "orig_nbformat": 4
+   "pygments_lexer": "ipython3"
+  }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }

examples/demo_api.ipynb

@@ -11,7 +11,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -38,7 +38,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -47,7 +47,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -88,7 +88,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -128,10 +128,8 @@
    "mimetype": "text/x-python",
    "name": "python",
    "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.11.5"
-  },
-  "orig_nbformat": 4
+   "pygments_lexer": "ipython3"
+  }
  },
  "nbformat": 4,
  "nbformat_minor": 2

examples/demo_astradb.ipynb

@@ -0,0 +1,295 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Using llama-parse with AstraDB"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In this notebook, we show a basic RAG-style example that uses `llama-parse` to parse a PDF document, store the corresponding document into a vector store (`AstraDB`) and finally, perform some basic queries against that store. The notebook is modeled after the quick start notebooks and hence is meant as a way of getting started with `llama-parse`, backed by a vector database."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Requirements"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First, install the required dependencies\n",
+    "%pip install --quiet llama-index llama-parse llama-index-vector-stores-astra-db llama-index-llms-openai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Configuration"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import openai\n",
+    "\n",
+    "from getpass import getpass\n",
+    "\n",
+    "# Get all required API keys and parameters\n",
+    "llama_cloud_api_key = getpass(\"Enter your Llama Index Cloud API Key: \")\n",
+    "api_endpoint = input(\"Enter your Astra DB API Endpoint: \")\n",
+    "token = getpass(\"Enter your Astra DB Token: \")\n",
+    "namespace = (\n",
+    "    input(\"Enter your Astra DB namespace (optional, must exist on Astra): \") or None\n",
+    ")\n",
+    "openai_api_key = getpass(\"Enter your OpenAI API Key: \")\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = llama_cloud_api_key\n",
+    "openai.api_key = openai_api_key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the sync code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using llama-parse to parse a PDF"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Download complete.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Grab a PDF from Arxiv for indexing\n",
+    "import requests\n",
+    "\n",
+    "# The URL of the file you want to download\n",
+    "url = \"https://arxiv.org/pdf/1706.03762.pdf\"\n",
+    "# The local path where you want to save the file\n",
+    "file_path = \"./attention.pdf\"\n",
+    "\n",
+    "# Perform the HTTP request\n",
+    "response = requests.get(url)\n",
+    "\n",
+    "# Check if the request was successful\n",
+    "if response.status_code == 200:\n",
+    "    # Open the file in binary write mode and save the content\n",
+    "    with open(file_path, \"wb\") as file:\n",
+    "        file.write(response.content)\n",
+    "    print(\"Download complete.\")\n",
+    "else:\n",
+    "    print(\"Error downloading the file.\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id ce3909a7-54cf-438b-849a-fe9a903b0c71\n"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "documents = LlamaParse(result_type=\"text\").load_data(file_path)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'rmer - model architecture.\\nThe Transformer follows this overall architecture using stacked self-attention and point-wise, fully\\nconnected layers for both the encoder and decoder, shown in the left and right halves of Figure 1,\\nrespectively.\\n3.1   Encoder and Decoder Stacks\\nEncoder:     The encoder is composed of a stack of N = 6 identical layers. Each layer has two\\nsub-layers. The first is a multi-head self-attention mechanism, and the second is a simple, position-\\nwise fully connected feed-forward network. We employ a residual connection [11] around each of\\nthe two sub-layers, followed by layer normalization [1]. That is, the output of each sub-layer is\\nLayerNorm(x + Sublayer(x)), where Sublayer(x) is the function implemented by the sub-layer\\nitself. To facilitate these residual connections, all sub-layers in the model, as well as the embedding\\nlayers, produce outputs of dimension dmodel = 512.\\nDecoder:    The decoder is also composed of a stack of N = 6 identical layers. In addition '"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Take a quick look at some of the parsed text from the document:\n",
+    "documents[0].get_content()[10000:11000]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Storing into Astra DB"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.vector_stores.astra_db import AstraDBVectorStore\n",
+    "\n",
+    "astra_db_store = AstraDBVectorStore(\n",
+    "    token=token,\n",
+    "    api_endpoint=api_endpoint,\n",
+    "    namespace=namespace,\n",
+    "    collection_name=\"astra_v_table_llamaparse\",\n",
+    "    embedding_dimension=1536,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core.node_parser import SimpleNodeParser\n",
+    "\n",
+    "node_parser = SimpleNodeParser()\n",
+    "\n",
+    "nodes = node_parser.get_nodes_from_documents(documents)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.core import VectorStoreIndex, StorageContext\n",
+    "\n",
+    "storage_context = StorageContext.from_defaults(vector_store=astra_db_store)\n",
+    "\n",
+    "index = VectorStoreIndex(\n",
+    "    nodes=nodes,\n",
+    "    storage_context=storage_context,\n",
+    "    embed_model=OpenAIEmbedding(api_key=openai_api_key),\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Simple RAG Example"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = index.as_query_engine(similarity_top_k=15)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "***********New LlamaParse+ Basic Query Engine***********\n",
+      "Multi-Head Attention is also known as multi-headed self-attention.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query = \"What is Multi-Head Attention also known as?\"\n",
+    "\n",
+    "response_1 = query_engine.query(query)\n",
+    "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
+    "print(response_1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'We used beam search as described in the previous section, but no\\ncheckpoint averaging. We present these results in Table 3.\\nIn Table 3 rows (A), we vary the number of attention heads and the attention key and value dimensions,\\nkeeping the amount of computation constant, as described in Section 3.2.2. While single-head\\nattention is 0.9 BLEU worse than the best setting, quality also drops off with too many heads.\\nIn Table 3 rows (B), we observe that reducing the attention key size dk hurts model quality. This\\nsuggests that determining compatibility is not easy and that a more sophisticated compatibility\\nfunction than dot product may be beneficial. We further observe in rows (C) and (D) that, as expected,\\nbigger models are better, and dropout is very helpful in avoiding over-fitting. In row (E) we replace our\\nsinusoidal positional encoding with learned positional embeddings [9], and observe nearly identical\\nresults to the base model.\\n6.3    English Constituency Parsing\\nTo evaluate if the Transformer can generalize to other tasks we performed experiments on English\\nconstituency parsing. This task presents specific challenges: the output is subject to strong structural\\nconstraints and is significantly longer than the input. Furthermore, RNN sequence-to-sequence\\nmodels have not been able to attain state-of-the-art results in small-data regimes [37].\\nWe trained a 4-layer transformer with dmodel = 1024 on the Wall Street Journal (WSJ) portion of the\\nPenn Treebank [25], about 40K training sentences. We also trained it in a semi-supervised setting,\\nusing the larger high-confidence and BerkleyParser corpora from with approximately 17M sentences\\n[37]. We used a vocabulary of 16K tokens for the WSJ only setting and a vocabulary of 32K tokens\\nfor the semi-supervised setting.\\nWe performed only a small number of experiments to select the dropout, both attention and residual\\n(section 5.4), learning rates and beam size on the Section 22 development set, all other parameters\\nremained unchanged from the English-to-German base translation model. During inference, we\\n                                                             9\\n---\\nTable 4: The Transformer generalizes well to English constituency parsing (Results are on Section 23\\nof WSJ)\\n                          Parser                           Training             WSJ 23 F1\\n            Vinyals & Kaiser el al. (2014) [37]    WSJ only, discriminative         88.3\\n                 Petrov et al. (2006) [29]         WSJ only, discriminative         90.4\\n                   Zhu et al. (2013) [40]          WSJ only, discriminative         90.4\\n                   Dyer et al. (2016) [8]          WSJ only, discriminative         91.7\\n                  Transformer (4 layers)           WSJ only, discriminative         91.3\\n                   Zhu et al. (2013) [40]              semi-supervised              91.3\\n               Huang & Harper (2009) [14]              semi-supervised              91.3\\n               McClosky et al. (2006) [26]             semi-supervised              92.1\\n            Vinyals & Kaiser el al. (2014) [37]        semi-supervised              92.1\\n                  Transformer (4 layers)               semi-supervised              92.7\\n                 Luong et al. (2015) [23]                  multi-task               93.0\\n                   Dyer et al. (2016) [8]                  generative               93.3\\nincreased the maximum output length to input length + 300. We used a beam size of 21 and α = 0.3\\nfor both WSJ only and the semi-supervised setting.\\nOur results in Table 4 show that despite the lack of task-specific tuning our model performs sur-\\nprisingly well, yielding better results than all previously reported models with the exception of the\\nRecurrent Neural Network Grammar [8].\\nIn contrast to RNN sequence-to-sequence models [37], the Transformer outperforms the Berkeley-\\nParser [29] even when training only on the WSJ training set of 40K sentences.\\n7    Conclusion\\nIn this work, we presented the Transformer, the first sequence transduction model based entirely on\\nattention, replacing the recurrent layers most commonly used in encoder-decoder architectures with\\nmulti-headed self-attention.\\nFor translation tasks, the Transformer can be trained significantly faster than architectures based\\non recurrent or convolutional layers.'"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Take a look at one of the source nodes from the response\n",
+    "response_1.source_nodes[0].get_content()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "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"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

examples/demo_basic.ipynb

@@ -13,12 +13,12 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!pip install llama-index llama-parse"
+    "%pip install llama-index llama-parse"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -45,7 +45,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -55,12 +55,13 @@
     "nest_asyncio.apply()\n",
     "\n",
     "import os\n",
+    "\n",
     "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\""
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -79,7 +80,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -107,7 +108,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -126,7 +127,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -157,18 +158,11 @@
    "source": [
     "print(documents[0].text[20000:21000] + \"...\")"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "llama-parse-aNC435Vv-py3.11",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -181,11 +175,9 @@
    "mimetype": "text/x-python",
    "name": "python",
    "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.11.5"
-  },
-  "orig_nbformat": 4
+   "pygments_lexer": "ipython3"
+  }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }

examples/demo_insurance.ipynb

@@ -0,0 +1,531 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# LlamaParse - Fast checking Insurance Contract for Coverage\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_insurance.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "In this notebook we will look at how LlamaParse can be used to extract structured coverage information from an insurance policy."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Installation of required packages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index llama-parse"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Download an insurance policy fron IRDAI\n",
+    "\n",
+    "The Insurance Regulatory and Development Authority of India (IRDAI) maintains a great resource: https://policyholder.gov.in/web/guest/non-life-insurance-products where all insurance policies available in India are publicly available for download! Let's download a complex health insurance policy as an example."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget \"https://policyholder.gov.in/documents/37343/931203/NBHTGBP22011V012223.pdf/c392bcc1-f6a8-cadd-ab84-495b3273d2c3?version=1.0&t=1669350459879&download=true\" -O \"./policy.pdf\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Initializing LlamaIndex and LlamaParse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the sync code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\"\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"sk-...\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.llms.openai import OpenAI\n",
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.core import VectorStoreIndex\n",
+    "from llama_index.core import Settings\n",
+    "\n",
+    "# for the purpose of this example, we will use the small model embedding and gpt3.5\n",
+    "embed_model = OpenAIEmbedding(model=\"text-embedding-3-small\")\n",
+    "llm = OpenAI(model=\"gpt-3.5-turbo-0125\")\n",
+    "\n",
+    "Settings.llm = llm"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Vanilla Approach - Parse the Policy with LlamaParse into Markdown"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id b8946573-c911-4e00-8921-1bad1cda3d64\n",
+      "......"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "documents = LlamaParse(result_type=\"markdown\").load_data(\"./policy.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "## Preamble\n",
+      "\n",
+      "This ‘Travel Infinity’ Policy is a contract of insurance between You and Us which is subject to payment of full premium in advance and the terms, conditions and exclusions of this Policy. Expense incurred outside the policy period will NOT be covered. Unutilized Sum Insured will expire at the end of the policy year. All applicable benefits, details and limits are mentioned in your Certificate of insurance. We will cover only allopathic treatments in this policy.\n",
+      "\n",
+      "## Defined Terms\n",
+      "\n",
+      "The terms listed below in this Section and used elsewhere in the Policy in Initial Capitals shall have the meaning set out against them in this Section.\n",
+      "\n",
+      "### Standard Definitions\n",
+      "\n",
+      "|2.1|Accident or Accidental|means sudden, unforeseen and involuntary event caused by external, visible and violent means.|\n",
+      "|---|---|---|\n",
+      "|2.2|Co-payment|means a cost sharing requirement under a health insurance policy that provides that the policyholder/insured will bear a specified percentage of the admissible claims a\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(documents[0].text[0:1000])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Markdown Element Node Parser\n",
+    "Our markdown element node parser works well for parsing the markdown output of LlamaParse into a set of table and text nodes."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core.node_parser import MarkdownElementNodeParser\n",
+    "\n",
+    "node_parser = MarkdownElementNodeParser(\n",
+    "    llm=OpenAI(model=\"gpt-3.5-turbo-0125\"), num_workers=8\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "nodes = node_parser.get_nodes_from_documents(documents)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "base_nodes, objects = node_parser.get_nodes_and_objects(nodes)\n",
+    "\n",
+    "recursive_index = VectorStoreIndex(nodes=base_nodes + objects)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = recursive_index.as_query_engine(similarity_top_k=25)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Querying the model for coverage"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "You are covered for the expenses incurred on any alternate travel booking under any mode of transport, up to the limit of the Sum Insured as mentioned in the Certificate of insurance, if the delay of the airlines was caused due to specific reasons outlined in the policy. The amount you are covered for will depend on the specific terms and conditions of your policy, including the maximum coverage limit specified in the Certificate of insurance.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query_1 = \"My trip was delay and I paid 45, how much am I cover for?\"\n",
+    "\n",
+    "response_1 = query_engine.query(query_1)\n",
+    "print(str(response_1))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The information is split across the document which leads to retrieval issues. Let's try some parsing instructions to improve our result."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id ec9e77c9-6ad9-4c9b-9efb-c9f659b0d481\n",
+      "....."
+     ]
+    }
+   ],
+   "source": [
+    "documents_with_instruction = LlamaParse(\n",
+    "    result_type=\"markdown\",\n",
+    "    parsing_instruction=\"\"\"\n",
+    "This document is an insurance policy.\n",
+    "When a benefits/coverage/exlusion is describe in the document ammend to it add a text in the follwing benefits string format (where coverage could be an exclusion).\n",
+    "\n",
+    "For {nameofrisk} and in this condition {whenDoesThecoverageApply} the coverage is {coverageDescription}. \n",
+    "                                        \n",
+    "If the document contain a benefits TABLE that describe coverage amounts, do not ouput it as a table, but instead as a list of benefits string.\n",
+    "                                       \n",
+    "\"\"\",\n",
+    ").load_data(\"./policy.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let see how the 2 parsing compare (change target page to explore)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "## Inpatient treatment\n",
+      "\n",
+      "Claim Form (filled and signed by pe Insured)\n",
+      "Hospital Daily Cash\n",
+      "Release of Medical information Form (filled and signed by pe Insured)\n",
+      "Waiver of Deductible\n",
+      "Original papological and diagnostic reports, discharge summary indoor case papers (if any) and prescriptions issued by pe treating Medical practitioner or Network Provider\n",
+      "Optional Co-payment\n",
+      "Adventure Sports Cover\n",
+      "Home to Home Cover\n",
+      "Passport and Visa copy wip Entry Stamp of Country of Visit and exit Stamp from India\n",
+      "Extension to in-patient care\n",
+      "Ambulance Charge\n",
+      "FIR report of police (if applicable)\n",
+      "\n",
+      "## Out-patient treatment\n",
+      "\n",
+      "Cancer Screening & Mammographic Examination\n",
+      "Original bills and receipts for:\n",
+      "1. Charges paid towards Hospital accommodation, nursing facilities, and oper medical services rendered\n",
+      "2. Fees paid to pe Medical Practitioner and for special nursing charges\n",
+      "3. Charges incurred towards any and all test and / or examinations rendered in connection wip pe treatment\n",
+      "4. Charges incurred towards medicines or drugs purchased from a registered pharmacy oper pan pe Network provider duly supported by pe prescriptions of pe Medical Practitioner attending to pe Insured Person\n",
+      "5. Any oper document as required by pe Company to assist pe Claim\n",
+      "\n",
+      "## Medical evacuation\n",
+      "\n",
+      "Medical reports and transportation details issued by the evacuation agency, prescriptions and medical report by the attending Medical Practitioner furnishing the name of the Insured Person and details of treatment rendered along with the statement confirming the necessity of evacuation.\n",
+      "\n",
+      "Documentary proof for expenses incurred towards the Medical Evacuation.\n",
+      "\n",
+      "## Compassionate visit\n",
+      "\n",
+      "A certificate from the Medical Practitioner recommending the presence in the form of special assistance to be rendered by an additional member during the entire period of hospitalization. The certificate shall also specify the minimum period in which person is admitted in the hospital.\n",
+      "\n",
+      "Discharge summary of the Hospital furnishing details including the date of admission and date of discharge.\n",
+      "\n",
+      "Stamped boarding pass with invoice used for the travel by the Immediate Family Member.\n",
+      "\n",
+      "Copy passport of Immediate Family Member with entry and exit stamp.\n",
+      "\n",
+      "## Escort of Minor Child\n",
+      "\n",
+      "A certificate from the Medical Practitioner specifying the minimum period of Hospitalization.\n",
+      "\n",
+      "Discharge summary of the Hospital furnishing details including the date of admission and date of discharge.\n",
+      "\n",
+      "Stamped Boarding pass used for the return travel of the child to the Country of Residence.\n",
+      "\n",
+      "Stamped Boarding pass of the attendant from the Country of Residence to the place of hospitalization (if attendant is necessary).\n",
+      "\n",
+      "Copy of passport of the child with entry and exit stamp.\n",
+      "\n",
+      "## Upgradation to Business Class\n",
+      "\n",
+      "A certificate from the Medical Practitioner specifying the minimum period of Hospitalization.\n",
+      "\n",
+      "Discharge summary of the Hospital furnishing the details including the date of admission and date of discharge.\n",
+      "\n",
+      "Product Name: Travel infinity | Product UIN: NBHTGBP22011V012223\n",
+      "\n",
+      "\n",
+      "=========================================================\n",
+      "\n",
+      "\n",
+      "# Insurance Policy\n",
+      "\n",
+      "## Benefits:\n",
+      "\n",
+      "- For Inpatient treatment and in this condition when admitted to a hospital, the coverage is reimbursement for medical expenses incurred.\n",
+      "- For Hospital Daily Cash and in this condition when hospitalized, the coverage is daily cash benefit.\n",
+      "- For Waiver of Deductible and in this condition when a deductible is applicable, the coverage is waiver of the deductible amount.\n",
+      "- For Optional Co-payment and in this condition when a co-payment is required, the coverage is optional co-payment.\n",
+      "- For Adventure Sports Cover and in this condition when participating in adventure sports, the coverage is coverage for injuries related to adventure sports.\n",
+      "- For Home to Home Cover and in this condition when requiring medical evacuation, the coverage is assistance for repatriation to home country.\n",
+      "- For Extension to in-patient care and in this condition when extended hospital stay is necessary, the coverage is extension of coverage for in-patient care.\n",
+      "- For Ambulance Charge and in this condition when ambulance services are utilized, the coverage is reimbursement for ambulance charges.\n",
+      "- For Out-patient treatment and in this condition when receiving outpatient medical care, the coverage is reimbursement for outpatient medical expenses.\n",
+      "- For Cancer Screening & Mammographic Examination and in this condition when undergoing cancer screening or mammographic examination, the coverage is coverage for these preventive services.\n",
+      "- For New Born baby Cover and in this condition when a newborn is covered under the policy, the coverage is medical expenses coverage for the newborn.\n",
+      "- For Maternity and in this condition when maternity services are required, the coverage is coverage for maternity expenses.\n",
+      "- For Complete pre-existing disease cover and in this condition when seeking treatment for pre-existing conditions, the coverage is coverage for pre-existing conditions.\n",
+      "- For Medical sum insured replenishment in case of hospitalization due to accident and in this condition when hospitalized due to an accident, the coverage is replenishment of the sum insured.\n",
+      "- For Waiver of sublimit for insured above 60 years of age and in this condition when the insured is above 60 years of age, the coverage is waiver of sublimits.\n",
+      "- For Psychiatric Counseling and in this condition when seeking psychiatric counseling, the coverage is coverage for psychiatric counseling services.\n",
+      "- For Physiotherapy and in this condition when undergoing physiotherapy, the coverage is coverage for physiotherapy sessions.\n",
+      "- For Terrorism cover and in this condition when affected by terrorism, the coverage is coverage for medical expenses related to terrorism incidents.\n",
+      "- For Medical tele-consultation and in this condition when consulting a medical practitioner remotely, the coverage is coverage for tele-consultation services.\n",
+      "- For Medical evacuation and in this condition when requiring medical evacuation, the coverage is coverage for medical evacuation services.\n",
+      "- For Compassionate visit and in this condition when requiring a compassionate visit, the coverage is coverage for travel expenses for a family member to visit.\n",
+      "- For Escort of Minor Child and in this condition when escorting a minor child for medical treatment, the coverage is coverage for escort services for the child.\n",
+      "- For Upgradation to Business Class and in this condition when requiring upgradation to business class for medical travel, the coverage is coverage for upgradation to business class.\n"
+     ]
+    }
+   ],
+   "source": [
+    "target_page = 45\n",
+    "pages_vanilla = documents[0].text.split(\"\\n---\\n\")\n",
+    "pages_with_instructions = documents_with_instruction[0].text.split(\"\\n---\\n\")\n",
+    "\n",
+    "print(pages_vanilla[target_page])\n",
+    "print(\"\\n\\n=========================================================\\n\\n\")\n",
+    "print(pages_with_instructions[target_page])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "node_parser_instruction = MarkdownElementNodeParser(\n",
+    "    llm=OpenAI(model=\"gpt-3.5-turbo-0125\"), num_workers=8\n",
+    ")\n",
+    "nodes_instruction = node_parser.get_nodes_from_documents(documents_with_instruction)\n",
+    "(\n",
+    "    base_nodes_instruction,\n",
+    "    objects_instruction,\n",
+    ") = node_parser_instruction.get_nodes_and_objects(nodes_instruction)\n",
+    "\n",
+    "recursive_index_instruction = VectorStoreIndex(\n",
+    "    nodes=base_nodes_instruction + objects_instruction\n",
+    ")\n",
+    "query_engine_instruction = recursive_index_instruction.as_query_engine(\n",
+    "    similarity_top_k=25\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Comparing Instruction-Augmented Parsing vs. Vanilla Parsing\n",
+    "\n",
+    "When we parse the document with natural language instructions to add context on insurance coverage, we are able to correctly answer a wide range of queries in our RAG pipeline. In contrast, a RAG pipeline built with the vanilla method is not able to answer these queries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Vanilla:\n",
+      "You are covered for the amount you paid due to the trip delay, up to the limit specified in the certificate of insurance.\n",
+      "With instructions:\n",
+      "For Trip Delay coverage, you are covered for a fixed benefit amount as mentioned in the certificate of insurance for every block of hours of delay.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query_1 = \"My trip was delayed and I paid 45, how much am I covered for?\"\n",
+    "\n",
+    "response_1 = query_engine.query(query_1)\n",
+    "print(\"Vanilla:\")\n",
+    "print(response_1)\n",
+    "\n",
+    "print(\"With instructions:\")\n",
+    "response_1_i = query_engine_instruction.query(query_1)\n",
+    "print(response_1_i)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Looking at the policy it says in list I that one expense not covered is Baby food"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Vanilla:\n",
+      "Baby food is not explicitly mentioned in the provided context information regarding insurance coverages and benefits.\n",
+      "With instructions:\n",
+      "Baby food is excluded from coverage according to the policy terms.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query_2 = \"I just had a baby, is baby food covered?\"\n",
+    "\n",
+    "response_2 = query_engine.query(query_2)\n",
+    "print(\"Vanilla:\")\n",
+    "print(response_2)\n",
+    "\n",
+    "print(\"With instructions:\")\n",
+    "response_2_i = query_engine_instruction.query(query_2)\n",
+    "print(response_2_i)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Vanilla:\n",
+      "Gauze used in your operation would typically be covered under the \"Emergency In-patient Medical Treatment\" or \"Emergency In-patient Medical Treatment with OPD\" benefits of the policy.\n",
+      "With instructions:\n",
+      "Gauze is not covered for use in your operation as it falls under the category of items that are excluded from coverage in the insurance policy.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query_3 = \"How is gauze used in my operation covered?\"\n",
+    "\n",
+    "response_3 = query_engine.query(query_3)\n",
+    "print(\"Vanilla:\")\n",
+    "print(response_3)\n",
+    "\n",
+    "print(\"With instructions:\")\n",
+    "response_3_i = query_engine_instruction.query(query_3)\n",
+    "print(response_3_i)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

examples/demo_json.ipynb

@@ -0,0 +1,363 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d27f1082-cd10-405e-9570-6f0e934bba8b",
+   "metadata": {},
+   "source": [
+    "# LlamaParse JSON Mode + Multimodal RAG\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_json.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "This notebook shows you how to use LlamaParse JSON mode with LlamaIndex to build a simple multimodal RAG pipeline.\n",
+    "\n",
+    "Using JSON mode gives you back a list of json dictionaries, which contains both text and images. You can then download these images and use a multimodal model to extract information and index them."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a004db48-8d3f-421c-915a-477692f71b90",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "Define imports, env variables, global LLM/embedding models."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bc6a7a4b-b568-4db5-bcba-62f5c517ff3a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install llama-index\n",
+    "!pip install llama-index-core\n",
+    "!pip install llama-index-llms-anthropic llama-index-multi-modal-llms-anthropic\n",
+    "!pip install llama-index-embeddings-huggingface\n",
+    "!pip install llama-parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0879301c-ff91-4431-941a-6c0ef7cd8fe2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the async code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "import os\n",
+    "\n",
+    "# API access to llama-cloud\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-\"\n",
+    "\n",
+    "# Using Anthropic API for embeddings/LLMs\n",
+    "os.environ[\"ANTHROPIC_API_KEY\"] = \"sk-\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "391e2d95-5569-4d73-9f16-5b59d7326f8d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.llms.anthropic import Anthropic\n",
+    "\n",
+    "llm = Anthropic(model=\"claude-3-opus-20240229\", temperature=0.0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "700f48e8-8b52-41f3-90f9-144d5fdd5c52",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import Settings\n",
+    "\n",
+    "Settings.llm = llm\n",
+    "Settings.embed_model = \"local:BAAI/bge-small-en-v1.5\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b411d2ee-3e6b-45b0-b532-4a8e3abcdea0",
+   "metadata": {},
+   "source": [
+    "## Load Data\n",
+    "\n",
+    "Let's load in the Uber 10Q report."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c39d408f-e885-4940-85c7-b09ca3bc7cb7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget 'https://raw.githubusercontent.com/run-llama/llama_index/main/docs/docs/examples/data/10q/uber_10q_march_2022.pdf' -O './uber_10q_march_2022.pdf'"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2f42af8-afb3-4b3b-82d3-6b332fb38aa4",
+   "metadata": {},
+   "source": [
+    "## Using LlamaParse in JSON Mode for PDF Reading\n",
+    "\n",
+    "We show you how to run LlamaParse in JSON mode for PDF reading."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9c9cd670-8229-4ad6-99a9-845bd82b7ec1",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id cf5a4f51-1af8-47f7-9b3d-80a905d06b89\n"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "parser = LlamaParse(verbose=True)\n",
+    "json_objs = parser.get_json_result(\"./uber_10q_march_2022.pdf\")\n",
+    "json_list = json_objs[0][\"pages\"]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b26d21d1-05b5-4f49-b937-c13106a84015",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core.schema import TextNode\n",
+    "from typing import List\n",
+    "\n",
+    "\n",
+    "def get_text_nodes(json_list: List[dict]):\n",
+    "    text_nodes = []\n",
+    "    for idx, page in enumerate(json_list):\n",
+    "        text_node = TextNode(text=page[\"text\"], metadata={\"page\": page[\"page\"]})\n",
+    "        text_nodes.append(text_node)\n",
+    "    return text_nodes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "364a3276-d2db-4aee-9bc6-617ffd726d25",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "text_nodes = get_text_nodes(json_list)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2fe2e911-0393-42e8-a233-65639cdbebc4",
+   "metadata": {},
+   "source": [
+    "## Extract/Index images from image dicts\n",
+    "\n",
+    "Here we use a multimodal model to extract and index images from image dictionaries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "36012145-5521-4ddb-a53e-df9ebd1ca8dd",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "mkdir: llama2_images: File exists\n"
+     ]
+    }
+   ],
+   "source": [
+    "# call get_images on parser, convert to ImageDocuments\n",
+    "!mkdir llama2_images\n",
+    "\n",
+    "from llama_index.core.schema import ImageDocument\n",
+    "from llama_index.multi_modal_llms.anthropic import AnthropicMultiModal\n",
+    "\n",
+    "\n",
+    "def get_image_text_nodes(json_objs: List[dict]):\n",
+    "    \"\"\"Extract out text from images using a multimodal model.\"\"\"\n",
+    "    anthropic_mm_llm = AnthropicMultiModal(max_tokens=300)\n",
+    "    image_dicts = parser.get_images(json_objs, download_path=\"llama2_images\")\n",
+    "    image_documents = []\n",
+    "    img_text_nodes = []\n",
+    "    for image_dict in image_dicts:\n",
+    "        image_doc = ImageDocument(image_path=image_dict[\"path\"])\n",
+    "        response = anthropic_mm_llm.complete(\n",
+    "            prompt=\"Describe the images as alt text\",\n",
+    "            image_documents=[image_doc],\n",
+    "        )\n",
+    "        text_node = TextNode(text=str(response), metadata={\"path\": image_dict[\"path\"]})\n",
+    "        img_text_nodes.append(text_node)\n",
+    "    return img_text_nodes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "38f25045-6102-4920-9cd0-42b0ae6c872f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "image_text_nodes = get_image_text_nodes(json_objs)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4683c97a-da06-408a-9fe9-7e3c0aceb77d",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'The image shows a bar graph titled \"Monthly Active Platform Consumers (in millions)\". The graph displays data from Q2 2020 to Q1 2022 over 8 quarters. The number of monthly active platform consumers starts at 55 million in Q2 2020 and steadily increases each quarter, reaching 115 million by Q1 2022. The graph illustrates consistent quarter-over-quarter growth in this metric over the nearly 2 year time period shown.'"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "image_text_nodes[0].get_content()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3cfdf6db-381c-4e53-a0fb-e7670f75e0d5",
+   "metadata": {},
+   "source": [
+    "## Build Index across image and text nodes\n",
+    "\n",
+    "Here we build a vector index across both text nodes and text nodes extracted from images."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "939aec6c-064a-4319-b2dc-70cc4a304c06",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import VectorStoreIndex\n",
+    "\n",
+    "index = VectorStoreIndex(text_nodes + image_text_nodes)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "529340d5-9319-4cdf-8ee1-bbd01ed00226",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = index.as_query_engine()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "81d7ff30-5a87-44da-880d-4b1f41434d90",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The bar graph titled \"Monthly Active Platform Consumers (in millions)\" shows the number of monthly active consumers on Uber's platform over a period of 8 quarters from Q2 2020 to Q1 2022. \n",
+      "\n",
+      "The graph indicates steady quarter-over-quarter growth in this metric, starting at 55 million monthly active platform consumers in Q2 2020 and increasing each quarter to reach 115 million by Q1 2022. This represents consistent growth in Uber's user base on their platform over the nearly 2 year period shown in the graph.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# ask question over image!\n",
+    "response = query_engine.query(\n",
+    "    \"What does the bar graph titled 'Monthly Active Platform Consumers' show?\"\n",
+    ")\n",
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c4f14ad8-6bfd-49d9-b3d5-7215cf0e4ac1",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Based on the context provided, some of the main risk factors for Uber include:\n",
+      "\n",
+      "- A significant percentage of Uber's bookings come from large metropolitan areas, which could be negatively impacted by various economic, social, weather, regulatory and other conditions, including COVID-19.\n",
+      "\n",
+      "- Uber may fail to successfully offer autonomous vehicle technologies on its platform or these technologies may not perform as expected. \n",
+      "\n",
+      "- Retaining and attracting high-quality personnel is important for Uber's business and continued attrition could adversely impact the company.\n",
+      "\n",
+      "- Security breaches, data privacy issues, cyberattacks and unauthorized access to Uber's proprietary data and systems pose risks.\n",
+      "\n",
+      "- Uber is subject to climate change risks, both physical and transitional, that could adversely impact its business if not managed properly. \n",
+      "\n",
+      "- Uber relies on third parties for open marketplaces to distribute its platform and software, and interference from these third parties could harm its business.\n",
+      "\n",
+      "- Uber will require additional capital to support its growth and this capital may not be available on reasonable terms.\n",
+      "\n",
+      "- Acquisitions and integrations carry risks if Uber is unable to successfully identify and integrate suitable businesses.\n",
+      "\n",
+      "- Extensive government regulations around payments, financial services, data privacy and other areas pose compliance risks and challenges for Uber's business model in certain jurisdictions.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# ask question over text!\n",
+    "response = query_engine.query(\"What are the main risk factors for Uber?\")\n",
+    "print(str(response))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama-parse-aNC435Vv-py3.10",
+   "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"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/demo_languages.ipynb

@@ -0,0 +1,444 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "28d15ea5-a3eb-4ee5-9d91-8dbd95e53129",
+   "metadata": {},
+   "source": [
+    "# Multi-Language Support in LlamaParse\n",
+    "\n",
+    "LlamaParse supports users to specify a `language` parameter before uploading documents, giving users better OCR capabilities over non-English PDFs, parsing images into more accurate representations.\n",
+    "\n",
+    "You can specify 80+ different languages: see this file for a full list of supported languages: https://github.com/run-llama/llama_parse/blob/main/llama_parse/base.py.\n",
+    "\n",
+    "This notebook shows a demo of this in action. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "15539193-2f5c-4ecf-9ca4-9aee6f888468",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index llama-parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "87322210-c21c-43d6-b459-2e8a828ac576",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the sync code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "import os\n",
+    "\n",
+    "# os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2b5cabdf-342a-42d2-8ad4-0ba7c46cdfb9",
+   "metadata": {},
+   "source": [
+    "## Load in a French PDF\n",
+    "\n",
+    "We load in the 2022 annual report from Agence France Tresor."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e81e0a08-3a99-42e6-adcc-00bb4ce1c3d4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget \"https://www.dropbox.com/scl/fi/fxg17log5ydwoflhxmgrb/treasury_report.pdf?rlkey=mdintk0o2uuzkple26vc4v6fd&dl=1\" -O treasury_report.pdf"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ecfc578c-3c7f-4ec1-aa06-51565c28632b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 476966e1-9e04-49e7-a5dc-952b053b8b94\n",
+      "......"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "parser = LlamaParse(result_type=\"text\", language=\"fr\")\n",
+    "documents = parser.load_data(\"./treasury_report.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0c37db27-3496-4a59-918b-701c9ad7706d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      " ET GESTION DE LA DETTE DE L’ÉTAT\n",
+      "             P.56      FOCUS OAT VERTES\n",
+      "             P.60      CONTRÔLE DES RISQUES & POST-MARCHÉ\n",
+      "         Chiffres de l’exercice 2022                                                    P.64 À 105\n",
+      "             P.65      ACTIVITÉ DE L’AFT\n",
+      "             P.84      RAPPORT STATISTIQUE\n",
+      "         FICHES TECHNIQUES                   GLOSSAIRES                LISTE DES ABRÉVIATIONS\n",
+      "             P.106                                P.118                    P.122\n",
+      "                                                              AGENCE FRANCE TRÉSOR - RAPPORT D’ACTIVITÉ 2022      3\n",
+      "---\n",
+      "                                    Édito\n",
+      "                                                   111        Avec une croissance\n",
+      "                                                       de +2,5 %, la France a illustré\n",
+      "                                                      une nouvelle fois sa résilience\n",
+      "                                                       économique face aux chocs.\n",
+      "4  AGENCE FRANCE TRÉSOR - RAPPORT D’ACTIVITÉ 2022\n",
+      "---\n",
+      "               L’économie française en 2022 :\n",
+      " résilience face aux chocs géopolitiques\n",
+      "                                       et économiques\n",
+      "                                             sa résilience économique face aux           lors du dernier trimestre de 2022.\n",
+      "LE DÉBUT DE                                  chocs. Cette croissance a été permise       Malgré un climat des affaires impacté\n",
+      "L’ANNÉE 2022                                 grâce à une forte demande intérieure        par l’inflation, le soutien apporté\n",
+      "                                             alimentée    par   le dynamisme       de    aux TPE/PME leur a permis de faire\n",
+      "SEMBLAIT                                     l’investissement     et,  en  dépit   de    face aux défis énergétiques tout en\n",
+      "                                             l’inflation,  d’une   résilience   de  la   préservant l’emploi.\n",
+      "ENGAGÉ DANS                                  consommation des ménages sur une\n",
+      "                                             grande partie de l’année.                   Afin de combattre l’inflation qui a\n",
+      "UNE DYNAMIQUE                                                                            largement dépassé la cible de 2 %,\n",
+      "                                             Le  taux  d’inflation    des  prix  à  la   la BCE, de concert avec les banques\n",
+      "EFFICACE DE                                  consommation français est resté l’un        centrales des principales économies\n",
+      "SORTIE DE CRISE                              des plus bas d’Europe avec +6,0 %           développées, a adapté sa fonction de\n",
+      "                                             en 2022, s’appuyant, d’une part, sur        réaction en mettant fin aux politiques\n",
+      "PORTÉE PAR                                   l’atout structurel que représente un        d’assouplissement monétaire qu’elle\n",
+      "                                             mix énergétique parmi les moins             menait depuis la crise financière de\n",
+      "UNE REPRISE                                  exposés à la Russie et, d’autre part,       2008. Ainsi, dès juillet 2022, et pour\n",
+      "                                             sur  les politiques    proactives     du    la première fois en 10 ans, la BCE a\n",
+      "ÉCONOMIQUE                                   gouvernement avec la mise en place          augmenté ses taux directeurs. Les\n",
+      "                                             du bouclier tarifaire, de la remise         taux d’emprunts de l’État à 10 ans se\n",
+      "INÉDITE                                      carburant et du chèque énergie.             sont ainsi progressivement éloignés\n",
+      "AMORCÉE                                      Ces  dispositifs,   temporaires,     ont    de   leur  territoire    négatif   pour\n",
+      "                                             été progressivement supprimés : la          atteindre 3,10 % en fin d’année.\n",
+      "EN 2021.                                     remise carburant, d’abord prolongée\n",
+      "                                             jusqu’à   mi-novembre        a pris   fin   Cette    décision    s’est  également\n",
+      "Le déclenchement de la guerre en             en décembre 2022, tandis que le             accompagnée           de   la   fin   du\n",
+      "Ukraine par la Russie dès février a          chèque énergie exceptionnel a pris          programme d’achat d’urgence (PEPP)\n",
+      "rebattu les cartes de cet équilibre,         fin en mars 2023.                           mis en place pendant la pandémie,\n",
+      "provoquant des bouleversements                                                           suivi de la réduction progressive de\n",
+      "majeurs sur les plans géopolitiques et       Le marché du travail français a par         son bilan, à un rythme mensuel de 15\n",
+      "économiques, avec le déploiement             ailleurs montré toute sa robustesse,        milliards d’euros par mois.\n",
+      "de sanctions à l’encontre de la Russie       la dynamique de reprise initiée en\n",
+      "et une forte poussée inflationniste.         2021 ainsi que l’effet des réformes         L’Agence France Trésor a fait face à ce\n",
+      "Face à cette situation, les principales      structurelles engagées les années           contexte de grands bouleversements\n",
+      "banques centrales mondiales, dont            précédentes     permettant      au  taux    géopolitiques,      économiques        et\n",
+      "la  Banque     centrale    européenne        d’emploi des Français âgés de 15 à 64       financiers   en   s’appuyant     sur  ses\n",
+      "(BCE), ont engagé une politique de           ans d’atteindre fin 2022 un niveau          principes de régularité, de prévisibilité\n",
+      "normalisation      monétaire      rapide     de 68,1 %, un record depuis 1975.           et de transparence. Cette stratégie\n",
+      "pour    lutter   contre     l’inflation.     La reprise économique de début              s’est de nouveau révélée robuste et,\n",
+      "Parallèlement,      le gouvernement          d’année et les effets positifs du plan      alliée à l’engagement et à l’efficacité\n",
+      "français a mis en place des mesures          France Relance ont permis la création       de ses équipes, ainsi qu’à la qualité\n",
+      "(à hauteur de 43,6 milliards d’euros         de 337 100 emplois, essentiellement         de crédit de la signature de la France,\n",
+      "sur l’année 2022) pour protéger les          dans le secteur salarié marchand. Ce        lui a permis d’accomplir sa mission\n",
+      "entreprises et les ménages.                  dynamisme a aussi conduit à la chute        de financement de l’action publique\n",
+      "                                             du taux de chômage, atteignant son          au bénéfice de tous.\n",
+      "Avec une croissance de +2,5 %, la            niveau le plus bas depuis mars 2008\n",
+      "France a illustré une nouvelle fois          avec 7,2 % de demandeurs d’emploi\n",
+      "                                                                                         Emmanuel Moulin\n",
+      "                                                                                         DIRECTEUR GÉNÉRAL DU TRÉSOR\n",
+      "                                                                                         ET PRÉSIDENT DE L’AFT\n",
+      "                                                            AGENCE FRANCE TRÉSOR - RAPPORT D’ACTIVITÉ 2022                     5\n",
+      "---\n",
+      "   du directeur général                     Le mot\n",
+      "                                                        011  En 2022, le choc d’inflation\n",
+      "                                                                    et la normalisation\n",
+      "                                                               de la politique monétaire\n",
+      "                                                              ont mis fin à une décennie\n",
+      "                                                             de taux historiquement bas.\n",
+      "6       AGENCE FRANCE TRÉSOR - RAPPORT D’ACTIVITÉ 2022\n",
+      "---\n",
+      "  MALGRÉ UN CONTEXTE DE MARCHÉ MOUVEMENTÉ ET LES MESURES D’AMPLEUR\n",
+      "               PRISES POUR LIMITER L’IMPACT DE L’INFLATION SUR LES MÉNAGES ET\n",
+      "  LES ENTREPRISES, LE PROGRAMME DE FINANCEMENT À MOYEN ET LONG TERME\n",
+      "        EST DEMEURÉ INCHANGÉ À 260 MILLIARDS D’EUROS, STABLE PAR RAPPORT\n",
+      "  À 2021, ET LA DETTE DE COURT TERME A ÉTÉ RÉDUITE DE 7 MILLIARDS D’EUROS.\n",
+      "En janvier 2022, la normalisation de                                 d’obligations indexées sur l’inflation,                               la dette de court terme a été réduite\n",
+      "la politique monétaire en zone euro                                  sur      lequel         a    été      enregistré             un       de    7   milliards         d’euros.        En    effet,      le\n",
+      "était      une      perspective              de     moyen            supplément d’indexation supérieur                                     dynamisme des recettes fiscales et\n",
+      "terme. Quelques semaines plus tard,                                  de     17    milliards        d’euros         à   celui      de       la   trésorerie          levée      lors     de    la   crise\n",
+      "l’invasion de l’Ukraine par la Russie                                l’année          2021.       Il   s’est      également                sanit\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(documents[0].get_content()[1000:10000])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "be161577-7b1e-4710-b721-f549feb8e6d0",
+   "metadata": {},
+   "source": [
+    "## Download Chinese PDF"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ac332ea3-cfff-4216-b292-62410a26c336",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "--2024-02-28 16:41:26--  https://www.dropbox.com/scl/fi/g5ojyzk4m44hl7neut6vc/chinese_pdf.pdf?rlkey=45reu51kjvdvic6zucr8v9sh3&dl=1\n",
+      "Resolving www.dropbox.com (www.dropbox.com)... 162.125.13.18\n",
+      "Connecting to www.dropbox.com (www.dropbox.com)|162.125.13.18|:443... connected.\n",
+      "HTTP request sent, awaiting response... 302 Found\n",
+      "Location: https://uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com/cd/0/inline/COJ69Wg2e7wH9S0ELzl4j4znoonRSQS-JJrH6mxy_vcrvY-KV7f10kMyQH6IYmtfMh_9xcDNOYnLkWkwMTYItwE1XQB5nqXbjmLJ4jLbDrMeu7-b49m796ctxevwnp7k1_U/file?dl=1# [following]\n",
+      "--2024-02-28 16:41:27--  https://uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com/cd/0/inline/COJ69Wg2e7wH9S0ELzl4j4znoonRSQS-JJrH6mxy_vcrvY-KV7f10kMyQH6IYmtfMh_9xcDNOYnLkWkwMTYItwE1XQB5nqXbjmLJ4jLbDrMeu7-b49m796ctxevwnp7k1_U/file?dl=1\n",
+      "Resolving uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com (uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com)... 162.125.13.15\n",
+      "Connecting to uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com (uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com)|162.125.13.15|:443... connected.\n",
+      "HTTP request sent, awaiting response... 302 Found\n",
+      "Location: /cd/0/inline2/COKEp-d6ZqzrIIaPRlanov72wwnd7GX5eNSPnsxug0A8pOpek8hO6eFxp84cY3_NMBRsAqtX-IIVPpcfYHNoV__mpu1SsOV8wV8a68DwVKaVJRJriY_KV8lEFocvLgf7c7mhrREbIJ1UBN2fx6S_qWegwVIen1z1-pw-K7icMnA3EKJNqM9DFtqx9ct0FI4vdYGsv8ckLF26WgAhs96k1cHn-VRJle4SKstdYs8EmBxiuFLXZRCL3gljwAsLu3J6WRvis9v7VJ2zNhgrcT-ZnVujlpQGoGWLLPmREKffK608Xfz1XE35DzO28e_mm4SUPRfsP2mvIUrJUtUrhobR4siqQRGojxi0S7-da4Y7fpB4Tw/file?dl=1 [following]\n",
+      "--2024-02-28 16:41:27--  https://uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com/cd/0/inline2/COKEp-d6ZqzrIIaPRlanov72wwnd7GX5eNSPnsxug0A8pOpek8hO6eFxp84cY3_NMBRsAqtX-IIVPpcfYHNoV__mpu1SsOV8wV8a68DwVKaVJRJriY_KV8lEFocvLgf7c7mhrREbIJ1UBN2fx6S_qWegwVIen1z1-pw-K7icMnA3EKJNqM9DFtqx9ct0FI4vdYGsv8ckLF26WgAhs96k1cHn-VRJle4SKstdYs8EmBxiuFLXZRCL3gljwAsLu3J6WRvis9v7VJ2zNhgrcT-ZnVujlpQGoGWLLPmREKffK608Xfz1XE35DzO28e_mm4SUPRfsP2mvIUrJUtUrhobR4siqQRGojxi0S7-da4Y7fpB4Tw/file?dl=1\n",
+      "Reusing existing connection to uc7a03fdb7d960dbedb23e9298ab.dl.dropboxusercontent.com:443.\n",
+      "HTTP request sent, awaiting response... 200 OK\n",
+      "Length: 8074860 (7.7M) [application/binary]\n",
+      "Saving to: ‘chinese_pdf.pdf’\n",
+      "\n",
+      "chinese_pdf.pdf     100%[===================>]   7.70M  37.9MB/s    in 0.2s    \n",
+      "\n",
+      "2024-02-28 16:41:28 (37.9 MB/s) - ‘chinese_pdf.pdf’ saved [8074860/8074860]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "!wget \"https://www.dropbox.com/scl/fi/g5ojyzk4m44hl7neut6vc/chinese_pdf.pdf?rlkey=45reu51kjvdvic6zucr8v9sh3&dl=1\" -O chinese_pdf.pdf"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "45235b17-08f0-48f1-92aa-06711225860b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 0089f0b6-29ee-4e94-a8bf-49a137666f15\n",
+      ".........."
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "parser = LlamaParse(result_type=\"text\", language=\"ch_sim\")\n",
+    "documents = parser.load_data(\"./chinese_pdf.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f0d546cc-6549-4cf5-8b37-0896f4e8d43d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "中国投资有限责任公司2022年度报告                        5\n",
+      "---\n",
+      "企业文化与核心价值观\n",
+      "使命                           核心价值观\n",
+      " 致力于实现国家外汇资金多元化投资，在可接受风险范围内  责任              合力\n",
+      " 实现股东权益最大化，以服务于国家经济发展和深化金融体\n",
+      " 制改革的需要                      忠于使命、勤勉尽责       立足大局、有效协同\n",
+      "                             是公司遵奉的核心价值取向    是实现公司可持续发展的关键\n",
+      " 愿景                          专业              进取\n",
+      " 成为受人尊重的国际一流主权财富基金           坚持良好的专业精神和职业操守  求知进取、追求卓越\n",
+      "                             是公司成功的基石        是公司成功和发展壮大的内驱力\n",
+      "---\n",
+      "01                           我们将一以贯之地践行全球发展倡议，充分维护投资东道国利益，\n",
+      "                             积极投身可持续投资，助力世界经济实现更高质量、更有韧性的发展。\n",
+      "   致  辞\n",
+      "   3     中国投资有限责任公司2022年度报告  中国投资有限责任公司2022年度报告               4\n",
+      "---\n",
+      "                           “行之力则知愈进，知之深则行愈达。”站在新的历史起点上，中投公司\n",
+      "                           将继续秉承精益求精、追求卓越的专业精神，与国内外合作伙伴一起深化\n",
+      "                           合作，共聚力量、共迎挑战、共享成果，开启打造世界一流主权财富基金\n",
+      "                           的新篇章，为助力全球经济发展作出新贡献！                                   #Ave彭纯\n",
+      "                                                                                      董事长\n",
+      "                                2022年，是中投公司成立十五周年。\n",
+      "董事长致辞                           自2007年成立以来，中投公司坚守长期机构投资者定位，坚持国际化、市场化、专业化、负责任原则，搭\n",
+      "                           建起符合大型国际投资机构特点的治理架构，形成了系统完备的投资管理体系，经受住了国际金融危机、世纪\n",
+      "                           疫情等多个历史罕见的风险与挑战。如今，公司对外投资业务覆盖国际市场主要资产类别以及全球110多个国家\n",
+      "                           和地区，培养了一支高素质专业化的投资管理人才队伍，搭建了互利共赢的投资合作“朋友圈”，长期投资收\n",
+      "                           益超越董事会制定的考核目标，为促进国家外汇资产保值增值、服务国内国际双循环作出了积极贡献，在推动\n",
+      "                           全球投资合作、助力世界经济增长中贡献了中投力量，书写了中国主权财富基金不平凡的创业发展史。\n",
+      "5      中国投资有限责任公司2022年度报告  中国投资有限责任公司2022年度报告                                              6\n",
+      "---\n",
+      "    2022年以来，全球地缘政治风险显著攀升，产业链供应链持续调整重构，美欧央行大幅加息，国际资本                           我们守正创新，坚决践行双碳与可持续发展理念。更加包容、更加普惠、更有韧性的发展是全球\n",
+      "市场剧烈震荡，MSCI全球股票指数、彭博全球债券指数一度自高点下跌超过22%、13%。面对风高浪急的国                      可持续发展的关键。我们积极履行负责任投资者理念，制定《关于践行双碳目标和可持续投资行动的意见》，\n",
+      "际环境和前所未有的巨大挑战，公司保持战略定力，发挥长期机构投资者优势，不断优化资产配置和投资策                          积极开展气候变化、能源转型等主题投资。我们发布《运营碳中和行动计划》，明确时间表和路线图，全力实\n",
+      "略，着力提升总组合韧性，加强重点领域风险防控，年度投资收益跑赢大市；截至2022年底，过去十年对外                        现节能减排目标。我们探索以绿色资源引领乡村发展的新方法，在四个定点帮扶县持续推进巩固脱贫成果与乡\n",
+      "投资年化净收益率按美元计算为6.43%，超出十年业绩目标26个基点；自成立以来累计年化国有资本增值率达                      村振兴的有效衔接，助力民生保障与产业扶持，积极履行企业社会责任。\n",
+      "到12.67%，圆满完成五年战略规划主要目标任务。                                                     面向未来，我们坚信，发展与合作是破解全球性问题的“钥匙”。中投公司将一以贯之地践行全球发展倡\n",
+      "    我们矢志不渝，积极打造世界一流主权财富基金。长期资本对于促进世界经济持续发展有着不                            议，秉持互利共赢理念，以资本为纽带，促进国际产业交流合作，推动世界互联互通；充分维护投资东道国利\n",
+      "可替代的作用。我们坚持国际化、市场化、专业化、负责任原则，快速恢复常态化对外交流交往，按照互利共                         益，与东道国共创价值、共享价值；积极投身可持续投资，推动被投企业履行社会责任，助力世界经济实现更\n",
+      "赢原则深化与国内外各类机构合作，持续为世界经济发展提供长期资本支持。我们积极创新对外投资方式，稳                         高质量、更有韧性的发展。\n",
+      "健运行多支新型双边基金，新设相关投资合作平台，深入推进中国市场价值创造，促进被投资公司拓展市场空\n",
+      "间，助推国际投资与产业合作高质量发展。                                                           经济全球化的潮流不可阻挡。我们呼吁各国携起手来，做多边主义的坚定维护者，打造更加开放有序的投\n",
+      "                                                                         资环境，便利资本和资源要素在全球顺畅流动。我们尊重各方的利益关切，在开放中捕捉投资机遇，以务实合\n",
+      "    我们直面挑战，着力加强自主投资能力建设。面对持续动荡的国际金融市场，我们锚定配置方                            作应对共同挑战，并肩前进分享发展红利，推动世界经济平稳运行和持续增长。\n",
+      "向，强化研究驱动，有序实施组合调整、策略优化，及时调整公开市场投资布局，质量并重推进非公开市场投\n",
+      "资，完成另类资产投资占比50%的资产配置目标，对外投资总组合的韧性和质量不断提高。我们持续深化投资                             “行之力则知愈进，知之深则行愈达。”过去的十五年，是中投人不惧挑战、接续奋斗的十五\n",
+      "管理体制机制改革，统一非公开市场投资决策制度流程，配强投资决策专职委员并设立支持团队，投资管理科                         年。  2023年是中投人落实新一轮战略规划的开局之年。上半年，在风高浪急的国际环境下，中投公司锚定战略目\n",
+      "学化、专业化水平得到进一步提升。                                                         标，统筹好发展和安全，取得了良好业绩，实现了良好开局。近期，公司部分董事更换，我们对离任董事在指导和支\n",
+      "                                                                         持公司完善公司治理、深化投资管理体制机制改革、应对国际市场风险挑战等方面所作的贡献表示衷心感谢，对新\n",
+      "    我们勇担使命，坚定走好中国特色金融发展之路。面对新征程新要求，我们坚持发挥“积极股                            任董事表示热烈欢迎。站在新的历史起点上，中投公司将完整、准确、全面贯彻新发展理念，积极助力构建新发展格\n",
+      "东”作用，督促控参股金融企业优化产品服务、加大资源倾斜力度，全力支持稳经济稳增长。我们积极创新完                         局，牢牢把握高质量发展首要任务，继续秉承精益求精、追求卓越的专业精神，与国内外合作伙伴一起深化合作，共\n",
+      "善“汇金模式”，推动优化国有金融资本布局，以市场化方式参与问题金融机构救助，助力金融市场稳定健康                         聚力量、共迎挑战、共享成果，开启打造世界一流主权财富基金的新篇章，为助力全球经济发展作出新贡献！\n",
+      "发展。我们主动适应新形势新要求，围绕国有金融资本管理体系建设等重大课题深入研究，压实派出董事自主\n",
+      "履职责任，不断提升机构化履职能力。\n",
+      "    我们坚守底线，持续夯实全面风险管理体系。面对风高浪急的国际环境，我们优化风险管理委员\n",
+      "会设置，修订全面风险管理基本制度，增加风险类别的覆盖度，全面提升风险预见、应对、处置水平。在对外投\n",
+      "资方面，我们严守法律合规底线，健全地缘政治、气候变化等非传统风险防控机制，突出抓好流动性管理，对外\n",
+      "投资总组合风险保持在董事会规定的容忍度内。在国有金融资本受托管理方面，我们建立健全控参股金融企业风\n",
+      "险监测体系，全面开展多维度风险画像，推动控参股金融企业风险减存量、控增量、防变量取得积极成效。\n",
+      "7                                                    中国投资有限责任公司2022年度报告  中国投资有限责任公司2022年度报告                                     8\n",
+      "---\n",
+      "02                                 中投公司的组建宗旨是实现国家外汇资金多元化投资，在可接受风\n",
+      "                                   险范围内实现股东权益最大化，以服务于国家宏观经济发展和深化\n",
+      "   公  司  介  绍                      金融体制改革的需要。\n",
+      "   9           中国投资有限责任公司2022年度报告  中国投资有限责任公司2022年度报告             10\n",
+      "---\n",
+      "公司概况中国投资有限责任公司（以下简称“中投公司”）依照《中华人民共和国公司法》（以下简称“《公司                           公司治理 中投公司按照《公司法》及《中国投资有限责任公司章程》（以下简称“《中投公司章程》”）中的有关规\n",
+      "法》”）于2007年9月成立，总部设在北京。中投公司的初始资本金为2000亿美元，由中国财政部发行1.55万                      定，设立了董事会、监事会和执行委员会（以下简称“执委会”），三者之间权责明确、独立履职、有效制衡。\n",
+      "亿元人民币特别国债募集。截至2022年底，公司总资产达1.24万亿美元。                                             2022年，中投公司健全完善董事会、监事会运行机制，强化下设专门委员会的职能发挥，持续提升公司治\n",
+      "    中投公司的组建宗旨是实现国家外汇资金多元化投资，在可接受风险范围内实现股东权益最大化，以服务于                         理效能。公司根据业务发展需要，优化调整投资管理架构，完善投资决策和投后管理制度机制，深化全面风险管\n",
+      "国家宏观经济发展和深化金融体制改革的需要。                                                       理体系建设，全面提升机构化投资能力。\n",
+      "    中投公司开展境外投资业务与境内金融机构股权管理工作。其中，境外投资业务由下设子公司⸺中投国际\n",
+      "有限责任公司（以下简称“中投国际”）和中投海外直接投资有限责任公司（以下简称“中投海外”）承担，业\n",
+      "务范围包括公开市场股票和债券投资，对冲基金和多资产，泛行业私募股权和私募信用投资，房地产、基础设\n",
+      "施、资源商品、农业等领域的基金投资与直接投资，以及多双边基金管理等。                                          组织架构图\n",
+      "    中央汇金投资有限责任公司（以下简称“中央汇金”）作为中投公司的子公司，根据国务院授权，对国有重\n",
+      "点金融企业进行股权投资，以出资额为限代表国家依法对国有重点金融企业行使出资人权利和履行出资人义务。                                                               董事会                                 监事会\n",
+      "中央汇金不开展商业性经营活动，不干预其控股的国有重点金融企业的日常经营活动。                                               提名与\n",
+      "                                                                                    薪酬委员会\n",
+      "    中投国际和中投海外开展的境外业务与中央汇金开展的境内业务之间实行严格的“防火墙”政策和措施。\n",
+      "                                                                                     战略与\n",
+      "                                                                                    社会责任\n",
+      "                                                                                     委员会\n",
+      "                                                                                    风险管理                          执行               国际咨询         监督       审计\n",
+      "                                                                                     委员会                         委员会                委员会        委员会       委员会\n",
+      "                                                                                    境外投资                       管理与支持                     境内股权\n",
+      "                                                                                    业务部门                          部门                     管理部门\n",
+      "11                                                      中国投资有限责任公司2022年度报告  中国投资有限责任公司2022年度报告                                                                12\n",
+      "---\n",
+      "董事会                                                                                                         沈如军\n",
+      "                                                                                                            党委委员、执行董事、副总经理\n",
+      "    中投公司董事会行使《公司法》和《中投公司章程》中规定的有限责任公司董事会的职权，主要包括：审核                                                         1964年出生，管理学博士，高级会计师。历任中国工商银行计划财务部副总经理、\n",
+      "和批准公司的发展战略、经营方针和投资计划；确定公司需向股东报告的重大事项；制定公司年度预决算方案；                                                           北京市分行副行长、财务会计部总经理、山东省分行行长，交通银行执行董事、副\n",
+      "任免公司高级管理人员；决定或授权批准设立内部管理机构等。                                                                                行长。现任本公司党委委员、执行董事、副总经理。\n",
+      "    董事会由执行董事、非执行董事、独立董事以及职工董事构成。                                                                            丛亮\n",
+      "    2022年，面对复杂严峻的国际经济形势，董事会加强对公司重大经营管理事项的指导和督促，及时听取投                                                        非执行董事\n",
+      "资形势、经营管理、风险防控等汇报，认真审议经营计划、财务预算和决算、业绩考核等重要议题，深入谋划中                                                           1971年出生，经济学博士。历任国家发展和改革委员会国民经济综合司副司长、司\n",
+      "投公司新一轮战略规划，明确发展目标、基本原则和重点举措，为公司下一阶段改革发展描绘新的蓝图。董事会                                                           长，国家发展和改革委员会秘书长、新闻发言人，国家发展和改革委员会副主任，\n",
+      "专门委员会根据授权，重点关注关系企业长远发展的重大事项，为董事会出谋划策，推动公司高质量发展迈上新                                                           国家粮食和物资储备局局长。现任国家发展和改革委员会副主任，并兼任本公司非\n",
+      "台阶。                                                                                                         执行董事。\n",
+      "                                                                                                            许宏才\n",
+      "                                                                                                            非执行董事\n",
+      "董事会成员                                                                                                       1963年出生，经济学学士。历任财政部预算司副司长、司长，财政部部长助理，财\n",
+      "                                                                                                            政部副部长。现任全国人大财政经济委员会副主任委员、全国人大常委会预算工作\n",
+      "                            彭 纯                                    \n"
+     ]
+    }
+   ],
+   "source": [
+    "print(documents[0].get_content()[1000:10000])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "640f0679-7f7e-4b0a-a46d-b099ae382fe2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# download another copy with a different name to avoid hitting pdf cache\n",
+    "!wget \"https://www.dropbox.com/scl/fi/g5ojyzk4m44hl7neut6vc/chinese_pdf.pdf?rlkey=45reu51kjvdvic6zucr8v9sh3&dl=1\" -O chinese_pdf2.pdf"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bfcacf90-ca67-4bfd-b023-be0af2cb18c5",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 99538f59-24f7-4f1e-ab27-4081933fa5ee\n"
+     ]
+    }
+   ],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "base_parser = LlamaParse(result_type=\"text\", language=\"en\")\n",
+    "base_documents = parser.load_data(\"./chinese_pdf2.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b264ed4e-647a-4f51-9f79-fdf82b76762a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(base_documents[0].get_content()[1000:10000])"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/demo_mongodb.ipynb

@@ -0,0 +1,368 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# LlamaParse With MongoDB\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_mongodb.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "In this notebook, we provide a straightforward example of using LlamaParse with MongoDB Atlas VectorSearch.\n",
+    "\n",
+    "We illustrate the process of using llama-parse to parse a PDF document, then index the document with a MongoDB vector store, and subsequently perform basic queries against this store.\n",
+    "\n",
+    "This notebook is structured similarly to quick start guides, aiming to introduce users to utilizing llama-parse in conjunction with a MongoDB Atlas VectorSearch."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Installation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index llama-parse\n",
+    "%pip install llama-index-vector-stores-mongodb llama-index-llms-openai"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Setup API Keys"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\n",
+    "    \"LLAMA_CLOUD_API_KEY\"\n",
+    "] = \"\"  # Get it from https://cloud.llamaindex.ai/api-key\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"\"  # Get it from https://platform.openai.com/api-keys"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the sync code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "import requests\n",
+    "import pymongo\n",
+    "\n",
+    "from llama_index.vector_stores.mongodb import MongoDBAtlasVectorSearch\n",
+    "from llama_parse import LlamaParse\n",
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.core import VectorStoreIndex, StorageContext\n",
+    "from llama_index.core.node_parser import SimpleNodeParser"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Download Document\n",
+    "\n",
+    "We will use `Attention is all you need` paper."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Download complete.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# The URL of the file you want to download\n",
+    "url = \"https://arxiv.org/pdf/1706.03762.pdf\"\n",
+    "# The local path where you want to save the file\n",
+    "file_path = \"./attention.pdf\"\n",
+    "\n",
+    "# Perform the HTTP request\n",
+    "response = requests.get(url)\n",
+    "\n",
+    "# Check if the request was successful\n",
+    "if response.status_code == 200:\n",
+    "    # Open the file in binary write mode and save the content\n",
+    "    with open(file_path, \"wb\") as file:\n",
+    "        file.write(response.content)\n",
+    "    print(\"Download complete.\")\n",
+    "else:\n",
+    "    print(\"Error downloading the file.\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Parse the document using `LlamaParse`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 09a49745-9f21-4190-9de8-27e4e1a4bdf5\n"
+     ]
+    }
+   ],
+   "source": [
+    "documents = LlamaParse(result_type=\"text\").load_data(file_path)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "rmer - model architecture.\n",
+      "The Transformer follows this overall architecture using stacked self-attention and point-wise, fully\n",
+      "connected layers for both the encoder and decoder, shown in the left and right halves of Figure 1,\n",
+      "respectively.\n",
+      "3.1   Encoder and Decoder Stacks\n",
+      "Encoder:     The encoder is composed of a stack of N = 6 identical layers. Each layer has two\n",
+      "sub-layers. The first is a multi-head self-attention mechanism, and the second is a simple, position-\n",
+      "wise fully connected feed-forward network. We employ a residual connection [11] around each of\n",
+      "the two sub-layers, followed by layer normalization [1]. That is, the output of each sub-layer is\n",
+      "LayerNorm(x + Sublayer(x)), where Sublayer(x) is the function implemented by the sub-layer\n",
+      "itself. To facilitate these residual connections, all sub-layers in the model, as well as the embedding\n",
+      "layers, produce outputs of dimension dmodel = 512.\n",
+      "Decoder:    The decoder is also composed of a stack of N = 6 identical layers. In addition \n"
+     ]
+    }
+   ],
+   "source": [
+    "# Take a quick look at some of the parsed text from the document:\n",
+    "print(documents[0].get_content()[10000:11000])"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create `MongoDBAtlasVectorSearch`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "mongo_uri = os.environ[\"MONGO_URI\"]\n",
+    "\n",
+    "mongodb_client = pymongo.MongoClient(mongo_uri)\n",
+    "mongodb_vector_store = MongoDBAtlasVectorSearch(mongodb_client)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create nodes."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "node_parser = SimpleNodeParser()\n",
+    "\n",
+    "nodes = node_parser.get_nodes_from_documents(documents)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create Index and Query Engine."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "storage_context = StorageContext.from_defaults(vector_store=mongodb_vector_store)\n",
+    "\n",
+    "index = VectorStoreIndex(\n",
+    "    nodes=nodes,\n",
+    "    storage_context=storage_context,\n",
+    "    embed_model=OpenAIEmbedding(),\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = index.as_query_engine(similarity_top_k=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Test Query"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "***********New LlamaParse+ Basic Query Engine***********\n",
+      "The BLEU score on the WMT 2014 English-to-German translation task is 28.4.\n"
+     ]
+    }
+   ],
+   "source": [
+    "query = \"What is BLEU score on the WMT 2014 English-to-German translation task?\"\n",
+    "\n",
+    "response = query_engine.query(query)\n",
+    "print(\"\\n***********New LlamaParse+ Basic Query Engine***********\")\n",
+    "print(response)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "We varied the learning\n",
+      "rate over the course of training, according to the formula:\n",
+      "               lrate = d−0.5                                                                          (3)\n",
+      "                         model · min(step_num−0.5, step_num · warmup_steps−1.5)\n",
+      "This corresponds to increasing the learning rate linearly for the first warmup_steps training steps,\n",
+      "and decreasing it thereafter proportionally to the inverse square root of the step number. We used\n",
+      "warmup_steps = 4000.\n",
+      "5.4   Regularization\n",
+      "We employ three types of regularization during training:\n",
+      "                                                    7\n",
+      "---\n",
+      "Table 2: The Transformer achieves better BLEU scores than previous state-of-the-art models on the\n",
+      "English-to-German and English-to-French newstest2014 tests at a fraction of the training cost.\n",
+      "        Model                                          BLEU               Training Cost (FLOPs)\n",
+      "                                                 EN-DE      EN-FR          EN-DE         EN-FR\n",
+      "        ByteNet [18]                              23.75\n",
+      "        Deep-Att + PosUnk [39]                               39.2                       1.0 · 1020\n",
+      "        GNMT + RL [38]                            24.6       39.92        2.3 · 1019    1.4 · 1020\n",
+      "        ConvS2S [9]                               25.16      40.46        9.6 · 1018    1.5 · 1020\n",
+      "        MoE [32]                                  26.03      40.56        2.0 · 1019    1.2 · 1020\n",
+      "        Deep-Att + PosUnk Ensemble [39]                      40.4                       8.0 · 1020\n",
+      "        GNMT + RL Ensemble [38]                   26.30      41.16        1.8 · 1020    1.1 · 1021\n",
+      "        ConvS2S Ensemble [9]                      26.36      41.29        7.7 · 1019    1.2 · 1021\n",
+      "        Transformer (base model)                  27.3       38.1               3.3 · 1018\n",
+      "        Transformer (big)                         28.4       41.8                2.3 · 1019\n",
+      "Residual Dropout       We apply dropout [33] to the output of each sub-layer, before it is added to the\n",
+      "sub-layer input and normalized. In addition, we apply dropout to the sums of the embeddings and the\n",
+      "positional encodings in both the encoder and decoder stacks. For the base model, we use a rate of\n",
+      "Pdrop = 0.1.\n",
+      "Label Smoothing        During training, we employed label smoothing of value ϵls = 0.1 [36]. This\n",
+      "hurts perplexity, as the model learns to be more unsure, but improves accuracy and BLEU score.\n",
+      "6    Results\n",
+      "6.1   Machine Translation\n",
+      "On the WMT 2014 English-to-German translation task, the big transformer model (Transformer (big)\n",
+      "in Table 2) outperforms the best previously reported models (including ensembles) by more than 2.0\n",
+      "BLEU, establishing a new state-of-the-art BLEU score of 28.4. The configuration of this model is\n",
+      "listed in the bottom line of Table 3. Training took 3.5 days on 8 P100 GPUs. Even our base model\n",
+      "surpasses all previously published models and ensembles, at a fraction of the training cost of any of\n",
+      "the competitive models.\n",
+      "On the WMT 2014 English-to-French translation task, our big model achieves a BLEU score of 41.0,\n",
+      "outperforming all of the previously published single models, at less than 1/4 the training cost of the\n",
+      "previous state-of-the-art model. The Transformer (big) model trained for English-to-French used\n",
+      "dropout rate Pdrop = 0.1, instead of 0.3.\n",
+      "For the base models, we used a single model obtained by averaging the last 5 checkpoints, which\n",
+      "were written at 10-minute intervals. For the big models, we averaged the last 20 checkpoints. We\n",
+      "used beam search with a beam size of 4 and length penalty α = 0.6 [38]. These hyperparameters\n",
+      "were chosen after experimentation on the development set. We set the maximum output length during\n",
+      "inference to input length + 50, but terminate early when possible [38].\n",
+      "Table 2 summarizes our results and compares our translation quality and training costs to other model\n",
+      "architectures from the literature.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Take a look at one of the source nodes from the response\n",
+    "print(response.source_nodes[0].get_content())"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "anthropic_env",
+   "language": "python",
+   "name": "anthropic_env"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "b0fa6594d8f4cbf19f97940f81e996739fb7646882a419484c72d19e05852a7e"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}

examples/demo_parsing_instructions.ipynb

@@ -0,0 +1,544 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# LlamaParse - Parsing comic books with parsing intructions\n",
+    "Parsing intructions allow you to instruct our parsing model the same way you would instruct an LLM!\n",
+    "\n",
+    "They can be useful to help the parser get better results on complex document layouts, to extract data in a specific format, or to transform the document in other ways.\n",
+    "\n",
+    "Using Parsing Instruction you will get better results out of LlamaParse on complicated documents, and also be able to simplify your application code."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Installation\n",
+    "\n",
+    "Parsing instructions are part of the llamaParse API. They can be accessed by directly specifying the parsing_instruction parameter in the API or by using the LlamaParse python module (which we will use for this tutorial).\n",
+    "\n",
+    "To install llama-parse, just get it from PIP:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Collecting llama-parse\n",
+      "  Downloading llama_parse-0.3.8-py3-none-any.whl (6.7 kB)\n",
+      "Collecting llama-index-core>=0.10.7 (from llama-parse)\n",
+      "  Downloading llama_index_core-0.10.19-py3-none-any.whl (15.3 MB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m15.3/15.3 MB\u001b[0m \u001b[31m31.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: PyYAML>=6.0.1 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (6.0.1)\n",
+      "Requirement already satisfied: SQLAlchemy[asyncio]>=1.4.49 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (2.0.28)\n",
+      "Requirement already satisfied: aiohttp<4.0.0,>=3.8.6 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (3.9.3)\n",
+      "Collecting dataclasses-json (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading dataclasses_json-0.6.4-py3-none-any.whl (28 kB)\n",
+      "Collecting deprecated>=1.2.9.3 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading Deprecated-1.2.14-py2.py3-none-any.whl (9.6 kB)\n",
+      "Collecting dirtyjson<2.0.0,>=1.0.8 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading dirtyjson-1.0.8-py3-none-any.whl (25 kB)\n",
+      "Requirement already satisfied: fsspec>=2023.5.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (2023.6.0)\n",
+      "Collecting httpx (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading httpx-0.27.0-py3-none-any.whl (75 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m75.6/75.6 kB\u001b[0m \u001b[31m6.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hCollecting llamaindex-py-client<0.2.0,>=0.1.13 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading llamaindex_py_client-0.1.13-py3-none-any.whl (107 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m108.0/108.0 kB\u001b[0m \u001b[31m10.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: nest-asyncio<2.0.0,>=1.5.8 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (1.6.0)\n",
+      "Requirement already satisfied: networkx>=3.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (3.2.1)\n",
+      "Requirement already satisfied: nltk<4.0.0,>=3.8.1 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (3.8.1)\n",
+      "Requirement already satisfied: numpy in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (1.25.2)\n",
+      "Collecting openai>=1.1.0 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading openai-1.13.3-py3-none-any.whl (227 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m227.4/227.4 kB\u001b[0m \u001b[31m16.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: pandas in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (1.5.3)\n",
+      "Requirement already satisfied: pillow>=9.0.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (9.4.0)\n",
+      "Requirement already satisfied: requests>=2.31.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (2.31.0)\n",
+      "Requirement already satisfied: tenacity<9.0.0,>=8.2.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (8.2.3)\n",
+      "Collecting tiktoken>=0.3.3 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading tiktoken-0.6.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m1.8/1.8 MB\u001b[0m \u001b[31m43.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: tqdm<5.0.0,>=4.66.1 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (4.66.2)\n",
+      "Requirement already satisfied: typing-extensions>=4.5.0 in /usr/local/lib/python3.10/dist-packages (from llama-index-core>=0.10.7->llama-parse) (4.10.0)\n",
+      "Collecting typing-inspect>=0.8.0 (from llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading typing_inspect-0.9.0-py3-none-any.whl (8.8 kB)\n",
+      "Requirement already satisfied: aiosignal>=1.1.2 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (1.3.1)\n",
+      "Requirement already satisfied: attrs>=17.3.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (23.2.0)\n",
+      "Requirement already satisfied: frozenlist>=1.1.1 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (1.4.1)\n",
+      "Requirement already satisfied: multidict<7.0,>=4.5 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (6.0.5)\n",
+      "Requirement already satisfied: yarl<2.0,>=1.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (1.9.4)\n",
+      "Requirement already satisfied: async-timeout<5.0,>=4.0 in /usr/local/lib/python3.10/dist-packages (from aiohttp<4.0.0,>=3.8.6->llama-index-core>=0.10.7->llama-parse) (4.0.3)\n",
+      "Requirement already satisfied: wrapt<2,>=1.10 in /usr/local/lib/python3.10/dist-packages (from deprecated>=1.2.9.3->llama-index-core>=0.10.7->llama-parse) (1.14.1)\n",
+      "Requirement already satisfied: pydantic>=1.10 in /usr/local/lib/python3.10/dist-packages (from llamaindex-py-client<0.2.0,>=0.1.13->llama-index-core>=0.10.7->llama-parse) (2.6.3)\n",
+      "Requirement already satisfied: anyio in /usr/local/lib/python3.10/dist-packages (from httpx->llama-index-core>=0.10.7->llama-parse) (3.7.1)\n",
+      "Requirement already satisfied: certifi in /usr/local/lib/python3.10/dist-packages (from httpx->llama-index-core>=0.10.7->llama-parse) (2024.2.2)\n",
+      "Collecting httpcore==1.* (from httpx->llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading httpcore-1.0.4-py3-none-any.whl (77 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m77.8/77.8 kB\u001b[0m \u001b[31m8.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: idna in /usr/local/lib/python3.10/dist-packages (from httpx->llama-index-core>=0.10.7->llama-parse) (3.6)\n",
+      "Requirement already satisfied: sniffio in /usr/local/lib/python3.10/dist-packages (from httpx->llama-index-core>=0.10.7->llama-parse) (1.3.1)\n",
+      "Collecting h11<0.15,>=0.13 (from httpcore==1.*->httpx->llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading h11-0.14.0-py3-none-any.whl (58 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m58.3/58.3 kB\u001b[0m \u001b[31m5.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: click in /usr/local/lib/python3.10/dist-packages (from nltk<4.0.0,>=3.8.1->llama-index-core>=0.10.7->llama-parse) (8.1.7)\n",
+      "Requirement already satisfied: joblib in /usr/local/lib/python3.10/dist-packages (from nltk<4.0.0,>=3.8.1->llama-index-core>=0.10.7->llama-parse) (1.3.2)\n",
+      "Requirement already satisfied: regex>=2021.8.3 in /usr/local/lib/python3.10/dist-packages (from nltk<4.0.0,>=3.8.1->llama-index-core>=0.10.7->llama-parse) (2023.12.25)\n",
+      "Requirement already satisfied: distro<2,>=1.7.0 in /usr/lib/python3/dist-packages (from openai>=1.1.0->llama-index-core>=0.10.7->llama-parse) (1.7.0)\n",
+      "Requirement already satisfied: charset-normalizer<4,>=2 in /usr/local/lib/python3.10/dist-packages (from requests>=2.31.0->llama-index-core>=0.10.7->llama-parse) (3.3.2)\n",
+      "Requirement already satisfied: urllib3<3,>=1.21.1 in /usr/local/lib/python3.10/dist-packages (from requests>=2.31.0->llama-index-core>=0.10.7->llama-parse) (2.0.7)\n",
+      "Requirement already satisfied: greenlet!=0.4.17 in /usr/local/lib/python3.10/dist-packages (from SQLAlchemy[asyncio]>=1.4.49->llama-index-core>=0.10.7->llama-parse) (3.0.3)\n",
+      "Collecting mypy-extensions>=0.3.0 (from typing-inspect>=0.8.0->llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading mypy_extensions-1.0.0-py3-none-any.whl (4.7 kB)\n",
+      "Collecting marshmallow<4.0.0,>=3.18.0 (from dataclasses-json->llama-index-core>=0.10.7->llama-parse)\n",
+      "  Downloading marshmallow-3.21.1-py3-none-any.whl (49 kB)\n",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m49.4/49.4 kB\u001b[0m \u001b[31m4.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n",
+      "\u001b[?25hRequirement already satisfied: python-dateutil>=2.8.1 in /usr/local/lib/python3.10/dist-packages (from pandas->llama-index-core>=0.10.7->llama-parse) (2.8.2)\n",
+      "Requirement already satisfied: pytz>=2020.1 in /usr/local/lib/python3.10/dist-packages (from pandas->llama-index-core>=0.10.7->llama-parse) (2023.4)\n",
+      "Requirement already satisfied: exceptiongroup in /usr/local/lib/python3.10/dist-packages (from anyio->httpx->llama-index-core>=0.10.7->llama-parse) (1.2.0)\n",
+      "Requirement already satisfied: packaging>=17.0 in /usr/local/lib/python3.10/dist-packages (from marshmallow<4.0.0,>=3.18.0->dataclasses-json->llama-index-core>=0.10.7->llama-parse) (23.2)\n",
+      "Requirement already satisfied: annotated-types>=0.4.0 in /usr/local/lib/python3.10/dist-packages (from pydantic>=1.10->llamaindex-py-client<0.2.0,>=0.1.13->llama-index-core>=0.10.7->llama-parse) (0.6.0)\n",
+      "Requirement already satisfied: pydantic-core==2.16.3 in /usr/local/lib/python3.10/dist-packages (from pydantic>=1.10->llamaindex-py-client<0.2.0,>=0.1.13->llama-index-core>=0.10.7->llama-parse) (2.16.3)\n",
+      "Requirement already satisfied: six>=1.5 in /usr/local/lib/python3.10/dist-packages (from python-dateutil>=2.8.1->pandas->llama-index-core>=0.10.7->llama-parse) (1.16.0)\n",
+      "Installing collected packages: dirtyjson, mypy-extensions, marshmallow, h11, deprecated, typing-inspect, tiktoken, httpcore, httpx, dataclasses-json, openai, llamaindex-py-client, llama-index-core, llama-parse\n",
+      "Successfully installed dataclasses-json-0.6.4 deprecated-1.2.14 dirtyjson-1.0.8 h11-0.14.0 httpcore-1.0.4 httpx-0.27.0 llama-index-core-0.10.19 llama-parse-0.3.8 llamaindex-py-client-0.1.13 marshmallow-3.21.1 mypy-extensions-1.0.0 openai-1.13.3 tiktoken-0.6.0 typing-inspect-0.9.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "%pip install llama-parse"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## API key\n",
+    "\n",
+    "The use of LlamaParse requires an API key which you can get here: https://cloud.llamaindex.ai/parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Async (Notebook only)\n",
+    "llama-parse is async-first, so running the code in a notebook requires the use of nest_asyncio\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Import the package"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using llamaparse for getting better results (on Manga!)\n",
+    "\n",
+    "Sometimes the layout of a page is unusual and you will get sub-optimal reading order results with LlamaParse. For example, when parsing manga you expect the reading order to be right to left even if the content is in English!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's download an extract of a great manga \"The manga guide to calculus\", by Hiroyuki Kojima (https://www.amazon.com/Manga-Guide-Calculus-Hiroyuki-Kojima/dp/1593271948)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "--2024-03-13 13:57:19--  https://drive.usercontent.google.com/uc?id=1tZJhcpepLRdQFJFCFX50QIqLyLgqzZsY&export=download\n",
+      "Resolving drive.usercontent.google.com (drive.usercontent.google.com)... 173.194.211.132, 2607:f8b0:400c:c10::84\n",
+      "Connecting to drive.usercontent.google.com (drive.usercontent.google.com)|173.194.211.132|:443... connected.\n",
+      "HTTP request sent, awaiting response... 303 See Other\n",
+      "Location: https://drive.usercontent.google.com/download?id=1tZJhcpepLRdQFJFCFX50QIqLyLgqzZsY&export=download [following]\n",
+      "--2024-03-13 13:57:19--  https://drive.usercontent.google.com/download?id=1tZJhcpepLRdQFJFCFX50QIqLyLgqzZsY&export=download\n",
+      "Reusing existing connection to drive.usercontent.google.com:443.\n",
+      "HTTP request sent, awaiting response... 200 OK\n",
+      "Length: 3041634 (2.9M) [application/octet-stream]\n",
+      "Saving to: ‘./manga.pdf’\n",
+      "\n",
+      "./manga.pdf         100%[===================>]   2.90M  --.-KB/s    in 0.04s   \n",
+      "\n",
+      "2024-03-13 13:57:20 (78.6 MB/s) - ‘./manga.pdf’ saved [3041634/3041634]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "! wget \"https://drive.usercontent.google.com/uc?id=1tZJhcpepLRdQFJFCFX50QIqLyLgqzZsY&export=download\" -O ./manga.pdf"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Without parsing instructions\n",
+    "For the sake of comparison, let's first parse without any instructions."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 25bf4202-78d8-4705-88cf-c616ae7c82af\n"
+     ]
+    }
+   ],
+   "source": [
+    "vanilaParsing = LlamaParse(result_type=\"markdown\").load_data(\"./manga.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "As you can see below, LlamaParse is not doing a great job here. It is interpreting the grid of comic panels as a table, and trying to fit the dialogue into a table. It's very hard to follow."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "The Asagake Times Sanda-Cho Distributor\n",
+      "\n",
+      "A newspaper distributor? do I have the wrong map?\n",
+      "\n",
+      "You’re looking It’s next for the Sanda-cho door. branch office? Everybody mistakes us for the office because we are larger. What Is a Function? 3\n",
+      "---\n",
+      "## Calculating the Derivative of a Constant, Linear, or Quadratic Function\n",
+      "\n",
+      "|1.|Let’s find the derivative of constant function f(x) = α. The differential coefficient of f(x) at x = a is|\n",
+      "|---|---|\n",
+      "| |lim ε→0 (f(a + ε) - f(a)) / ε = lim ε→0 (α - α) = lim ε→0 0 = 0|\n",
+      "| |Thus, the derivative of f(x) is f′(x) = 0. This makes sense, since our function is constant—the rate of change is 0.|\n",
+      "\n",
+      "Note: The differential coefficient of f(x) at x = a is often simply called the derivative of f(x) at x = a, or just f′(a).\n",
+      "\n",
+      "|2.|Let’s calculate the derivative of linear function f(x) = αx + β. The derivative of f(x) at x = α is|\n",
+      "|---|---|\n",
+      "| |lim ε→0 (f(α + ε) - f(a)) = \n"
+     ]
+    }
+   ],
+   "source": [
+    "print(vanilaParsing[0].text[100:1000])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using parsing instructions\n",
+    "Let's try to parse the manga with custom instructions:\n",
+    "\n",
+    "\"The provided document is a manga comic book. Most pages do NOT have a title. It does not contain tables. Try to reconstruct the dialogue spoken in a cohesive way.\"\n",
+    "\n",
+    "To do so just pass the parsing instruction as a parameter to LlamaParse:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 88ab273e-b2a7-4f84-8e72-e9367cf6b114\n",
+      "."
+     ]
+    }
+   ],
+   "source": [
+    "parsingInstructionManga = \"\"\"The provided document is a manga comic book. Most pages do NOT have a title.\n",
+    "It does not contain tables.\n",
+    "Try to reconstruct the dialogue spoken in a cohesive way.\"\"\"\n",
+    "withInstructionParsing = LlamaParse(\n",
+    "    result_type=\"markdown\", parsing_instruction=parsingInstructionManga\n",
+    ").load_data(\"./manga.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's see how it compare with page 3! We encourage you to play with the target page and explore other pages. As you will see, the parsing instruction allowed LlamaParse to make sense of the document!\n",
+    "\n",
+    "<img src=\"https://drive.usercontent.google.com/download?id=1M87rXTIZE8d5v7aHmVZVW6gW3eDGq6ks&authuser=0\" />\n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The Asagake Times Sanda-Cho Distributor\n",
+      "\n",
+      "A newspaper distributor? do I have the wrong map?\n",
+      "\n",
+      "You’re looking It’s next for the Sanda-cho door. branch office? Everybody mistakes us for the office because we are larger. What Is a Function? 3\n",
+      "\n",
+      "\n",
+      "------------------------------------------------------------\n",
+      "\n",
+      "\n",
+      "# The Asagake Times\n",
+      "\n",
+      "Sanda-Cho Distributor\n",
+      "\n",
+      "A newspaper distributor?\n",
+      "\n",
+      "Do I have the wrong map?\n",
+      "\n",
+      "You're looking for the Sanda-cho branch office?\n",
+      "\n",
+      "It's next door.\n",
+      "\n",
+      "Everybody mistakes us for the office because we are larger.\n",
+      "\n",
+      "What Is a Function? 3\n"
+     ]
+    }
+   ],
+   "source": [
+    "target_page = 1\n",
+    "print(vanilaParsing[0].text.split(\"\\n---\\n\")[target_page])\n",
+    "print(\"\\n\\n------------------------------------------------------------\\n\\n\")\n",
+    "print(withInstructionParsing[0].text.split(\"\\n---\\n\")[target_page])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Math - doing more with parsing instuction!\n",
+    "\n",
+    "But this manga is about math and full of equations, why not ask the parser to output them in **LaTeX**?\n",
+    "\n",
+    "<img src=\"https://drive.usercontent.google.com/download?id=1tze3xcQ7axVA-vC_iZeAj_GvYcyNuYDa&authuser=0\" />"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 3a055e64-d91e-484e-b9b0-99a2e637c08d\n",
+      "."
+     ]
+    }
+   ],
+   "source": [
+    "parsingInstructionMangaLatex = \"\"\"The provided document is a manga comic book. Most pages do NOT have a title.\n",
+    "It does not contain tables.\n",
+    "Try to reconstruct the dialogue spoken in a cohesive way.\n",
+    "Output any math equation in LATEX markdown (between $$)\"\"\"\n",
+    "withLatex = LlamaParse(\n",
+    "    result_type=\"markdown\", parsing_instruction=parsingInstructionMangaLatex\n",
+    ").load_data(\"./manga.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "\n",
+      "[Without instruction]------------------------------------------------------------\n",
+      "\n",
+      "\n",
+      "## Calculating the Derivative of a Constant, Linear, or Quadratic Function\n",
+      "\n",
+      "|1.|Let’s find the derivative of constant function f(x) = α. The differential coefficient of f(x) at x = a is|\n",
+      "|---|---|\n",
+      "| |lim ε→0 (f(a + ε) - f(a)) / ε = lim ε→0 (α - α) = lim ε→0 0 = 0|\n",
+      "| |Thus, the derivative of f(x) is f′(x) = 0. This makes sense, since our function is constant—the rate of change is 0.|\n",
+      "\n",
+      "Note: The differential coefficient of f(x) at x = a is often simply called the derivative of f(x) at x = a, or just f′(a).\n",
+      "\n",
+      "|2.|Let’s calculate the derivative of linear function f(x) = αx + β. The derivative of f(x) at x = α is|\n",
+      "|---|---|\n",
+      "| |lim ε→0 (f(α + ε) - f(a)) = lim ε→0 (α(a + ε) + β - (αa + β)) = lim ε→0 α = α|\n",
+      "| |Thus, the derivative of f(x) is f′(x) = α, a constant value. This result should also be intuitive—linear functions have a constant rate of change by definition.|\n",
+      "\n",
+      "|3.|Let’s find the derivative of f(x) = x^2, which appeared in the story. The differential coefficient of f(x) at x = a is|\n",
+      "|---|---|\n",
+      "| |lim ε→0 ((a + ε)^2 - a^2) / ε = lim (a^2 + 2aε + ε^2 - a^2) / ε = lim (2aε + ε^2) = lim (2a + ε) = 2a|\n",
+      "| |Thus, the differential coefficient of f(x) at x = a is 2a, or f′(a) = 2a. Therefore, the derivative of f(x) is f′(x) = 2x.|\n",
+      "\n",
+      "## Summary\n",
+      "\n",
+      "- The calculation of a limit that appears in calculus is simply a formula calculating an error.\n",
+      "- A limit is used to obtain a derivative.\n",
+      "- The derivative is the slope of the tangent line at a given point.\n",
+      "- The derivative is nothing but the rate of change.\n",
+      "\n",
+      "## Chapter 1 Let’s Differentiate a Function!\n",
+      "\n",
+      "\n",
+      "[With instruction to output math in LATEX!]------------------------------------------------------------\n",
+      "\n",
+      "\n",
+      "# Derivative of Constant, Linear, or Quadratic Function\n",
+      "\n",
+      "## Calculating the Derivative of a Constant, Linear, or Quadratic Function\n",
+      "\n",
+      "1. Let’s find the derivative of constant function f(x) = α. The differential coefficient of f(x) at x = a is\n",
+      "\n",
+      "$$\n",
+      "\\begin{align*}\n",
+      "&\\lim_{{\\varepsilon \\to 0}} \\left( \\frac{f(a + \\varepsilon) - f(a)}{\\varepsilon} \\right) = \\lim_{{\\varepsilon \\to 0}} \\frac{\\alpha - \\alpha}{\\varepsilon} = \\lim_{{\\varepsilon \\to 0}} 0 = 0 \\\\\n",
+      "\\end{align*}\n",
+      "$$\n",
+      "Thus, the derivative of f(x) is f′(x) = 0. This makes sense, since our function is constant—the rate of change is 0.\n",
+      "\n",
+      "Note: The differential coefficient of f(x) at x = a is often simply called the derivative of f(x) at x = a, or just f′(a).\n",
+      "\n",
+      "2. Let’s calculate the derivative of linear function f(x) = αx + β. The derivative of f(x) at x = α is\n",
+      "\n",
+      "$$\n",
+      "\\begin{align*}\n",
+      "&\\lim_{{\\varepsilon \\to 0}} \\left( \\frac{f(\\alpha + \\varepsilon) - f(a)}{\\varepsilon} \\right) = \\lim_{{\\varepsilon \\to 0}} \\frac{\\alpha(a + \\varepsilon) + \\beta - (\\alpha a + \\beta)}{\\varepsilon} = \\lim_{{\\varepsilon \\to 0}} \\alpha = \\alpha \\\\\n",
+      "\\end{align*}\n",
+      "$$\n",
+      "Thus, the derivative of f(x) is f′(x) = α, a constant value. This result should also be intuitive—linear functions have a constant rate of change by definition.\n",
+      "\n",
+      "3. Let’s find the derivative of f(x) = x2. The differential coefficient of f(x) at x = a is\n",
+      "\n",
+      "$$\n",
+      "\\begin{align*}\n",
+      "&\\lim_{{\\varepsilon \\to 0}} \\left( \\frac{f(a + \\varepsilon) - f(a)}{\\varepsilon} \\right) = \\lim_{{\\varepsilon \\to 0}} \\left( (a + \\varepsilon)^2 - a^2 \\right) = \\lim_{{\\varepsilon \\to 0}} 2a\\varepsilon + \\varepsilon = \\lim_{{\\varepsilon \\to 0}} (2a + \\varepsilon) = 2a \\\\\n",
+      "\\end{align*}\n",
+      "$$\n",
+      "Thus, the differential coefficient of f(x) at x = a is 2a, or f′(a) = 2a. Therefore, the derivative of f(x) is f′(x) = 2x.\n",
+      "\n",
+      "### Summary\n",
+      "\n",
+      "- The calculation of a limit that appears in calculus is simply a formula calculating an error.\n",
+      "- A limit is used to obtain a derivative.\n",
+      "- The derivative is the slope of the tangent line at a given point.\n",
+      "- The derivative is nothing but the rate of change.\n"
+     ]
+    }
+   ],
+   "source": [
+    "target_page = 2\n",
+    "print(\n",
+    "    \"\\n\\n[Without instruction]------------------------------------------------------------\\n\\n\"\n",
+    ")\n",
+    "print(vanilaParsing[0].text.split(\"\\n---\\n\")[target_page])\n",
+    "print(\n",
+    "    \"\\n\\n[With instruction to output math in LATEX!]------------------------------------------------------------\\n\\n\"\n",
+    ")\n",
+    "print(withLatex[0].text.split(\"\\n---\\n\")[target_page])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "And here is the result as rendered by https://upmath.me/ .\n",
+    "\n",
+    "\n",
+    "<img src=\"https://drive.usercontent.google.com/download?id=1qGo5bMGYOiIC9MnprcgEByaYjU9YII2Q&authuser=0\" />\n",
+    "\n",
+    "\n",
+    "Over this short notebook we saw how to use parsing instructions to increase the quality and accuracy of parsing with LLamaParse!"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}

examples/demo_table_comparisons.ipynb

@@ -0,0 +1,367 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# RAG for Table Comparisons with LlamaParse + LlamaIndex\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_table_comparisons.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "This notebook shows you how to do comparisons across both tabular and text data across multiple PDF documents.\n",
+    "\n",
+    "We load in multiple PDFs with embedded tables (2021 and 2020 10K filings for Apple) using LlamaParse, parse each into a hierarchy of tables/text objects, define a recursive retriever over each, and then compose both with a SubQuestionQueryEngine."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "Install core packages, download files, parse documents."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index\n",
+    "%pip install llama-index-core\n",
+    "%pip install llama-index-embeddings-openai\n",
+    "%pip install llama-index-question-gen-openai\n",
+    "%pip install llama-index-postprocessor-flag-embedding-reranker\n",
+    "%pip install git+https://github.com/FlagOpen/FlagEmbedding.git\n",
+    "%pip install llama-parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!wget \"https://s2.q4cdn.com/470004039/files/doc_financials/2020/ar/_10-K-2020-(As-Filed).pdf\" -O apple_2020_10k.pdf\n",
+    "!wget \"https://s2.q4cdn.com/470004039/files/doc_financials/2021/q4/_10-K-2021-(As-Filed).pdf\" -O apple_2021_10k.pdf"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Some OpenAI and LlamaParse details"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# llama-parse is async-first, running the async code in a notebook requires the use of nest_asyncio\n",
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "import os\n",
+    "\n",
+    "# API access to llama-cloud\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-\"\n",
+    "\n",
+    "# Using OpenAI API for embeddings/llms\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"sk-\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.llms.openai import OpenAI\n",
+    "from llama_index.embeddings.openai import OpenAIEmbedding\n",
+    "from llama_index.core import VectorStoreIndex\n",
+    "from llama_index.core import Settings\n",
+    "\n",
+    "embed_model = OpenAIEmbedding(model=\"text-embedding-3-small\")\n",
+    "llm = OpenAI(model=\"gpt-3.5-turbo-0125\")\n",
+    "\n",
+    "Settings.llm = llm\n",
+    "Settings.embed_model = embed_model"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using brand new `LlamaParse` PDF reader for PDF Parsing\n",
+    "\n",
+    "we also compare two different retrieval/query engine strategies:\n",
+    "1. Using raw Markdown text as nodes for building index and apply simple query engine for generating the results;\n",
+    "2. Using `MarkdownElementNodeParser` for parsing the `LlamaParse` output Markdown results and building recursive retriever query engine for generation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "docs_2021 = LlamaParse(result_type=\"markdown\").load_data(\"./apple_2021_10k.pdf\")\n",
+    "docs_2020 = LlamaParse(result_type=\"markdown\").load_data(\"./apple_2020_10k.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Create Recursive Retriever over each Document\n",
+    "\n",
+    "We define a function to get a recursive retriever from each document. The steps are the following:\n",
+    "- Hierarchically parse the document using our `MarkdownElementNodeParser`, which will embed/summarize embedded tables.\n",
+    "- Load into a vector store. Under the hood we will automatically store links between nodes (e.g. table summary to table text).\n",
+    "- Get a query engine over the vector store, which performs retrieval/synthesis. Under the hood we will automatically perform recursive retrieval if there are links."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core.node_parser import MarkdownElementNodeParser\n",
+    "\n",
+    "node_parser = MarkdownElementNodeParser(\n",
+    "    llm=OpenAI(model=\"gpt-3.5-turbo-0125\"), num_workers=8\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pickle\n",
+    "from llama_index.postprocessor.flag_embedding_reranker import (\n",
+    "    FlagEmbeddingReranker,\n",
+    ")\n",
+    "\n",
+    "reranker = FlagEmbeddingReranker(\n",
+    "    top_n=5,\n",
+    "    model=\"BAAI/bge-reranker-large\",\n",
+    ")\n",
+    "\n",
+    "\n",
+    "def create_query_engine_over_doc(docs, nodes_save_path=None):\n",
+    "    \"\"\"Big function to go from document path -> recursive retriever.\"\"\"\n",
+    "    if nodes_save_path is not None and os.path.exists(nodes_save_path):\n",
+    "        raw_nodes = pickle.load(open(nodes_save_path, \"rb\"))\n",
+    "    else:\n",
+    "        raw_nodes = node_parser.get_nodes_from_documents(docs)\n",
+    "        if nodes_save_path is not None:\n",
+    "            pickle.dump(raw_nodes, open(nodes_save_path, \"wb\"))\n",
+    "\n",
+    "    base_nodes, objects = node_parser.get_nodes_and_objects(raw_nodes)\n",
+    "\n",
+    "    ### Construct Retrievers\n",
+    "    # construct top-level vector index + query engine\n",
+    "    vector_index = VectorStoreIndex(nodes=base_nodes + objects)\n",
+    "    query_engine = vector_index.as_query_engine(\n",
+    "        similarity_top_k=15, node_postprocessors=[reranker]\n",
+    "    )\n",
+    "    return query_engine, base_nodes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine_2021, nodes_2021 = create_query_engine_over_doc(\n",
+    "    docs_2021, nodes_save_path=\"2021_nodes.pkl\"\n",
+    ")\n",
+    "query_engine_2020, nodes_2020 = create_query_engine_over_doc(\n",
+    "    docs_2020, nodes_save_path=\"2020_nodes.pkl\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core.tools import QueryEngineTool, ToolMetadata\n",
+    "from llama_index.core.query_engine import SubQuestionQueryEngine\n",
+    "\n",
+    "\n",
+    "# setup base query engine as tool\n",
+    "query_engine_tools = [\n",
+    "    QueryEngineTool(\n",
+    "        query_engine=query_engine_2021,\n",
+    "        metadata=ToolMetadata(\n",
+    "            name=\"apple_2021_10k\",\n",
+    "            description=(\"Provides information about Apple financials for year 2021\"),\n",
+    "        ),\n",
+    "    ),\n",
+    "    QueryEngineTool(\n",
+    "        query_engine=query_engine_2020,\n",
+    "        metadata=ToolMetadata(\n",
+    "            name=\"apple_2020_10k\",\n",
+    "            description=(\"Provides information about Apple financials for year 2020\"),\n",
+    "        ),\n",
+    "    ),\n",
+    "]\n",
+    "\n",
+    "sub_query_engine = SubQuestionQueryEngine.from_defaults(\n",
+    "    query_engine_tools=query_engine_tools,\n",
+    "    llm=llm,\n",
+    "    use_async=True,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Try out Some Comparisons"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generated 4 sub questions.\n",
+      "\u001b[1;3;38;2;237;90;200m[apple_2021_10k] Q: What are the deferred assets in 2021?\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2021_10k] Q: What are the deferred liabilities in 2021?\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203m[apple_2020_10k] Q: What are the deferred assets in 2020?\n",
+      "\u001b[0m\u001b[1;3;38;2;155;135;227m[apple_2020_10k] Q: What are the deferred liabilities in 2020?\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2021_10k] A: $7,200\n",
+      "\u001b[0m\u001b[1;3;38;2;155;135;227m[apple_2020_10k] A: $10,138\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200m[apple_2021_10k] A: $25,176 million\n",
+      "\u001b[0m\u001b[1;3;38;2;11;159;203m[apple_2020_10k] A: $19,336\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "response = sub_query_engine.query(\n",
+    "    \"Can you compare and contrast the deferred assets and liabilities in 2021 with 2020?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "In 2021, the deferred assets increased by $5,840 million compared to 2020, while the deferred liabilities decreased by $2,938 million in the same period.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generated 2 sub questions.\n",
+      "\u001b[1;3;38;2;237;90;200m[apple_2021_10k] Q: What is the total number of RSUs in Apple's 2021 financials?\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2020_10k] Q: What is the total number of RSUs in Apple's 2020 financials?\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200m[apple_2021_10k] A: The total number of RSUs in Apple's 2021 financials is 240,427.\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2020_10k] A: The total number of RSUs in Apple's 2020 financials is 310,778.\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "response = sub_query_engine.query(\n",
+    "    \"Can you compare and contrast the total number of RSUs in 2021 and 2020?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generated 2 sub questions.\n",
+      "\u001b[1;3;38;2;237;90;200m[apple_2021_10k] Q: What are the risk factors mentioned in the 2021 financial report of Apple?\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2020_10k] Q: What are the risk factors mentioned in the 2020 financial report of Apple?\n",
+      "\u001b[0m\u001b[1;3;38;2;237;90;200m[apple_2021_10k] A: The risk factors mentioned in the 2021 financial report of Apple include risks related to COVID-19, macroeconomic and industry risks, political events, trade and international disputes, natural disasters, public health issues, industrial accidents, credit risk, fluctuations in foreign currency exchange rates, changes in tax rates and legislation, volatility in the price of the company's stock, and exposure to legal proceedings and claims.\n",
+      "\u001b[0m\u001b[1;3;38;2;90;149;237m[apple_2020_10k] A: The risk factors mentioned in the 2020 financial report of Apple include the impact of the COVID-19 pandemic on the company's business operations, financial condition, and stock price; global and regional economic conditions affecting demand for products and services; competition in global markets with rapid technological changes; potential disruptions in the supply chain due to industrial accidents or public health issues; information technology system failures or network disruptions affecting business operations; risks associated with confidential information security and potential unauthorized access; fluctuations in quarterly net sales and operating results due to various factors; stock price volatility impacting investor confidence and employee retention; financial performance risks related to changes in foreign currency exchange rates affecting sales and earnings.\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "response = sub_query_engine.query(\n",
+    "    \"Can you compare and contrast the risk factors in 2021 vs. 2020?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The risk factors mentioned in the 2021 financial report of Apple include risks related to COVID-19, macroeconomic and industry risks, political events, trade and international disputes, natural disasters, public health issues, industrial accidents, credit risk, fluctuations in foreign currency exchange rates, changes in tax rates and legislation, volatility in the price of the company's stock, and exposure to legal proceedings and claims. In contrast, the risk factors mentioned in the 2020 financial report of Apple focused more on the impact of the COVID-19 pandemic on the company's business operations, financial condition, and stock price; global and regional economic conditions affecting demand for products and services; competition in global markets with rapid technological changes; potential disruptions in the supply chain due to industrial accidents or public health issues; information technology system failures or network disruptions affecting business operations; risks associated with confidential information security and potential unauthorized access; fluctuations in quarterly net sales and operating results due to various factors; stock price volatility impacting investor confidence and employee retention; financial performance risks related to changes in foreign currency exchange rates affecting sales and earnings.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

examples/excel/dcf_rag.ipynb

@@ -0,0 +1,310 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "0db58db5-d4ee-4631-af5b-4fc53eb05170",
+   "metadata": {},
+   "source": [
+    "# RAG with Excel Spreadsheet using LlamaPrase\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/demo_excel.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "This notebook constructs a RAG pipeline over a simple DCF template [here](https://eqvista.com/app/uploads/2020/09/Eqvista_DCF-Excel-Template.xlsx).\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5f7d99ad-6ebd-47d0-92a7-566630b0c22a",
+   "metadata": {},
+   "source": [
+    "## Setup\n",
+    "\n",
+    "We first setup and load the data. If you haven't already, [download the template](https://eqvista.com/app/uploads/2020/09/Eqvista_DCF-Excel-Template.xlsx) and name it `dcf_template.xlxs` locally."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d867d1a6-cfcf-4f53-952a-f4a6ff2fa205",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index\n",
+    "%pip install llama-parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "103c7983-56d3-45be-b763-d1828d07c43e",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7b694b56-e04b-4d87-aa37-f0725d6b3adb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "# api_key = \"llx-\"  # get from cloud.llamaindex.ai"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9c4693c7-c1c8-47b4-8a8c-25d7e9ef9d2c",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 9332a14a-78d2-4392-bbe8-a271d7572cd1\n"
+     ]
+    }
+   ],
+   "source": [
+    "parser = LlamaParse(\n",
+    "    # api_key=api_key,  # can also be set in your env as LLAMA_CLOUD_API_KEY\n",
+    "    result_type=\"markdown\",\n",
+    ")\n",
+    "\n",
+    "documents = parser.load_data(\"./dcf_template.xlsx\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7302f1c8-e405-4cda-8ff7-1d55185816f7",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# DCF Model\n",
+      "\n",
+      "|Discounted Cash Flow Excel Template                                                                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|-----------|-----------|-----------------------|-----------|-----------------------|--------------|-----------|-----------|-----------|--------------|\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Here is a simple discounted cash flow excel template for estimating your company value based on this income valuation approach                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Instructions:                                                                                                                                                                              |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|1) Fill out the two assumptions in yellow highlight                                                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|2) Fill in either the 5 year or 3 year weighted average figures in yellow highlight                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Assumptions                                                                                                                                                                                |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Tax Rate                                                                                                                                                                                   |20%                           |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Discount Rate                                                                                                                                                                              |15%                           |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|5 Year Weighted Moving Average                                                                                                                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Indication of Company Value                                                                                                                                                                |$242,995.43                   |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|3 Year Weighted Moving Average                                                                                                                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Indication of Company Value                                                                                                                                                                |$158,651.07                   |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |5 Year Weighted Moving Average|           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Past Years                    |           |           |                       |           |Forecasted Future Years|              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Year 1                        |Year 2     |Year 3     |Year 4                 |Year 5     |Year 6                 |Year 7        |Year 8     |Year 9     |Year 10    |Terminal Value|\n",
+      "|Pre-tax income                                                                                                                                                                             |50,000.00                     |55,000.00  |45,000.00  |52,000.00              |60,000.00  |                       |              |           |           |           |              |\n",
+      "|Income Taxes                                                                                                                                                                               |10,000.00                     |11,000.00  |9,000.00   |10,400.00              |12,000.00  |                       |              |           |           |           |              |\n",
+      "|Net Income                                                                                                                                                                                 |40,000.00                     |44,000.00  |36,000.00  |41,600.00              |48,000.00  |                       |              |           |           |           |              |\n",
+      "|Depreciation Expense                                                                                                                                                                       |5,000.00                      |4,000.00   |3,000.00   |2,000.00               |1,000.00   |                       |              |           |           |           |              |\n",
+      "|Capital Expenditures                                                                                                                                                                       |10,000.00                     |8,000.00   |5,000.00   |5,000.00               |7,000.00   |                       |              |           |           |           |              |\n",
+      "|Debt Repayments                                                                                                                                                                            |5,000.00                      |5,000.00   |5,000.00   |5,000.00               |5,000.00   |                       |              |           |           |           |              |\n",
+      "|Net Cash Flow                                                                                                                                                                              |20,000.00                     |27,000.00  |23,000.00  |29,600.00              |35,000.00  |29,093.33              |29,817.78     |30,177.48  |30,469.23  |30,379.74  |287,188.00    |\n",
+      "|Discounting Factor                                                                                                                                                                         |                              |           |           |                       |           |0.8696                 |0.7561        |0.6575     |0.5718     |0.4972     |0.4972        |\n",
+      "|Present Value of Future Cash Flow                                                                                                                                                          |                              |           |           |                       |           |25,298.55              |22,546.52     |19,842.18  |17,420.88  |15,104.10  |142,783.19    |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |3 Year Weighted Moving Average|           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Past Years                    |           |           |Forecasted Future Years|           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Year 1                        |Year 2     |Year 3     |Year 4                 |Year 5     |Year 6                 |Terminal Value|           |           |           |              |\n",
+      "|Pre-tax income                                                                                                                                                                             |50,000.00                     |55,000.00  |45,000.00  |                       |           |                       |              |           |           |           |              |\n",
+      "|Income Taxes                                                                                                                                                                               |10,000.00                     |11,000.00  |9,000.00   |                       |           |                       |              |           |           |           |              |\n",
+      "|Net Income                                                                                                                                                                                 |40,000.00                     |44,000.00  |36,000.00  |                       |           |                       |              |           |           |           |              |\n",
+      "|Depreciation Expense                                                                                                                                                                       |5,000.00                      |4,000.00   |3,000.00   |                       |           |                       |              |           |           |           |              |\n",
+      "|Capital Expenditures                                                                                                                                                                       |10,000.00                     |8,000.00   |5,000.00   |                       |           |                       |              |           |           |           |              |\n",
+      "|Debt Repayments                                                                                                                                                                            |5,000.00                      |5,000.00   |5,000.00   |                       |           |                       |              |           |           |           |              |\n",
+      "|Net Cash Flow                                                                                                                                                                              |20,000.00                     |27,000.00  |23,000.00  |23,833.33              |24,083.33  |23,819.44              |158,253.59    |           |           |           |              |\n",
+      "|Discounting Factor                                                                                                                                                                         |                              |           |           |0.8696                 |0.7561     |0.6575                 |0.6575        |           |           |           |              |\n",
+      "|Present Value of Future Cash Flow                                                                                                                                                          |                              |           |           |20,724.64              |18,210.46  |15,661.67              |104,054.30    |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Notes:                                                                                                                                                                                     |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|-We based this simple discounted cash flow excel model based on the weighted moving averages (5 year or 3 year) for simplicity, in case a constant growth rate cannot be easily determined.|                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|-The factors such as Depreciation Expense, Capital Expense and Debt Repayments remain constant, so consider this when looking at the forecasted figures.                                   |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|-For the terminal value constant growth rate, we make the assumption of the growth from the last forecasted year compared to the first forecasted year. Adjust in the formula as needed.   |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(documents[1].get_content())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1aedd4bb-7939-4fbc-8f07-d362e24d9772",
+   "metadata": {},
+   "source": [
+    "## Ask Questions over this Data\n",
+    "\n",
+    "Now let's try asking some questions over this data!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f7c056a8-d098-4ebe-9341-d9f07081067c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.llms.openai import OpenAI\n",
+    "from llama_index.core import Settings\n",
+    "\n",
+    "llm = OpenAI(model=\"gpt-4-turbo-preview\")\n",
+    "Settings.llm = llm"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c0fa2630-ee1b-4ce7-91e9-f9ffff8347f9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import SummaryIndex\n",
+    "\n",
+    "index = SummaryIndex.from_documents([documents[1]])\n",
+    "\n",
+    "query_engine = index.as_query_engine()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a875a20e-a6b6-46b7-80d4-614546215ffc",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"Tell me about the income taxes in the past years (year 3-5) for the 5 year WMA table\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "06b0b072-f159-47c4-9cad-9f0cc0d56b28",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The income taxes in the past years (year 3 to year 5) for the 5-year Weighted Moving Average table are as follows: Year 3 - $9,000.00, Year 4 - $10,400.00, and Year 5 - $12,000.00.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "8bd0998f-4f7f-46f9-9b51-cfb510f384ee",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# DCF Model\n",
+      "\n",
+      "|Discounted Cash Flow Excel Template                                                                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|-----------|-----------|-----------------------|-----------|-----------------------|--------------|-----------|-----------|-----------|--------------|\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Here is a simple discounted cash flow excel template for estimating your company value based on this income valuation approach                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Instructions:                                                                                                                                                                              |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|1) Fill out the two assumptions in yellow highlight                                                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|2) Fill in either the 5 year or 3 year weighted average figures in yellow highlight                                                                                                        |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Assumptions                                                                                                                                                                                |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Tax Rate                                                                                                                                                                                   |20%                           |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Discount Rate                                                                                                                                                                              |15%                           |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|5 Year Weighted Moving Average                                                                                                                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Indication of Company Value                                                                                                                                                                |$242,995.43                   |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|3 Year Weighted Moving Average                                                                                                                                                             |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|Indication of Company Value                                                                                                                                                                |$158,651.07                   |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |                              |           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |5 Year Weighted Moving Average|           |           |                       |           |                       |              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Past Years                    |           |           |                       |           |Forecasted Future Years|              |           |           |           |              |\n",
+      "|                                                                                                                                                                                           |Year 1                        |Year 2     |Year 3     |Year 4                 |Year 5     |Year 6                 |Year 7        |Year 8     |Year 9     |Year 10    |Terminal Value|\n",
+      "|Pre-tax income                                                                                                                                                                             |50,000.00                     |55,000.00  |45,000.00  |52,000.00              |60,000.00  |                       |              |           |           |           |              |\n",
+      "|Income Taxes                                                                                                                                                                               |10,000.00                     |11,000.00  |9,000.00   |10,400.00              |12,000.00  |                       |              |           |           |           |              |\n",
+      "|Net Income                                                                                                                                                                                 |40,000.00                     |44,000.00  |36,000.00  |41,600.00              |48,000.00  |                       |              |           |           |           |              |\n",
+      "|Depreciation Expense                                                                                                                                                                       |5,000.00                      |4,000.00   |3,000.00   |2,000.00               |1,000.00   |                       |              |           |           |           |              |\n",
+      "|Capital Expenditures                                                                                                                                                                       |10,000.00                     |8,000.00   |5,000.00   |5,000.00               |7,000.00   |                       |              |           |           |           |              |\n",
+      "|Debt Repayments                                                                                                                                                                            |5,000.00                      |5,000.00   |5,000.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(response.source_nodes[0].get_content())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "fa699117-9867-4bb5-a290-30d35c59624f",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The discounting factors for years 4-6 in the 3-year weighted moving average scenario are 0.8696, 0.7561, and 0.6575, respectively.\n"
+     ]
+    }
+   ],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"Tell me about the discounting factors in years 4-6 for the 3 year WMA\"\n",
+    ")\n",
+    "print(str(response))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/other_files/demo_ppt_basic.ipynb

@@ -0,0 +1,390 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "e0647976-5597-4899-8678-e9a73c19f18b",
+   "metadata": {},
+   "source": [
+    "# LlamaParse over Powerpoint Files\n",
+    "\n",
+    "In this notebook we show you how to build a RAG pipeline over [our talk at PyData Global](https://docs.google.com/presentation/d/1rFQ0hPyYja3HKRdGEgjeDxr0MSE8wiQ2iu4mDtwR6fc/edit?usp=sharing) in 2023.\n",
+    "\n",
+    "We use LlamaParse to load in our slides in .pptx format, and use LlamaIndex to build a RAG pipeline over these files.\n",
+    "\n",
+    "**NOTE**: LlamaParse is capable of image extraction through JSON mode, in this notebook we stick with text."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "14cdcfaf-88b4-4489-9910-e362e0ccec53",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()\n",
+    "\n",
+    "from llama_parse import LlamaParse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "6f5b5841-dd3e-4169-9bd4-6a672b5b34ee",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2a619a1-fdd4-4ff0-85f8-94c125c275eb",
+   "metadata": {},
+   "source": [
+    "## Download Data\n",
+    "\n",
+    "First, download the slides from https://docs.google.com/presentation/d/1rFQ0hPyYja3HKRdGEgjeDxr0MSE8wiQ2iu4mDtwR6fc/edit?usp=sharing and export in .pptx format, and put it in the folder that you're running this notebook.\n",
+    "\n",
+    "Name the file `pydata_global.pptx`."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a7e697d9-4463-4be4-908c-0a3e9179a342",
+   "metadata": {},
+   "source": [
+    "## [Basic] Build a RAG Pipeline over Powerpoint Text\n",
+    "\n",
+    "In this example, we use LlamaParse in markdown mode to extract out text from the slides, and we build a top-k RAG pipeline over it.\n",
+    "\n",
+    "**Notes**: \n",
+    "- This does not use our `MarkdownElementNodeParser`, which is tailored for documents with tables.\n",
+    "- This also does not parse out images (we show that in the next section).\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0dd0f860-8e92-43a7-9443-ad1a4fb9365c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "parser = LlamaParse(result_type=\"markdown\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "fd932bef-ba82-4449-b7a0-5c2a9b55089f",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 9c687e37-4239-4c2f-b2a1-2564bfc98473\n"
+     ]
+    }
+   ],
+   "source": [
+    "docs = parser.load_data(\"pydata_global.pptx\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0f41c2bc-02cd-49b5-a98c-f986faa8fffc",
+   "metadata": {},
+   "source": [
+    "Let's take a look at a few slides."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2a73e553-2194-4ac9-9764-0edab0d6fdce",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Building and Productionizing RAG\n",
+      "\n",
+      "Jerry Liu, LlamaIndex co-founder/CEO\n",
+      "---\n",
+      "|Content|Page Number|\n",
+      "|---|---|\n",
+      "|Document Processing| |\n",
+      "|Tagging & Extraction| |\n",
+      "|Knowledge Base| |\n",
+      "|Knowledge Search & QA| |\n",
+      "|Workflow:| |\n",
+      "|Read latest messages from user A| |\n",
+      "|Send email suggesting next-steps| |\n",
+      "|Document| |\n",
+      "|Human:| |\n",
+      "|Agent:| |\n",
+      "|Topic:| |\n",
+      "|Summary:| |\n",
+      "|Author:| |\n",
+      "|Conversational Agent| |\n",
+      "|Workflow Automation| |\n",
+      "---\n",
+      "Context\n",
+      "\n",
+      "- LLMs are a phenomenal piece of technology for knowledge generation and reasoning. They are pre-trained on large amounts of publicly available data.\n",
+      "\n",
+      "Use Cases\n",
+      "\n",
+      "- Question-Answering\n",
+      "- Text Generation\n",
+      "- Summarization\n",
+      "- Planning\n",
+      "\n",
+      "# LLM’s\n",
+      "---\n",
+      "|Context|\n",
+      "|---|\n",
+      "|How do we best augment LLMs with our own private data?|\n",
+      "|Raw Files|API’s|\n",
+      "| |salesforce|?|\n",
+      "| | |Use Cases|\n",
+      "| | |Question-Answering|\n",
+      "| | |Text Generation|\n",
+      "| | |Summarization|\n",
+      "|Vector Stores|SQL DB’s|\n",
+      "| | |Planning|\n",
+      "| |LLM’s|\n",
+      "| |Milvus|\n",
+      "---\n",
+      "Paradigms for inserting knowledge\n",
+      "\n",
+      "Retrieval Augmentation - Fix pe model, put context into pe prompt\n",
+      "Before college pe two main pings I worked on, outside of school, were writing and programming. I didn't write essays. I wrote what beginning writers were supposed to write pen, and probably still are: short stories. My stories were awful. They had hardly any plot, just characters wip strong feelings, which I imagined made pem deep...\n",
+      "\n",
+      "Input Prompt\n",
+      "\n",
+      "Here is the context:\n",
+      "\n",
+      "Before college the two main things...\n",
+      "\n",
+      "Given the context, answer the following question:\n",
+      "\n",
+      "{query_str} LLM\n",
+      "---\n",
+      "Paradigms for inserting knowledge\n",
+      "\n",
+      "Fine-tuning - baking knowledge into pe weights of pe network\n",
+      "Before college pe two main pings I worked on, outside of school, were writing and programming. I didn't write essays. I wrote what beginning writers were supposed to write pen, and probably still are: short stories. My stories were awful. They had hardly any plot, just characters wip strong feelings, which I imagined made pem deep... LLM RLHF, Adam, SGD, etc.\n",
+      "---\n",
+      "## LlamaIndex: A data framework for LLM applications\n",
+      "\n",
+      "|Data Ingestion (LlamaHub 🦙)|Data Structures|Queries|\n",
+      "|---|---|---|\n",
+      "|Connect your existing data sources and data formats (API’s, PDF’s, docs, SQL, etc.)|Store and index your data for different use cases. Integrate with different db’s (vector db, graph db, kv db)|Retrieve and query over data. Includes: QA, Summarization, Agents, and more|\n",
+      "---\n",
+      "# quickstart py\n",
+      "\n",
+      "from Llama_index import VectorStoreIndex, SimpleDirectoryReader\n",
+      "\n",
+      "SimpleDirectoryReader( ' data' ) . Load_datal)\n",
+      "\n",
+      "documents\n",
+      "\n",
+      "VectorStoreIndex.from_documents\n",
+      "\n",
+      "indexdocuments_\n",
+      "\n",
+      "index.as_query_engine()\n",
+      "\n",
+      "query_engine\n",
+      "\n",
+      "query_engine.query ( \"What did the authordo growingup?\" )\n",
+      "\n",
+      "response\n",
+      "\n",
+      "print(str(response) )Codelmage\n",
+      "---\n",
+      "NO_CONTENT_HERE\n",
+      "---\n",
+      "|Data Ingestion / Parsing|Data Querying|\n",
+      "|---|---|\n",
+      "|Chunk| |\n",
+      "|Chunk| |\n",
+      "|Doc|Chunk|\n",
+      "|Chunk|Chunk|\n",
+      "| |Vector|Chunk|LLM|\n",
+      "| | |Database|\n",
+      "|Chunk| |\n",
+      "| |5 Lines of Code in LlamaIndex!|\n",
+      "---\n",
+      "|Current RAG Stack (Data Ingestion/Parsing)|Process:|\n",
+      "|---|---|\n",
+      "|● Split up document(s) into even chunks.| |\n",
+      "|● Each chunk is a piece of raw text.| |\n",
+      "|Chunk|● Generate embedding for each chunk (e.g. OpenAI embeddings, sentence_transformer)|\n",
+      "|Chunk|● Store each chunk into a vector database|\n",
+      "|Doc|Chunk|\n",
+      "|Chunk|Vector Database|\n",
+      "|Chunk| |\n",
+      "---\n",
+      "|Current RAG Stack (Querying)|\n",
+      "|---|\n",
+      "|Process:|\n",
+      "|● Find top-k most similar chunks from vector database collection|\n",
+      "|● Plug into LLM response synthesis module|\n",
+      "|Chunk|Chunk|LLM|\n",
+      "|Vector|Chunk| |\n",
+      "|Database|\n",
+      "---\n",
+      "|Current RAG Stack (Querying)|\n",
+      "|---|\n",
+      "|Process:|\n",
+      "|● Find top-k most similar chunks from vector database collection|\n",
+      "|● Plug into LLM response synthesis module|\n",
+      "|Chunk|LLM|\n",
+      "|Chunk|\n",
+      "|Vector|\n",
+      "|Database|\n",
+      "|Retrieval|Synthesis|\n",
+      "---\n",
+      "|Query|Nodel|Response|Nodez|\n",
+      "|---|---|---|---|\n",
+      "|Create and Refine|Intermediate| | |\n",
+      "| | |Final|Response|\n",
+      "---\n",
+      "|Query|Node1|Node2|Node3|Node4|\n",
+      "|---|---|---|---|---|\n",
+      "|Tree Summarize| | | | |\n",
+      "---\n",
+      "Quickstart\n",
+      "\n",
+      "Link to Google Colab\n",
+      "---\n",
+      "NO_CONTENT_HERE\n",
+      "---\n",
+      "# Challenges with Naive RAG\n",
+      "\n",
+      "- Failure Modes\n",
+      "- Quality-Related (Hallucination, Accuracy)\n",
+      "- Non-Quality-Related (Latency, Cost, Syncing)\n",
+      "---\n",
+      "## Challenges with Naive RAG (Response Quality)\n",
+      "\n",
+      "|Bad Retrieval|Low Precision: Not all chunks in retrieved set are relevant|Hallucination + Lost in the Middle Problems|\n",
+      "|---|---|---|\n",
+      "| |Low Recall: Now all relevant chunks are retrieved.|Lacks enough context for LLM to synthesize an answer|\n",
+      "| |Outdated information: The data is redundant or out of date.| |\n",
+      "---\n",
+      "## Challenges with Naive RAG (Response Quality)\n",
+      "\n",
+      "|Bad Retrieval|Low Precision: Not all chunks in retrieved set are relevant|Hallucination + Lost in the Middle Problems|\n",
+      "|---|---|---|\n",
+      "| |Low Recall: Now all relevant chunks are retrieved.|Lacks enough context for LLM to synthesize an answer|\n",
+      "| |Outdated information: The data is redundant or out of date.| |\n",
+      "|Bad Response Generation|Hallucination: Model makes up an answer that isn’t in the context.| |\n",
+      "| |Irrelevance: Model makes up an answer that doesn’t answer the question.| |\n",
+      "| |Toxicity/Bias: Model makes up an answer t\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(docs[0].get_content()[:5000])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c2fa0a1a-1ed8-4a5a-a0c1-5792fe32634b",
+   "metadata": {},
+   "source": [
+    "## Build a RAG pipeline over these documents\n",
+    "\n",
+    "We now use LlamaIndex to build a RAG pipeline over these powerpoint slides."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c779547f-e4f7-4c84-9786-2b6b749827ab",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import VectorStoreIndex"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "68b3a95e-ce19-4df1-9fdd-e6efb2fc423a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "index = VectorStoreIndex.from_documents(docs)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a2ae28f6-4b3a-4130-8e65-0921b7678739",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = index.as_query_engine()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "232091ee-aa22-4f51-838c-410024acc344",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"What are some response quality challenges with naive RAG?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "75f32aa7-c308-4221-af60-779822cfdba1",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Some response quality challenges with naive RAG include issues related to bad retrieval, such as low precision where not all retrieved chunks are relevant, leading to problems like hallucination and being lost in the middle. Additionally, low recall can occur when not all relevant chunks are retrieved, resulting in a lack of sufficient context for the language model to synthesize an answer. Outdated information in the retrieved data can also pose a challenge. On the response generation side, challenges include hallucination where the model generates an answer not present in the context, irrelevance where the answer does not address the question, and toxicity/bias where the answer is harmful or offensive.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/other_files/demo_ppt_financial.ipynb

@@ -0,0 +1,335 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# LlamaParse - Parsing Financial Powerpoints 📊\n",
+    "\n",
+    "In this cookbook we show you how to use LlamaParse to parse a financial powerpoint."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Installation\n",
+    "\n",
+    "Parsing instruction are part of the LlamaParse API. They can be access by directly specifying the parsing_instruction parameter in the API or by using LlamaParse python module (which we will use for this tutorial).\n",
+    "\n",
+    "To install llama-parse, just get it from `pip`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install llama-index\n",
+    "%pip install llama-parse\n",
+    "%pip install torch transformers python-pptx Pillow"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## API Key\n",
+    "\n",
+    "The use of LlamaParse requires an API key which you can get here: https://cloud.llamaindex.ai/parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"llx-...\"\n",
+    "os.environ[\"OPENAI_API_KEY\"] = \"sk-...\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "**NOTE**: Since LlamaParse is natively async, running the sync code in a notebook requires the use of nest_asyncio.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Importing the package\n",
+    "\n",
+    "To import llama_parse simply do:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using LlamaParse to Parse Presentations\n",
+    "\n",
+    "Like Powerpoints, presentations are often hard to extract for RAG. With LlamaParse we can now parse them and unclock their content of presentations for RAG.\n",
+    "\n",
+    "Let's download a financial report from the World Meteorological Association."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "! mkdir data; wget \"https://meetings.wmo.int/Cg-19/PublishingImages/SitePages/FINAC-43/7%20-%20EC-77-Doc%205%20Financial%20Statements%20for%202022%20(FINAC).pptx\" -O data/presentation.pptx"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Parsing the presentation\n",
+    "\n",
+    "Now let's parse it into Markdown with LlamaParse and the default LlamaIndex parser.\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Llama Index default"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import SimpleDirectoryReader\n",
+    "\n",
+    "vanilla_documents = SimpleDirectoryReader(\"./data/\").load_data()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### Llama Parse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 56724c0d-e45a-4e30-ae8c-e416173c608a\n"
+     ]
+    }
+   ],
+   "source": [
+    "llama_parse_documents = LlamaParse(result_type=\"markdown\").load_data(\n",
+    "    \"./data/presentation.pptx\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's take a look at the parsed output from an example slide (see image below).\n",
+    "\n",
+    "As we can see the table is faithfully extracted!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ation and mitigation\n",
+      "---\n",
+      "|Item|31 Dec 2022|31 Dec 2021|Change|\n",
+      "|---|---|---|---|\n",
+      "|Payables and accruals|4,685|4,066|619|\n",
+      "|Employee benefits|127,215|84,676|42,539|\n",
+      "|Contributions received in advance|6,975|10,192|(3,217)|\n",
+      "|Unearned revenue from exchange transactions|20|651|(631)|\n",
+      "|Deferred Revenue|71,301|55,737|15,564|\n",
+      "|Borrowings|28,229|29,002|(773)|\n",
+      "|Funds held in trust|30,373|29,014|1,359|\n",
+      "|Provisions|1,706|1,910|(204)|\n",
+      "|Total Liabilities|270,504|215,248|55,256|\n",
+      "---\n",
+      "## Liabilities\n",
+      "\n",
+      "Employee Ben\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(llama_parse_documents[0].get_content()[-2800:-2300])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Compared against the original slide image.\n",
+    "![Demo](demo_ppt_financial_1.png)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Comparing the two for RAG\n",
+    "\n",
+    "The main difference between LlamaParse and the previous directory reader approach, it that LlamaParse will extract the document in a structured format, allowing better RAG."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Query Engine on SimpleDirectoryReader results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_index.core import VectorStoreIndex, SimpleDirectoryReader\n",
+    "\n",
+    "vanilla_index = VectorStoreIndex.from_documents(vanilla_documents)\n",
+    "vanilla_query_engine = vanilla_index.as_query_engine()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Query Engine on LlamaParse Results\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "llama_parse_index = VectorStoreIndex.from_documents(llama_parse_documents)\n",
+    "llama_parse_query_engine = llama_parse_index.as_query_engine()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Liability provision\n",
+    "What was the liability provision as of Dec 31 2021?\n",
+    "\n",
+    "<!-- <img src=\"https://drive.usercontent.google.com/download?id=184jVq0QyspDnmCyRfV0ebmJJxmAOJHba&authuser=0\" /> -->"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The liability provision as of December 31, 2021, included Employee Benefit Liabilities, Contributions received in advance (assessed contributions), and Deferred revenue.\n"
+     ]
+    }
+   ],
+   "source": [
+    "vanilla_response = vanilla_query_engine.query(\n",
+    "    \"What was the liability provision as of Dec 31 2021?\"\n",
+    ")\n",
+    "print(vanilla_response)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The liability provision as of December 31, 2021, was 1,910 CHF.\n"
+     ]
+    }
+   ],
+   "source": [
+    "llama_parse_response = llama_parse_query_engine.query(\n",
+    "    \"What was the liability provision as of Dec 31 2021?\"\n",
+    ")\n",
+    "print(llama_parse_response)"
+   ]
+  }
+ ],
+ "metadata": {
+  "colab": {
+   "provenance": []
+  },
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

examples/test_tesla_impact_report/test_gpt4o.ipynb

@@ -0,0 +1,720 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "f20600ce-d57a-446e-b033-3aadeec39c1b",
+   "metadata": {},
+   "source": [
+    "# LlamaParse with GPT-4o\n",
+    "\n",
+    "\n",
+    "<a href=\"https://colab.research.google.com/github/run-llama/llama_parse/blob/main/examples/test_tesla_impact_report/test_gpt4o.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>\n",
+    "\n",
+    "GPT-4o is a [fully multimodal model by OpenAI](https://openai.com/index/hello-gpt-4o/) released in May 2024. It matches GPT-4 Turbo performance in text and code, and has significantly improved vision and audio capabilities.\n",
+    "\n",
+    "The expanded vision/audio capabilities mean that it can be used for document parsing, by treating each page as an image and performing document extraction. We support using GPT-4o natively in LlamaParse for document parsing. The notebook below walks you through an example of using GPT-4o over the Tesla impact report.\n",
+    "\n",
+    "**NOTE**: The pricing for LlamaParse + gpt4o is an order more expensive than using LlamaParse by default. Currently, every page parsed with gpt4o counts for 10 pages in the LlamaParse usage tracker.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "86b173ac-9fce-4813-bdf1-6dd7d93a491d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import nest_asyncio\n",
+    "\n",
+    "nest_asyncio.apply()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ecc5eba5-96ce-4db7-bba1-f9ece33e681c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b805592b-d1a5-4cd2-b916-348f66ca7941",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "os.environ[\"LLAMA_CLOUD_API_KEY\"] = \"<LLAMA_CLOUD_API_KEY>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e73e3c4-9e09-4cba-805f-326c82be812d",
+   "metadata": {},
+   "source": [
+    "### Use LlamaParse with `gpt4o_mode=True`\n",
+    "\n",
+    "By turning on gpt4o, we use GPT-4o multimodal capabilities to do document parsing per page instead of the LlamaParse default pipeline.\n",
+    "\n",
+    "We load a snippet of the [2019 Tesla impact report](https://www.tesla.com/ns_videos/2019-tesla-impact-report.pdf). **NOTE**: The report is 57 pages, but will count for 570 pages in LlamaParse due to GPT-4o usage (which is approximately $1.71 USD).\n",
+    "\n",
+    "You can optionally choose to provide a `gpt4o_api_key`. If you do this, then we will use your API key to make GPT-4o calls, and your LlamaParse usage will be counted as if `gpt4o_mode` was not turned on (each page will be counted as a page instead of 10 pages). "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "aaa2ec5d-f27c-4262-80bf-e57daacff182",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "--2024-05-21 00:10:32--  https://www.dropbox.com/scl/fi/vu6w1dsfo5eddydz13ssm/2019-tesla-impact-report-15.pdf?rlkey=ik8lfqbg2p1ervss4qqt3xose&st=70j04z8j&dl=1\n",
+      "Resolving www.dropbox.com (www.dropbox.com)... 2620:100:6057:18::a27d:d12, 162.125.13.18\n",
+      "Connecting to www.dropbox.com (www.dropbox.com)|2620:100:6057:18::a27d:d12|:443... connected.\n",
+      "HTTP request sent, awaiting response... 302 Found\n",
+      "Location: https://uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com/cd/0/inline/CTTnZs8U4V1GtUCNxoB7INwmLq2yU97Q6QbWS6uVnb_XdHe368GrqF0zLDEKTnpc-x7utwNUUpMvWjLyrujrqNVrbGKTKa6hwHu5BxYPA2zXYrzdAEZyeve274xpHZKFywQ/file?dl=1# [following]\n",
+      "--2024-05-21 00:10:33--  https://uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com/cd/0/inline/CTTnZs8U4V1GtUCNxoB7INwmLq2yU97Q6QbWS6uVnb_XdHe368GrqF0zLDEKTnpc-x7utwNUUpMvWjLyrujrqNVrbGKTKa6hwHu5BxYPA2zXYrzdAEZyeve274xpHZKFywQ/file?dl=1\n",
+      "Resolving uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com (uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com)... 2620:100:6057:15::a27d:d0f, 162.125.13.15\n",
+      "Connecting to uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com (uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com)|2620:100:6057:15::a27d:d0f|:443... connected.\n",
+      "HTTP request sent, awaiting response... 302 Found\n",
+      "Location: /cd/0/inline2/CTSaARDHbxvyEEgefshmsHLbuXkgV1Rmr-ItVhk5lPuZXkLlNnZMZWCF9YF5j4t2lLs4VurFW2VI1Q4A6ZFi8D2RXJmUG3wdgJhR6qSaBpwRZxjB_vk8qkJb8h1jRDaL7ATK6XYTHncab_aoPWzB62vrZ9yXUM0Mr-EdCX1k-hMbzXLV2dorA71IuFPY8ICkTemRWaG6VhBd3bV0C5AkMsAqy90w6Kez1ySFO06UkrxLSmkCaKdFgVoLcUVO2PLv4rGv6AuZOF_kqwsHdh82J9DQU4PMMyg-f5ChSGGSCKgmUfTBE2qP1eISP-GXSB91yWwMf-7rxGtM8MpDp-AL5jxYZxhZcmZn1cU8Or_8OOZrxg/file?dl=1 [following]\n",
+      "--2024-05-21 00:10:33--  https://uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com/cd/0/inline2/CTSaARDHbxvyEEgefshmsHLbuXkgV1Rmr-ItVhk5lPuZXkLlNnZMZWCF9YF5j4t2lLs4VurFW2VI1Q4A6ZFi8D2RXJmUG3wdgJhR6qSaBpwRZxjB_vk8qkJb8h1jRDaL7ATK6XYTHncab_aoPWzB62vrZ9yXUM0Mr-EdCX1k-hMbzXLV2dorA71IuFPY8ICkTemRWaG6VhBd3bV0C5AkMsAqy90w6Kez1ySFO06UkrxLSmkCaKdFgVoLcUVO2PLv4rGv6AuZOF_kqwsHdh82J9DQU4PMMyg-f5ChSGGSCKgmUfTBE2qP1eISP-GXSB91yWwMf-7rxGtM8MpDp-AL5jxYZxhZcmZn1cU8Or_8OOZrxg/file?dl=1\n",
+      "Reusing existing connection to [uc872df1ff4ea2fecd3d024fa97a.dl.dropboxusercontent.com]:443.\n",
+      "HTTP request sent, awaiting response... 200 OK\n",
+      "Length: 26199694 (25M) [application/binary]\n",
+      "Saving to: ‘2019-tesla-impact-report-15.pdf’\n",
+      "\n",
+      "2019-tesla-impact-r 100%[===================>]  24.99M  30.5MB/s    in 0.8s    \n",
+      "\n",
+      "2024-05-21 00:10:35 (30.5 MB/s) - ‘2019-tesla-impact-report-15.pdf’ saved [26199694/26199694]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "!wget \"https://www.dropbox.com/scl/fi/vu6w1dsfo5eddydz13ssm/2019-tesla-impact-report-15.pdf?rlkey=ik8lfqbg2p1ervss4qqt3xose&st=70j04z8j&dl=1\" -O \"2019-tesla-impact-report-15.pdf\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f46991c1-031b-461f-b9a6-9237a821f4c8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from llama_parse import LlamaParse\n",
+    "\n",
+    "parser_gpt4o = LlamaParse(\n",
+    "    result_type=\"markdown\",\n",
+    "    # api_key=api_key,\n",
+    "    gpt4o_mode=True,\n",
+    "    # gpt4o_api_key=\"<gpt4o_api_key>\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1136ba82-074b-489d-9b0a-d609ccbf02b6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Started parsing the file under job_id 1a934a50-59a9-4bb4-bbb7-ecefff228537\n"
+     ]
+    }
+   ],
+   "source": [
+    "documents_gpt4o = parser_gpt4o.load_data(\"./2019-tesla-impact-report-15.pdf\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9e65c54f-3e4c-4c78-b1e8-a55ebeba1f24",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Impact Report\n",
+      "## 2019\n",
+      "\n",
+      "![Earth and Tesla Car in Space](image-url)\n",
+      "\n",
+      "TESLA\n",
+      "---\n",
+      "# Introduction 03\n",
+      "\n",
+      "# Mission and Tesla Ecosystem 04\n",
+      "\n",
+      "# Environmental Impact 06\n",
+      "- Lifecycle Analysis of Tesla Vehicles versus Average ICE\n",
+      "- Battery Recycling\n",
+      "- NOx, Particulates and Other Pollutants\n",
+      "- Water Used per Vehicle Manufactured\n",
+      "- Emissions Credits\n",
+      "- Net Energy Impact of Our Products\n",
+      "\n",
+      "# Product Impact 20\n",
+      "- Price Equivalency\n",
+      "- Primary Driver\n",
+      "- Long Distance Travel\n",
+      "- Active Safety\n",
+      "- Passive Safety\n",
+      "- Tesla Safety Awards\n",
+      "- Fire Safety\n",
+      "- Cyber Security\n",
+      "- Disaster Relief\n",
+      "- Resilience of the Grid\n",
+      "- Megapack\n",
+      "- Solar Roof\n",
+      "\n",
+      "# Supply Chain 33\n",
+      "- Responsible Material Sourcing\n",
+      "- Cobalt Sourcing\n",
+      "\n",
+      "# People and Culture 37\n",
+      "- Our Environmental, Health, and Safety Strategy\n",
+      "- Safety Improvements\n",
+      "- Case Study: Ergonomics and Model Y Design\n",
+      "- Rewarding the Individual\n",
+      "- Culture of Diversity and Inclusion\n",
+      "- Workforce Development\n",
+      "- Community Engagement\n",
+      "- Employee Mobility and Transportation Programs\n",
+      "- Corporate Governance\n",
+      "\n",
+      "# Appendix 52\n",
+      "---\n",
+      "# Introduction\n",
+      "\n",
+      "The very purpose of Tesla’s existence is to accelerate the world’s transition to sustainable energy. In furtherance of this mission, we are excited to publish our second annual Impact Report. Transparency and disclosure are important for our customers, employees, and shareholders, which is why we have expanded the Impact Report’s content this year.\n",
+      "\n",
+      "While many environmental reports focus on emissions generated by the manufacturing phase of products and future goals for energy consumption, we highlight the totality of the environmental impact of our products today. After all, the vast majority of emissions generated by vehicles today occur in the product-use phase—that is, when consumers are driving their vehicles. We believe that providing information on both sides of the manufacturing and consumer-use equation provides a clearer picture of the environmental impact of Tesla products, and we have done so this year largely through a lifecycle analysis detailed in this report.\n",
+      "\n",
+      "Tesla aims to continue to increase the proportion of renewable energy usage at our factories in an effort to minimize the carbon footprint for every mile traveled by our products and their components in our supply chain. All of the factories that we built from the ground-up, such as Gigafactory Nevada and Gigafactory Shanghai, and our forthcoming Gigafactories in Berlin and North America, are designed from the beginning to use energy from renewable sources.\n",
+      "\n",
+      "Making a significant and lasting impact on environmental sustainability is difficult to achieve without securing financial sustainability for the long term. We generated positive Free Cash Flow (operating cash flow less capex) of more than $1 billion for the first time in 2019. We believe the notion that a sustainable future is not economically feasible is no longer valid.\n",
+      "---\n",
+      "# Mission & Tesla Ecosystem\n",
+      "\n",
+      "Climate change is reaching alarming levels in large part due to emissions from burning fossil fuels for transportation and electricity generation. In 2016, carbon dioxide (CO2) concentration levels in the atmosphere exceeded the 400 parts per million threshold on a sustained basis - a level that climate scientists believe will have a catastrophic impact on the environment. Worse, annual global CO2 emissions continue to increase and have approximately doubled over the past 50 years to over 43 gigatons in 2019. The world’s current path is unwise and unsustainable.\n",
+      "\n",
+      "The world cannot reduce CO2 emissions without addressing both energy generation and consumption. And the world cannot address its energy habits without first directly reducing emissions in the transportation and energy sectors. We are focused on creating a complete energy and transportation ecosystem from solar generation and energy storage to all-electric vehicles that produce zero tailpipe emissions.\n",
+      "\n",
+      "Since the onset of shelter-in-place orders and travel restrictions due to COVID-19, we have seen dramatic increases in air quality across the planet, as well as projections for CO2 emissions to drop in excess of 4% in 2020 compared to pre-COVID-19 levels, according to researchers. Because these improvements in air quality and reductions in CO2 are a result of a global economic disruption and not due to systemic changes in how we produce and consume energy, they are not expected to be sustained absent intervention. However, these changes have shown us the positive impacts of reduced pollution in a very short period of time. At Tesla, we believe that we all have an unprecedented opportunity to learn from this disruption and accelerate the deployment of clean energy solutions as part of a recovery for all economies throughout the world, and we will actively continue to advocate for the realization of these long-term changes.\n",
+      "\n",
+      "## Global Greenhouse Gas (GHG) Emissions by Economic Sector\n",
+      "\n",
+      "| Sector                                      | Percentage |\n",
+      "|---------------------------------------------|------------|\n",
+      "| Electricity & Heat Production*              | 31%        |\n",
+      "| Agriculture, Forestry & Other Land Use      | 20%        |\n",
+      "| Industry                                    | 18%        |\n",
+      "| Transportation*                             | 16%        |\n",
+      "| Other Energy                                | 9%         |\n",
+      "| Buildings                                   | 6%         |\n",
+      "\n",
+      "*Tesla-related sectors. Source: World Resources Institute\n",
+      "\n",
+      "According to the Global Carbon project, when fully tallied, total carbon emissions from 2019 are expected to hit another record high of over 43 gigatons for the year. Energy use through electricity and heat production (31%) and transportation (16%) are significant drivers of these GHG emissions.\n",
+      "---\n",
+      "# Mission & Tesla Ecosystem\n",
+      "\n",
+      "To create an entire sustainable energy ecosystem, Tesla also manufactures a unique set of energy products that enable homeowners, businesses and utilities to produce and manage renewable energy generation, storage and consumption. Homeowners can install solar panels or Solar Roof to power their home using 100% renewable energy and then store that energy in Powerwall, which makes electricity available during peak energy-use periods and at night, while also providing power during grid outages. Meanwhile, depending on their particular requirements and the size of the project, utilities and businesses can purchase Megapack – an infinitely scalable energy storage system that provides greater control, efficiency, and reliability across the electric grid – for their energy storage needs.\n",
+      "\n",
+      "Renewable energy generation and storage are critical components of developing microgrids — an increasingly important means of delivering reliable and sustainable electricity around the world. As the deployment of Tesla’s products continues to accelerate, we can scale the adoption of renewable energy, cost-effectively modernize our aging infrastructure (while becoming less reliant on it), and improve the resilience of the electric grid to benefit everyone.\n",
+      "---\n",
+      "# Environmental Impact\n",
+      "---\n",
+      "# Introduction\n",
+      "\n",
+      "In this section of the Impact Report, we will go through the details and calculations of the lifetime environmental impact of our products.\n",
+      "\n",
+      "We are often asked if electric vehicles (EVs) are more sustainable than internal combustion engine (ICE) vehicles. The environmental impact of zero-emission transport and energy products, like the products that Tesla produces and sells, is undeniably more positive than the GHG-emitting alternatives. However, determining the lifetime impact of EVs versus ICE vehicles requires looking at the entire lifecycle - from raw materials to emissions to disposal and not just at the emissions resulting from vehicle usage.\n",
+      "\n",
+      "This is not a straightforward task and some of the most common omissions that we have seen in similar studies include the following:\n",
+      "\n",
+      "a) Using Worldwide Harmonized Light Vehicle Test Procedure (WLTP) or Environmental Protection Agency (EPA) fuel/energy consumption data (which overestimate fuel-economy and underestimate emissions), rather than real-world data;\n",
+      "\n",
+      "b) Not taking into account the higher energy efficiency of Tesla’s powertrains;\n",
+      "\n",
+      "c) Assuming that the average EV needs a battery replacement at some point in its life;\n",
+      "\n",
+      "d) Not accounting for emissions generated through oil refining and the transportation process; and\n",
+      "\n",
+      "e) Using outdated data for the carbon impact of cell manufacturing.\n",
+      "\n",
+      "We tried to address these considerations and complexities in deriving a more accurate calculation in the following lifecycle analysis.\n",
+      "\n",
+      "It is important to remember that environmental impact goes beyond just carbon footprint. According to the World Health Organization (WHO), more than four million people die of air pollution every year. The reduction of Nitrogen Oxides (NOx) and other particulates in the air makes our communities healthier places to live, work, and visit and is another core benefit of driving an EV.\n",
+      "\n",
+      "In addition, solar panels deployed by Tesla (including SolarCity prior to its 2016 acquisition by Tesla) over the years have generated vastly more electricity than what was required to run our factories and related facilities.\n",
+      "---\n",
+      "# Lifecycle Analysis of Tesla EVs versus Average ICE Vehicles\n",
+      "\n",
+      "## 69 tons\n",
+      "Lifetime CO2 emitted by an average combustion engine vehicle (model year 2019) sold in the U.S. through its use phase, excluding CO2 emitted during the oil refining phase.\n",
+      "\n",
+      "---\n",
+      "\n",
+      "On the right and in the following pages we have laid out our lifecycle analysis, which includes the emissions per mile from:\n",
+      "\n",
+      "- A current Fremont-made Model 3 charged from a grid with the generation mix that reflects the geographic distribution of Model 3 deliveries in the U.S.\n",
+      "- What emissions per mile could be if the Model 3 were used for ridesharing over one million miles using cell chemistry from our energy products.\n",
+      "- What emissions per mile could be if a Model 3 were principally charged at home using a solar system and energy storage.\n",
+      "- What emissions per mile could be if a Model 3 were used for ridesharing over one million miles using cell chemistry from our energy products and if it were only charged using a solar system and energy storage.\n",
+      "- The reference ICE vehicle is based on the average mid-size premium sedan in the U.S.\n",
+      "\n",
+      "---\n",
+      "\n",
+      "The most important variable in a life cycle analysis is real-world fuel consumption or electricity consumption, which impacts the use phase of the lifecycle. Various efficiency testing cycles such as the New European Driving Cycle (NEDC), WLTP, or EPA don’t truly represent real-world fuel/energy consumption. This is why, for the purpose of this analysis, we used average energy consumption over the more than 4 billion miles Tesla Model 3s have travelled to date, including energy losses during the charging process. For ICE vehicles, we used real-world fuel consumption data provided by Consumer Reports, according to which mid-size premium sedans for model year 2019 on average achieve 23.6 MPG, and this translates to approximately 420 grams of CO2 per mile, once we account for emissions generated through extraction, refining, and shipment of oil.\n",
+      "\n",
+      "Even if we use the official EPA efficiency rating (instead of real-world data) for a Toyota Prius of 56 MPG, which translates to 177 grams of CO2 per mile (incl. refining & transport of oil), an EV would still emit fewer lifetime emissions than the Prius. Regarding mileage and lifespan, we estimate that an average vehicle in the U.S. is driven slightly less than 12,000 miles per year for about 17 years before it is scrapped. Furthermore, as an ICE vehicle ages, its fuel efficiency only remains stable if serviced properly. On the other hand, electricity generation to charge EVs has become “greener” over time with the addition of cleaner energy sources to the grid. Thus, emissions generated through EV charging should continue to decline over time.\n",
+      "\n",
+      "It is important to highlight that, for the purpose of this analysis, we assumed no additional renewable energy capacity on the grid during the life of the vehicle given the shape of the renewable energy adoption curve in the U.S. is still very much up for debate. That said, in the following slide we show that a Tesla Model 3 charged in locations with “greener” grids like New York state, for example, have much lower lifecycle emissions than the U.S. average. We believe that cities, states, and countries alike will strive to reduce grid emissions in the future. This dynamic highlights how EVs on the road today will become cleaner as they age and how critical “greening” the grid will be to achieving reduced transportation emissions.\n",
+      "\n",
+      "---\n",
+      "\n",
+      "## Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "|                    | Manufacturing Phase | Use Phase |\n",
+      "|--------------------|---------------------|-----------|\n",
+      "| Model 3 Ridesharing Use (solar charged) |  |  |\n",
+      "| Model 3 Personal Use (solar charged) |  |  |\n",
+      "| Model 3 Ridesharing Use (grid charged) |  |  |\n",
+      "| Model 3 Personal Use (grid charged) |  |  |\n",
+      "| Avg. Mid-Size Premium ICE |  |  |\n",
+      "\n",
+      "![Bar Chart](https://i.imgur.com/8J5J5J5.png)\n",
+      "---\n",
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Increasing Proportion of Renewable Energy Sources\n",
+      "\n",
+      "Charging a Model 3 using solar panels and a Powerwall adds emissions to the manufacturing phase while reducing use phase emissions as low as zero when 100% of charging is done using that system. The personal use scenario below assumes 18% of charging is done using the public fast-charging network, based on observed fleet behavior.\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "|                    | Manufacturing Phase | Use Phase |\n",
+      "|--------------------|---------------------|-----------|\n",
+      "| Avg. Mid-Size Premium ICE |                     |           |\n",
+      "| Model 3 Personal Use (grid charged) |                     |           |\n",
+      "| Model 3 Ridesharing Use (grid charged) |                     |           |\n",
+      "| Model 3 Personal Use (solar charged) |                     |           |\n",
+      "| Model 3 Ridesharing Use (solar charged) |                     |           |\n",
+      "\n",
+      "While the electricity grid varies from region to region, charging EVs is becoming less carbon intensive every year. In the U.S., coal has historically been the dominant energy source for generating electricity. But in the last decade, coal power has declined significantly as regions turn to cleaner energy sources. Energy generated by renewable sources has grown rapidly, accounting for an estimated 43% of new electricity generation capacity in 2018. Many U.S. states (such as New York referenced in the chart below) have been making significant investments in renewable energy as these sustainable options become more cost competitive compared to fossil fuel resources.\n",
+      "\n",
+      "To put this in perspective, average GHG emissions from charging one New York-based Tesla vehicle equates to the emissions from an ICE vehicle with a fuel economy of 144 MPG (no such vehicle is on the market). Even when charging a Tesla in Michigan, where approximately 64% of energy comes from coal and natural gas, the emissions from our vehicles still equates to the equivalent emissions of an ICE vehicle with 55 real-world MPG (considerably more in terms of EPA rated MPG). As more regions adopt sustainable energy solutions to generate power, emissions related to charging an EV from the grid will decrease even further.\n",
+      "\n",
+      "EV customers can accelerate the process of increasing their renewable energy mix by installing solar panels or a Solar Roof and an energy storage solution, such as Powerwall, in their homes. Such an effort dramatically reduces the lifetime carbon footprint of an EV, even when accounting for the carbon footprint of both the solar panel/Solar roof and Powerwall manufacturing. Remaining use-phase emissions from solar charged vehicles come from publicly available fast-charging, which too is becoming “greener” every year. Our goal is to strategically pair solar and battery storage at as many Tesla Supercharger stations as is feasible.\n",
+      "\n",
+      "### Average Lifecycle Emissions in New York State (gCO2e/mi)\n",
+      "\n",
+      "|                    | Manufacturing Phase | Use Phase |\n",
+      "|--------------------|---------------------|-----------|\n",
+      "| Model 3 Ridesharing Use (solar charged) |                     |           |\n",
+      "| Model 3 Personal Use (solar charged) |                     |           |\n",
+      "| Model 3 Ridesharing Use (grid charged) |                     |           |\n",
+      "| Model 3 Personal Use (grid charged) |                     |           |\n",
+      "| Avg. Mid-Size Premium ICE |                     |           |\n",
+      "---\n",
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Improving Powertrain Efficiency\n",
+      "\n",
+      "Tesla vehicles are known to have the highest energy efficiency of any EV built to date. In the early days of Model S production, we were able to achieve energy efficiency of 3.1 EPA miles / kWh. Today, our most efficient Model 3 Standard Range Plus (SR+) achieves an EPA range of 4.8 miles / kWh, more than any EV in production. Model Y all-wheel drive (AWD) achieves 4.1 EPA miles / kWh, which makes it the most efficient electric SUV produced to date.\n",
+      "\n",
+      "The energy efficiency of Tesla vehicles will continue to improve further over time as we continue to improve our technology and powertrain efficiency. It is also reasonable to assume that our high-mileage products, such as our future Tesla Robotaxis, will be designed for maximum energy efficiency as handling, acceleration, and top speed become less relevant. That way, we will minimize cost for our customers as well as reduce the carbon footprint per mile driven.\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "| Vehicle Type                          | Manufacturing Phase | Use Phase | Total Emissions |\n",
+      "|---------------------------------------|---------------------|-----------|-----------------|\n",
+      "| Avg. Mid-Size Premium ICE             |                     |           |                 |\n",
+      "| Model 3 Personal Use (grid charged)   |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (grid charged)|                     |           |                 |\n",
+      "| Model 3 Personal Use (solar charged)  |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (solar charged)|                    |           |                 |\n",
+      "\n",
+      "*Note: The exact values for the manufacturing and use phases are not provided in the image.*\n",
+      "\n",
+      "### Energy Efficiency EPA range in miles/kWh\n",
+      "\n",
+      "| Vehicle Model       | EPA Range (miles/kWh) |\n",
+      "|---------------------|-----------------------|\n",
+      "| Model 3 SR+         | 5                     |\n",
+      "| Model 3 AWD         | 4.5                   |\n",
+      "| Model Y AWD         | 4.5                   |\n",
+      "| Hyundai Kona        | 4                     |\n",
+      "| Chevy Bolt          | 4                     |\n",
+      "| Model S LR+         | 4                     |\n",
+      "| Nissan Leaf         | 3.5                   |\n",
+      "| Model X LR+         | 3.5                   |\n",
+      "| Jaguar iPace        | 3                     |\n",
+      "| Mercedes EQC*       | 3                     |\n",
+      "| Ford Mach E AWD     | 3                     |\n",
+      "| Audi e-tron         | 3                     |\n",
+      "| Porsche Taycan      | 3                     |\n",
+      "\n",
+      "*Tesla estimate. Source: OEM websites*\n",
+      "---\n",
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Reducing Emissions at our Factories\n",
+      "\n",
+      "While emissions from the manufacturing phase can account for a relatively minor portion of lifetime vehicle emissions when compared to the use-phase, it is still an important part of lifecycle emissions. Thus, we strive to source as much renewable energy where possible for our factories in an effort to reduce our manufacturing-phase emissions.\n",
+      "\n",
+      "As we continue to ramp production of Tesla products, we are committed to making significant progress towards our goal of operating global Tesla manufacturing, vehicle charging, and other operations using 100% renewable energy.\n",
+      "\n",
+      "Predominantly due to lack of reliable data, various third-party studies tend to overstate the actual energy requirement, and therefore the associated emissions, for battery manufacturing. In fact, in 2019, the emissions from producing a full EV were nearly comparable to than the emissions from producing an average ICE vehicle. That said, battery manufacturing technology continues to improve rapidly, and we expect the EV manufacturing energy requirement and associated emissions to drop significantly in the near future.\n",
+      "\n",
+      "In the second half of 2018, Tesla launched an Operations Energy Efficiency Program (OEEP) aimed at reducing energy usage across our factories in Fremont, Nevada, and Buffalo. In 2019, the OEEP helped us to achieve energy consumption reductions while we simultaneously ramped new lines and products across the three facilities. Our goal is to install as many solar panels as is practically feasible on the roofs of all of our manufacturing facilities.\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "| Vehicle Type                          | Manufacturing Phase | Use Phase | Total Emissions |\n",
+      "|---------------------------------------|---------------------|-----------|-----------------|\n",
+      "| Avg. Mid-Size Premium ICE             |                     |           |                 |\n",
+      "| Model 3 Personal Use (grid charged)   |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (grid charged)|                     |           |                 |\n",
+      "| Model 3 Personal Use (solar charged)  |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (solar charged)|                    |           |                 |\n",
+      "\n",
+      "### gCO2e/mi for Model 3 Battery Pack versus Rest of Vehicle\n",
+      "\n",
+      "| Year | Battery Pack | Rest of Vehicle |\n",
+      "|------|--------------|-----------------|\n",
+      "| 2017 | 60           |                 |\n",
+      "| 2019 | 30           |                 |\n",
+      "---\n",
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Reducing Emissions at our Factories - Gigafactory Shanghai\n",
+      "\n",
+      "Underpinning our strategy for regional manufacturing is a reduction of carbon emissions that result from shipping parts and finished products. From a sustainability standpoint, having vertically integrated Tesla factories in each region helps to reduce the carbon footprint for our operations.\n",
+      "\n",
+      "As highlighted in Tesla’s fourth quarter earnings call for 2019, reductions in shipping costs as well as the strain on the environment from avoided trans-oceanic shipping also makes good business sense. A simplified factory design and localized supply chain near the factory saves time and creates efficiencies, and localized delivery saves outbound logistics costs.\n",
+      "\n",
+      "Our newly opened Gigafactory outside of Shanghai, China has provided us the opportunity to set up and implement the most simplified flows based on what we have learned from the operation of our U.S. factories. The design simplification and operational efficiencies result in time and monetary savings for Gigafactory Shanghai and less carbon emissions per vehicle produced.\n",
+      "\n",
+      "![Gigafactory Shanghai](https://example.com/gigafactory-shanghai.jpg)\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "| Vehicle Type                          | Manufacturing Phase | Use Phase | Total Emissions |\n",
+      "|---------------------------------------|---------------------|-----------|-----------------|\n",
+      "| Avg. Mid-Size Premium ICE             |                     |           |                 |\n",
+      "| Model 3 Personal Use (grid charged)   |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (grid charged)|                     |           |                 |\n",
+      "| Model 3 Personal Use (solar charged)  |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (solar charged)|                    |           |                 |\n",
+      "\n",
+      "- **Avg. Mid-Size Premium ICE**: ~450 gCO2e/mi\n",
+      "- **Model 3 Personal Use (grid charged)**: ~200 gCO2e/mi\n",
+      "- **Model 3 Ridesharing Use (grid charged)**: ~150 gCO2e/mi\n",
+      "- **Model 3 Personal Use (solar charged)**: ~100 gCO2e/mi\n",
+      "- **Model 3 Ridesharing Use (solar charged)**: ~50 gCO2e/mi\n",
+      "\n",
+      "**Reducing Factory Emissions**\n",
+      "\n",
+      "- **Manufacturing Phase**: Blue\n",
+      "- **Use Phase**: Light Blue\n",
+      "\n",
+      "![Bar Chart](https://example.com/bar-chart.jpg)\n",
+      "---\n",
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Increasing Vehicle Utilization\n",
+      "\n",
+      "Tesla’s battery packs are designed to outlast the car. We estimate that a vehicle gets scrapped after approximately 200,000 miles of usage in the U.S. and roughly 130,000 miles in Europe. Creating a battery that could instead last for a 1,000,000 miles (4,000 to 5,000 charging cycles) would dramatically reduce emissions per vehicle produced.\n",
+      "\n",
+      "All vehicles in the world combined travel trillions of miles every year. A relatively small number of vehicles, such as taxis, delivery vans, trucks, or buses, account for a disproportionate amount of vehicle miles and as a result, a disproportionate amount of emissions.\n",
+      "\n",
+      "A single future Tesla vehicle with a million-mile battery could be utilized over five times more than an average vehicle in the U.S. (almost eight times more than an average vehicle sold in Europe). As a portion of the carbon footprint is emitted during the production phase of each vehicle, utilization of such vehicle over 1,000,000 miles dramatically reduces the lifetime carbon footprint per each mile travelled. Furthermore, battery recycling has the potential to further reduce emissions as components of a battery pack can be captured and reused, displacing much of the need for raw material mining and the associated emissions.\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "| Vehicle Type                          | Manufacturing Phase | Use Phase |\n",
+      "|---------------------------------------|---------------------|-----------|\n",
+      "| Avg. Mid-Size Premium ICE             |                     |           |\n",
+      "| Model 3 Personal Use (grid charged)   |                     |           |\n",
+      "| Model 3 Ridesharing Use (grid charged)|                     |           |\n",
+      "| Model 3 Personal Use (solar charged)  |                     |           |\n",
+      "| Model 3 Ridesharing Use (solar charged)|                    |           |\n",
+      "\n",
+      "### Tesla Model S/X Battery Capacity Retention per Distance Traveled\n",
+      "\n",
+      "| Distance Traveled (thousands of miles) | Retention | Standard Deviation |\n",
+      "|----------------------------------------|-----------|--------------------|\n",
+      "| 0                                      | 100%      |                    |\n",
+      "| 25                                     |           |                    |\n",
+      "| 50                                     |           |                    |\n",
+      "| 75                                     |           |                    |\n",
+      "| 100                                    |           |                    |\n",
+      "| 125                                    |           |                    |\n",
+      "| 150                                    |           |                    |\n",
+      "| 175                                    |           |                    |\n",
+      "| 200                                    |           |                    |\n",
+      "---\n",
+      "# Battery Recycling\n",
+      "\n",
+      "A common question we hear is, “What happens to Tesla vehicle battery packs once they reach their end of life?” An important distinction between fossil fuels and lithium-ion batteries as an energy source is that while fossil fuels are extracted and used once, the materials in a lithium-ion battery are recyclable. When petroleum is pumped out of the ground, chemically refined, and then burned, it releases harmful emissions into the atmosphere that are not recovered for reuse. Battery materials, in contrast, are refined and put into a cell, and will still remain in the cell at the end of their life, when they can be recycled to recover valuable materials for reuse over and over again.\n",
+      "\n",
+      "Extending the life of a battery pack is a superior option to recycling for both environmental and business reasons. For those reasons, before decommissioning a consumer battery pack and sending it for recycling, Tesla does everything it can to extend the useful life of each battery pack. Any battery that is no longer meeting a customer’s needs can be serviced by Tesla at one of our service centers around the world.\n",
+      "\n",
+      "Tesla’s current vehicle batteries are designed to outlast our cars. We estimate an average ICE vehicle in the U.S. is scrapped after 17 years of usage, by which time it will have ~200,000 miles on its odometer. Data from our fleet of over 1 million Tesla vehicles on the road shows that our vehicles that have been driven between 150,000 and 200,000 miles had battery packs that degraded by less than 15% on average.\n",
+      "\n",
+      "# Battery Materials Lifecycle\n",
+      "\n",
+      "| Step                        | Description                    |\n",
+      "|-----------------------------|--------------------------------|\n",
+      "| Raw material mining         |                                |\n",
+      "| Battery production          |                                |\n",
+      "| Lifetime usage in a vehicle |                                |\n",
+      "| Battery recycling           | Extracting raw materials       |\n",
+      "---\n",
+      "# Battery Recycling at Gigafactory Nevada\n",
+      "\n",
+      "## Global annual amount of li-ion battery metals sent for recycling by Tesla in 2019\n",
+      "\n",
+      "- **1,000** Tons of Nickel\n",
+      "- **320** Tons of Copper\n",
+      "- **110** Tons of Cobalt\n",
+      "\n",
+      "A closed-loop battery recycling process presents a compelling solution to move energy supply away from the fossil-fuel based practice of take, make and burn, to a more circular model of recycling end-of-life batteries for reuse over and over again.\n",
+      "\n",
+      "Tesla battery packs are made to last many years and therefore we have only received a limited number of these batteries back from the field. Most batteries that Tesla recycles today are pre-consumer, coming to us through R&D and quality control. None of our scrapped lithium-ion batteries go to landfilling, and 100% are recycled. The small amount of post-consumer batteries that we receive are generated from our fleet of vehicles on the road, predominantly from taxi-like vehicles. Since we have only been producing Model S for approximately eight years, it will likely be some time before we start receiving back vehicle batteries in larger volumes.\n",
+      "\n",
+      "All materials contained in a battery remain in their original form at end-of-life and the vast majority of these materials are then captured in the recycling process. Presently, only high-value elements are recycled and re-introduced into the supply chain. However, as recycling technology improves, we strive to re-introduce more and more materials back into their original commodity markets. Over half of the materials in a battery cell are metals, which is great for sustainability given they are infinitely recyclable. The remaining materials are plastics, organics, and other difficult to re-use materials. Research is underway by organizations all over the world to improve the ability to recycle these remaining materials.\n",
+      "\n",
+      "Today, we work with third-party recyclers around the world to process all scrap and end-of-life batteries to recover valuable metals. Our recycling partners work with us to ensure that non-valuable or non-recoverable materials from the batteries are disposed of responsibly.\n",
+      "\n",
+      "Tesla is currently developing a unique battery recycling system at Gigafactory Nevada that will process both battery manufacturing scrap and end-of-life batteries. Through this system, the recovery of critical minerals will be maximized along with the recovery of all metals used in Tesla battery cells, such as copper, aluminum and steel. Our ultimate goal is to develop a recycling process that has high recovery rates, low costs, and a low environmental impact. From an economic perspective, we expect to recognize significant savings over the long term, as the costs associated with large-scale battery material recovery and recycling will be far lower than purchasing and transporting new materials to put into cells.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(documents_gpt4o[0].get_content())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d62cbb62-37ea-4370-9411-d979aa3a627e",
+   "metadata": {},
+   "source": [
+    "## Build RAG pipeline over the Parsed Report\n",
+    "\n",
+    "We now try building a RAG pipeline over this parsed report. It's not a lot of text, but we split it into chunks and load it into a simple in-memory vector store.\n",
+    "\n",
+    "We ask a question over the parsed markdown table and get back the right answer! We also ask a question over the text."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bb991e26-f9e5-404f-9d2c-73dbba12554b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from copy import deepcopy\n",
+    "from llama_index.core.schema import TextNode\n",
+    "from llama_index.core import VectorStoreIndex\n",
+    "\n",
+    "\n",
+    "def get_nodes(docs):\n",
+    "    \"\"\"Split docs into nodes, by separator.\"\"\"\n",
+    "    nodes = []\n",
+    "    for doc in docs:\n",
+    "        doc_chunks = doc.text.split(\"\\n---\\n\")\n",
+    "        for doc_chunk in doc_chunks:\n",
+    "            node = TextNode(\n",
+    "                text=doc_chunk,\n",
+    "                metadata=deepcopy(doc.metadata),\n",
+    "            )\n",
+    "            nodes.append(node)\n",
+    "\n",
+    "    return nodes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "de1b3606-259a-44cf-9892-3c31d6516c2b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# this will split into pages\n",
+    "nodes = get_nodes(documents_gpt4o)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d8b7c3ad-2147-448c-bcbe-3e6fcd8d5361",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vector_index = VectorStoreIndex(nodes)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "8013351a-180d-4947-9f81-513042175c19",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query_engine = vector_index.as_query_engine(similarity_top_k=6)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "795dc5c4-e122-4ff3-94d2-747fa51d5add",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"What are the greenhouse emissions for agriculture and transportation?\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "39d2e6bd-3316-49b5-9a5d-5b4b95343e5a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The greenhouse emissions for agriculture and transportation are 20% and 16% respectively.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9beb5cd4-4041-48c7-b22b-de5540f92a6d",
+   "metadata": {},
+   "source": [
+    "Let's also try asking a question over another piece of the text."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "543c8b63-5cd1-47a1-a8a1-81abbfd3e52b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = query_engine.query(\n",
+    "    \"How does the EPA range of Teslas compare with other vehicles? Give details\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e739eabf-732b-4f59-9628-972c4bf6c857",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The EPA range of Tesla vehicles, such as the Model 3 Standard Range Plus achieving 4.8 miles/kWh and the Model Y all-wheel drive achieving 4.1 miles/kWh, surpasses that of other electric vehicles currently in production. For example, the Hyundai Kona, Chevy Bolt, Model S LR+, and Nissan Leaf have EPA ranges ranging from 3.5 to 4 miles/kWh, while the Jaguar iPace, Mercedes EQC, Ford Mach E AWD, Audi e-tron, and Porsche Taycan have EPA ranges of 3 miles/kWh. This indicates that Tesla vehicles generally have higher energy efficiency and longer EPA ranges compared to other electric vehicles available in the market.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(str(response))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "04b05c53-1a81-41a7-97f2-98a960211957",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Reducing Carbon Footprint Even Further\n",
+      "## Improving Powertrain Efficiency\n",
+      "\n",
+      "Tesla vehicles are known to have the highest energy efficiency of any EV built to date. In the early days of Model S production, we were able to achieve energy efficiency of 3.1 EPA miles / kWh. Today, our most efficient Model 3 Standard Range Plus (SR+) achieves an EPA range of 4.8 miles / kWh, more than any EV in production. Model Y all-wheel drive (AWD) achieves 4.1 EPA miles / kWh, which makes it the most efficient electric SUV produced to date.\n",
+      "\n",
+      "The energy efficiency of Tesla vehicles will continue to improve further over time as we continue to improve our technology and powertrain efficiency. It is also reasonable to assume that our high-mileage products, such as our future Tesla Robotaxis, will be designed for maximum energy efficiency as handling, acceleration, and top speed become less relevant. That way, we will minimize cost for our customers as well as reduce the carbon footprint per mile driven.\n",
+      "\n",
+      "### Average Lifecycle Emissions in U.S. (gCO2e/mi)\n",
+      "\n",
+      "| Vehicle Type                          | Manufacturing Phase | Use Phase | Total Emissions |\n",
+      "|---------------------------------------|---------------------|-----------|-----------------|\n",
+      "| Avg. Mid-Size Premium ICE             |                     |           |                 |\n",
+      "| Model 3 Personal Use (grid charged)   |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (grid charged)|                     |           |                 |\n",
+      "| Model 3 Personal Use (solar charged)  |                     |           |                 |\n",
+      "| Model 3 Ridesharing Use (solar charged)|                    |           |                 |\n",
+      "\n",
+      "*Note: The exact values for the manufacturing and use phases are not provided in the image.*\n",
+      "\n",
+      "### Energy Efficiency EPA range in miles/kWh\n",
+      "\n",
+      "| Vehicle Model       | EPA Range (miles/kWh) |\n",
+      "|---------------------|-----------------------|\n",
+      "| Model 3 SR+         | 5                     |\n",
+      "| Model 3 AWD         | 4.5                   |\n",
+      "| Model Y AWD         | 4.5                   |\n",
+      "| Hyundai Kona        | 4                     |\n",
+      "| Chevy Bolt          | 4                     |\n",
+      "| Model S LR+         | 4                     |\n",
+      "| Nissan Leaf         | 3.5                   |\n",
+      "| Model X LR+         | 3.5                   |\n",
+      "| Jaguar iPace        | 3                     |\n",
+      "| Mercedes EQC*       | 3                     |\n",
+      "| Ford Mach E AWD     | 3                     |\n",
+      "| Audi e-tron         | 3                     |\n",
+      "| Porsche Taycan      | 3                     |\n",
+      "\n",
+      "*Tesla estimate. Source: OEM websites*\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(response.source_nodes[0].get_content())"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llama_parse",
+   "language": "python",
+   "name": "llama_parse"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

llama_parse/__init__.py

@@ -1,3 +1,3 @@
 from llama_parse.base import LlamaParse, ResultType
 
-__all__ = ["LlamaParse", "ResultType"]
+__all__ = ["LlamaParse", "ResultType"]

llama_parse/base.py

@@ -1,20 +1,23 @@
+import os
 import asyncio
 import httpx
 import mimetypes
 import time
-from enum import Enum
-from typing import List, Optional
+from pathlib import Path
+from typing import List, Optional, Union
 
+from llama_index.core.async_utils import run_jobs
 from llama_index.core.bridge.pydantic import Field, validator
+from llama_index.core.constants import DEFAULT_BASE_URL
 from llama_index.core.readers.base import BasePydanticReader
 from llama_index.core.schema import Document
-
-
-class ResultType(str, Enum):
-    """The result type for the parser."""
-
-    TXT = "text"
-    MD = "markdown"
+from llama_parse.utils import (
+    nest_asyncio_err,
+    nest_asyncio_msg,
+    ResultType,
+    Language,
+    SUPPORTED_FILE_TYPES,
+)
 
 
 class LlamaParse(BasePydanticReader):
@@ -22,12 +25,18 @@ class LlamaParse(BasePydanticReader):
 
     api_key: str = Field(default="", description="The API key for the LlamaParse API.")
     base_url: str = Field(
-        default="https://api.cloud.llamaindex.ai/api/parsing",
+        default=DEFAULT_BASE_URL,
         description="The base URL of the Llama Parsing API.",
     )
     result_type: ResultType = Field(
         default=ResultType.TXT, description="The result type for the parser."
     )
+    num_workers: int = Field(
+        default=4,
+        gt=0,
+        lt=10,
+        description="The number of workers to use sending API requests for parsing.",
+    )
     check_interval: int = Field(
         default=1,
         description="The interval in seconds to check if the parsing is done.",
@@ -39,28 +48,82 @@ class LlamaParse(BasePydanticReader):
     verbose: bool = Field(
         default=True, description="Whether to print the progress of the parsing."
     )
+    show_progress: bool = Field(
+        default=True, description="Show progress when parsing multiple files."
+    )
+    language: Language = Field(
+        default=Language.ENGLISH, description="The language of the text to parse."
+    )
+    parsing_instruction: Optional[str] = Field(
+        default="", description="The parsing instruction for the parser."
+    )
+    skip_diagonal_text: Optional[bool] = Field(
+        default=False,
+        description="If set to true, the parser will ignore diagonal text (when the text rotation in degrees modulo 90 is not 0).",
+    )
+    invalidate_cache: Optional[bool] = Field(
+        default=False,
+        description="If set to true, the cache will be ignored and the document re-processes. All document are kept in cache for 48hours after the job was completed to avoid processing 2 time the same document.",
+    )
+    do_not_cache: Optional[bool] = Field(
+        default=False,
+        description="If set to true, the document will not be cached. This mean that you will be re-charged it you reprocess them as they will not be cached.",
+    )
+    fast_mode: Optional[bool] = Field(
+        default=False,
+        description="Note: Non compatible with gpt-4o. If set to true, the parser will use a faster mode to extract text from documents. This mode will skip OCR of images, and table/heading reconstruction.",
+    )
+    do_not_unroll_columns: Optional[bool] = Field(
+        default=False,
+        description="If set to true, the parser will keep column in the text according to document layout. Reduce reconstruction accuracy, and LLM's/embedings performances in most case.",
+    )
+    page_separator: Optional[str] = Field(
+        default=None,
+        description="The page separator to use to split the text. Default is None, which means the parser will use the default separator '\\n---\\n'.",
+    )
+    gpt4o_mode: bool = Field(
+        default=False,
+        description="Whether to use gpt-4o extract text from documents.",
+    )
+    gpt4o_api_key: Optional[str] = Field(
+        default=None,
+        description="The API key for the GPT-4o API. Lowers the cost of parsing.",
+    )
+    ignore_errors: bool = Field(
+        default=True,
+        description="Whether or not to ignore and skip errors raised during parsing.",
+    )
 
     @validator("api_key", pre=True, always=True)
     def validate_api_key(cls, v: str) -> str:
         """Validate the API key."""
         if not v:
             import os
+
             api_key = os.getenv("LLAMA_CLOUD_API_KEY", None)
             if api_key is None:
                 raise ValueError("The API key is required.")
             return api_key
-        
+
         return v
 
-    def load_data(self, file_path: str, extra_info: Optional[dict] = None) -> List[Document]:
-        """Load data from the input path."""
-        return asyncio.run(self.aload_data(file_path, extra_info))
+    @validator("base_url", pre=True, always=True)
+    def validate_base_url(cls, v: str) -> str:
+        """Validate the base URL."""
+        url = os.getenv("LLAMA_CLOUD_BASE_URL", None)
+        return url or v or DEFAULT_BASE_URL
 
-    async def aload_data(self, file_path: str, extra_info: Optional[dict] = None) -> List[Document]:
-        """Load data from the input path."""
+    # upload a document and get back a job_id
+    async def _create_job(
+        self, file_path: str, extra_info: Optional[dict] = None
+    ) -> str:
         file_path = str(file_path)
-        if not file_path.endswith(".pdf"):
-            raise Exception("Currently, only PDF files are supported.")
+        file_ext = os.path.splitext(file_path)[1]
+        if file_ext not in SUPPORTED_FILE_TYPES:
+            raise Exception(
+                f"Currently, only the following file types are supported: {SUPPORTED_FILE_TYPES}\n"
+                f"Current file type: {file_ext}"
+            )
 
         extra_info = extra_info or {}
         extra_info["file_path"] = file_path
@@ -73,44 +136,256 @@ class LlamaParse(BasePydanticReader):
             files = {"file": (f.name, f, mime_type)}
 
             # send the request, start job
-            url = f"{self.base_url}/upload"
+            url = f"{self.base_url}/api/parsing/upload"
             async with httpx.AsyncClient(timeout=self.max_timeout) as client:
-                response = await client.post(url, files=files, headers=headers)
+                response = await client.post(
+                    url,
+                    files=files,
+                    headers=headers,
+                    data={
+                        "language": self.language.value,
+                        "parsing_instruction": self.parsing_instruction,
+                        "invalidate_cache": self.invalidate_cache,
+                        "skip_diagonal_text": self.skip_diagonal_text,
+                        "do_not_cache": self.do_not_cache,
+                        "fast_mode": self.fast_mode,
+                        "do_not_unroll_columns": self.do_not_unroll_columns,
+                        "page_separator": self.page_separator,
+                        "gpt4o_mode": self.gpt4o_mode,
+                        "gpt4o_api_key": self.gpt4o_api_key,
+                    },
+                )
                 if not response.is_success:
-                    raise Exception(f"Failed to parse the PDF file: {response.text}")
+                    raise Exception(f"Failed to parse the file: {response.text}")
 
         # check the status of the job, return when done
         job_id = response.json()["id"]
-        if self.verbose:
-            print("Started parsing the file under job_id %s" % job_id)
-        
-        result_url = f"{self.base_url}/job/{job_id}/result/{self.result_type.value}"
+        return job_id
+
+    async def _get_job_result(
+        self, job_id: str, result_type: str, verbose: bool = False
+    ) -> dict:
+        result_url = f"{self.base_url}/api/parsing/job/{job_id}/result/{result_type}"
+        status_url = f"{self.base_url}/api/parsing/job/{job_id}"
+        headers = {"Authorization": f"Bearer {self.api_key}"}
 
         start = time.time()
         tries = 0
         while True:
             await asyncio.sleep(self.check_interval)
-            async with httpx.AsyncClient(timeout=self.max_timeout) as client:    
-                result = await client.get(result_url, headers=headers)
+            async with httpx.AsyncClient(timeout=self.max_timeout) as client:
+                tries += 1
 
-                if result.status_code == 404:
+                result = await client.get(status_url, headers=headers)
+
+                if result.status_code != 200:
                     end = time.time()
                     if end - start > self.max_timeout:
-                        raise Exception(
-                            f"Timeout while parsing the PDF file: {response.text}"
-                        )
-                    if self.verbose and tries % 10 == 0:
+                        raise Exception(f"Timeout while parsing the file: {job_id}")
+                    if verbose and tries % 10 == 0:
                         print(".", end="", flush=True)
+
+                    await asyncio.sleep(self.check_interval)
+
                     continue
 
-                if result.status_code == 400:
-                    detail = result.json().get("detail", "Unknown error")
-                    raise Exception(f"Failed to parse the PDF file: {detail}")
+                # Allowed values "PENDING", "SUCCESS", "ERROR", "CANCELED"
+                status = result.json()["status"]
+                if status == "SUCCESS":
+                    parsed_result = await client.get(result_url, headers=headers)
+                    return parsed_result.json()
+                elif status == "PENDING":
+                    end = time.time()
+                    if end - start > self.max_timeout:
+                        raise Exception(f"Timeout while parsing the file: {job_id}")
+                    if verbose and tries % 10 == 0:
+                        print(".", end="", flush=True)
 
-                return [
-                    Document(
-                        text=result.json()[self.result_type.value],
-                        metadata=extra_info,
+                    await asyncio.sleep(self.check_interval)
+
+                    continue
+                else:
+                    raise Exception(
+                        f"Failed to parse the file: {job_id}, status: {status}"
                     )
-                ]
-            tries += 1
+
+    async def _aload_data(
+        self, file_path: str, extra_info: Optional[dict] = None, verbose: bool = False
+    ) -> List[Document]:
+        """Load data from the input path."""
+        try:
+            job_id = await self._create_job(file_path, extra_info=extra_info)
+            if verbose:
+                print("Started parsing the file under job_id %s" % job_id)
+
+            result = await self._get_job_result(
+                job_id, self.result_type.value, verbose=verbose
+            )
+
+            return [
+                Document(
+                    text=result[self.result_type.value],
+                    metadata=extra_info or {},
+                )
+            ]
+
+        except Exception as e:
+            print(f"Error while parsing the file '{file_path}':", e)
+            if self.ignore_errors:
+                return []
+            else:
+                raise e
+
+    async def aload_data(
+        self, file_path: Union[List[str], str], extra_info: Optional[dict] = None
+    ) -> List[Document]:
+        """Load data from the input path."""
+        if isinstance(file_path, (str, Path)):
+            return await self._aload_data(
+                file_path, extra_info=extra_info, verbose=self.verbose
+            )
+        elif isinstance(file_path, list):
+            jobs = [
+                self._aload_data(
+                    f,
+                    extra_info=extra_info,
+                    verbose=self.verbose and not self.show_progress,
+                )
+                for f in file_path
+            ]
+            try:
+                results = await run_jobs(
+                    jobs,
+                    workers=self.num_workers,
+                    desc="Parsing files",
+                    show_progress=self.show_progress,
+                )
+
+                # return flattened results
+                return [item for sublist in results for item in sublist]
+            except RuntimeError as e:
+                if nest_asyncio_err in str(e):
+                    raise RuntimeError(nest_asyncio_msg)
+                else:
+                    raise e
+        else:
+            raise ValueError(
+                "The input file_path must be a string or a list of strings."
+            )
+
+    def load_data(
+        self, file_path: Union[List[str], str], extra_info: Optional[dict] = None
+    ) -> List[Document]:
+        """Load data from the input path."""
+        try:
+            return asyncio.run(self.aload_data(file_path, extra_info))
+        except RuntimeError as e:
+            if nest_asyncio_err in str(e):
+                raise RuntimeError(nest_asyncio_msg)
+            else:
+                raise e
+
+    async def _aget_json(
+        self, file_path: str, extra_info: Optional[dict] = None
+    ) -> List[dict]:
+        """Load data from the input path."""
+        try:
+            job_id = await self._create_job(file_path, extra_info=extra_info)
+            if self.verbose:
+                print("Started parsing the file under job_id %s" % job_id)
+
+            result = await self._get_job_result(job_id, "json")
+            result["job_id"] = job_id
+            result["file_path"] = file_path
+            return [result]
+
+        except Exception as e:
+            print(f"Error while parsing the file '{file_path}':", e)
+            if self.ignore_errors:
+                return []
+            else:
+                raise e
+
+    async def aget_json(
+        self, file_path: Union[List[str], str], extra_info: Optional[dict] = None
+    ) -> List[dict]:
+        """Load data from the input path."""
+        if isinstance(file_path, (str, Path)):
+            return await self._aget_json(file_path, extra_info=extra_info)
+        elif isinstance(file_path, list):
+            jobs = [self._aget_json(f, extra_info=extra_info) for f in file_path]
+            try:
+                results = await run_jobs(
+                    jobs,
+                    workers=self.num_workers,
+                    desc="Parsing files",
+                    show_progress=self.show_progress,
+                )
+
+                # return flattened results
+                return [item for sublist in results for item in sublist]
+            except RuntimeError as e:
+                if nest_asyncio_err in str(e):
+                    raise RuntimeError(nest_asyncio_msg)
+                else:
+                    raise e
+        else:
+            raise ValueError(
+                "The input file_path must be a string or a list of strings."
+            )
+
+    def get_json_result(
+        self, file_path: Union[List[str], str], extra_info: Optional[dict] = None
+    ) -> List[dict]:
+        """Parse the input path."""
+        try:
+            return asyncio.run(self.aget_json(file_path, extra_info))
+        except RuntimeError as e:
+            if nest_asyncio_err in str(e):
+                raise RuntimeError(nest_asyncio_msg)
+            else:
+                raise e
+
+    def get_images(self, json_result: List[dict], download_path: str) -> List[dict]:
+        """Download images from the parsed result."""
+        headers = {"Authorization": f"Bearer {self.api_key}"}
+
+        # make the download path
+        if not os.path.exists(download_path):
+            os.makedirs(download_path)
+
+        try:
+            images = []
+            for result in json_result:
+                job_id = result["job_id"]
+                for page in result["pages"]:
+                    if self.verbose:
+                        print(f"> Image for page {page['page']}: {page['images']}")
+                    for image in page["images"]:
+                        image_name = image["name"]
+
+                        # get the full path
+                        image_path = os.path.join(
+                            download_path, f"{job_id}-{image_name}"
+                        )
+
+                        # get a valid image path
+                        if not image_path.endswith(".png"):
+                            if not image_path.endswith(".jpg"):
+                                image_path += ".png"
+
+                        image["path"] = image_path
+                        image["job_id"] = job_id
+                        image["original_pdf_path"] = result["file_path"]
+                        image["page_number"] = page["page"]
+                        with open(image_path, "wb") as f:
+                            image_url = f"{self.base_url}/api/parsing/job/{job_id}/result/image/{image_name}"
+                            f.write(httpx.get(image_url, headers=headers).content)
+                        images.append(image)
+            return images
+        except Exception as e:
+            print("Error while downloading images from the parsed result:", e)
+            if self.ignore_errors:
+                return []
+            else:
+                raise e

llama_parse/utils.py

@@ -0,0 +1,193 @@
+from enum import Enum
+
+# Asyncio error messages
+nest_asyncio_err = "cannot be called from a running event loop"
+nest_asyncio_msg = "The event loop is already running. Add `import nest_asyncio; nest_asyncio.apply()` to your code to fix this issue."
+
+
+class ResultType(str, Enum):
+    """The result type for the parser."""
+
+    TXT = "text"
+    MD = "markdown"
+    JSON = "json"
+
+
+class Language(str, Enum):
+    BAZA = "abq"
+    ADYGHE = "ady"
+    AFRIKAANS = "af"
+    ANGIKA = "ang"
+    ARABIC = "ar"
+    ASSAMESE = "as"
+    AVAR = "ava"
+    AZERBAIJANI = "az"
+    BELARUSIAN = "be"
+    BULGARIAN = "bg"
+    BIHARI = "bh"
+    BHOJPURI = "bho"
+    BENGALI = "bn"
+    BOSNIAN = "bs"
+    SIMPLIFIED_CHINESE = "ch_sim"
+    TRADITIONAL_CHINESE = "ch_tra"
+    CHECHEN = "che"
+    CZECH = "cs"
+    WELSH = "cy"
+    DANISH = "da"
+    DARGWA = "dar"
+    GERMAN = "de"
+    ENGLISH = "en"
+    SPANISH = "es"
+    ESTONIAN = "et"
+    PERSIAN_FARSI = "fa"
+    FRENCH = "fr"
+    IRISH = "ga"
+    GOAN_KONKANI = "gom"
+    HINDI = "hi"
+    CROATIAN = "hr"
+    HUNGARIAN = "hu"
+    INDONESIAN = "id"
+    INGUSH = "inh"
+    ICELANDIC = "is"
+    ITALIAN = "it"
+    JAPANESE = "ja"
+    KABARDIAN = "kbd"
+    KANNADA = "kn"
+    KOREAN = "ko"
+    KURDISH = "ku"
+    LATIN = "la"
+    LAK = "lbe"
+    LEZGHIAN = "lez"
+    LITHUANIAN = "lt"
+    LATVIAN = "lv"
+    MAGAHI = "mah"
+    MAITHILI = "mai"
+    MAORI = "mi"
+    MONGOLIAN = "mn"
+    MARATHI = "mr"
+    MALAY = "ms"
+    MALTESE = "mt"
+    NEPALI = "ne"
+    NEWARI = "new"
+    DUTCH = "nl"
+    NORWEGIAN = "no"
+    OCCITAN = "oc"
+    PALI = "pi"
+    POLISH = "pl"
+    PORTUGUESE = "pt"
+    ROMANIAN = "ro"
+    RUSSIAN = "ru"
+    SERBIAN_CYRILLIC = "rs_cyrillic"
+    SERBIAN_LATIN = "rs_latin"
+    NAGPURI = "sck"
+    SLOVAK = "sk"
+    SLOVENIAN = "sl"
+    ALBANIAN = "sq"
+    SWEDISH = "sv"
+    SWAHILI = "sw"
+    TAMIL = "ta"
+    TABASSARAN = "tab"
+    TELUGU = "te"
+    THAI = "th"
+    TAJIK = "tjk"
+    TAGALOG = "tl"
+    TURKISH = "tr"
+    UYGHUR = "ug"
+    UKRAINIAN = "uk"
+    URDU = "ur"
+    UZBEK = "uz"
+    VIETNAMESE = "vi"
+
+
+SUPPORTED_FILE_TYPES = [
+    ".pdf",
+    # document and presentations
+    ".602",
+    ".abw",
+    ".cgm",
+    ".cwk",
+    ".doc",
+    ".docx",
+    ".docm",
+    ".dot",
+    ".dotm",
+    ".hwp",
+    ".key",
+    ".lwp",
+    ".mw",
+    ".mcw",
+    ".pages",
+    ".pbd",
+    ".ppt",
+    ".pptm",
+    ".pptx",
+    ".pot",
+    ".potm",
+    ".potx",
+    ".rtf",
+    ".sda",
+    ".sdd",
+    ".sdp",
+    ".sdw",
+    ".sgl",
+    ".sti",
+    ".sxi",
+    ".sxw",
+    ".stw",
+    ".sxg",
+    ".txt",
+    ".uof",
+    ".uop",
+    ".uot",
+    ".vor",
+    ".wpd",
+    ".wps",
+    ".xml",
+    ".zabw",
+    ".epub",
+    # images
+    ".jpg",
+    ".jpeg",
+    ".png",
+    ".gif",
+    ".bmp",
+    ".svg",
+    ".tiff",
+    ".webp",
+    # web
+    ".htm",
+    ".html",
+    # spreadsheets
+    ".xlsx",
+    ".xls",
+    ".xlsm",
+    ".xlsb",
+    ".xlw",
+    ".csv",
+    ".dif",
+    ".sylk",
+    ".slk",
+    ".prn",
+    ".numbers",
+    ".et",
+    ".ods",
+    ".fods",
+    ".uos1",
+    ".uos2",
+    ".dbf",
+    ".wk1",
+    ".wk2",
+    ".wk3",
+    ".wk4",
+    ".wks",
+    ".123",
+    ".wq1",
+    ".wq2",
+    ".wb1",
+    ".wb2",
+    ".wb3",
+    ".qpw",
+    ".xlr",
+    ".eth",
+    ".tsv",
+]

pyproject.toml

@@ -1,6 +1,10 @@
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
 [tool.poetry]
 name = "llama-parse"
-version = "0.2.0"
+version = "0.4.4"
 description = "Parse files into RAG-Optimized formats."
 authors = ["Logan Markewich <logan@llamaindex.ai>"]
 license = "MIT"
@@ -9,13 +13,8 @@ packages = [{include = "llama_parse"}]
 
 [tool.poetry.dependencies]
 python = ">=3.8.1,<4.0"
-llama-index-core = "^0.10.0"
-
+llama-index-core = ">=0.10.29"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.0"
 ipykernel = "^6.29.0"
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"

tests/test_reader.py

@@ -1,18 +1,59 @@
 import os
+import pytest
 from llama_parse import LlamaParse
 
-def test_simple_page_text():
+
+@pytest.mark.skipif(
+    os.environ.get("LLAMA_CLOUD_API_KEY", "") == "",
+    reason="LLAMA_CLOUD_API_KEY not set",
+)
+def test_simple_page_text() -> None:
     parser = LlamaParse(result_type="text")
 
-    filepath = os.path.join(os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf")
+    filepath = os.path.join(
+        os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf"
+    )
     result = parser.load_data(filepath)
     assert len(result) == 1
     assert len(result[0].text) > 0
 
-def test_simple_page_markdown():
+
+@pytest.mark.skipif(
+    os.environ.get("LLAMA_CLOUD_API_KEY", "") == "",
+    reason="LLAMA_CLOUD_API_KEY not set",
+)
+def test_simple_page_markdown() -> None:
     parser = LlamaParse(result_type="markdown")
 
-    filepath = os.path.join(os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf")
+    filepath = os.path.join(
+        os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf"
+    )
     result = parser.load_data(filepath)
     assert len(result) == 1
     assert len(result[0].text) > 0
+
+
+@pytest.mark.skipif(
+    os.environ.get("LLAMA_CLOUD_API_KEY", "") == "",
+    reason="LLAMA_CLOUD_API_KEY not set",
+)
+def test_simple_page_progress_workers() -> None:
+    parser = LlamaParse(result_type="markdown", show_progress=True, verbose=True)
+
+    filepath = os.path.join(
+        os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf"
+    )
+    result = parser.load_data([filepath, filepath])
+    assert len(result) == 2
+    assert len(result[0].text) > 0
+
+    parser = LlamaParse(
+        result_type="markdown", show_progress=True, num_workers=2, verbose=True
+    )
+
+    filepath = os.path.join(
+        os.path.dirname(__file__), "test_files/attention_is_all_you_need.pdf"
+    )
+    result = parser.load_data([filepath, filepath])
+    assert len(result) == 2
+    assert len(result[0].text) > 0