review fixes

.changeset/great-students-appear.md

@@ -0,0 +1,5 @@
+---
+"create-llama": patch
+---
+
+docs: chroma env variables

.github/workflows/e2e.yml

@@ -2,12 +2,8 @@ name: E2E Tests
 on:
   push:
     branches: [main]
-    paths-ignore:
-      - "llama-index-server/**"
   pull_request:
     branches: [main]
-    paths-ignore:
-      - "llama-index-server/**"
 
 env:
   POETRY_VERSION: "1.6.1"
@@ -71,16 +67,13 @@ jobs:
           LLAMA_CLOUD_API_KEY: ${{ secrets.LLAMA_CLOUD_API_KEY }}
           FRAMEWORK: ${{ matrix.frameworks }}
           DATASOURCE: ${{ matrix.datasources }}
-          PYTHONIOENCODING: utf-8
-          PYTHONLEGACYWINDOWSSTDIO: utf-8
         working-directory: .
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v3
         if: always()
         with:
-          name: playwright-report-python-${{ matrix.os }}-${{ matrix.frameworks }}-${{ matrix.datasources }}
+          name: playwright-report-python
           path: ./playwright-report/
-          overwrite: true
           retention-days: 30
 
   e2e-typescript:
@@ -89,11 +82,11 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        node-version: [20, 22]
+        node-version: [18, 20]
         python-version: ["3.11"]
         os: [macos-latest, windows-latest, ubuntu-22.04]
-        frameworks: ["nextjs"]
-        datasources: ["--no-files", "--example-file", "--llamacloud"]
+        frameworks: ["nextjs", "express"]
+        datasources: ["--no-files", "--example-file"]
     defaults:
       run:
         shell: bash
@@ -143,10 +136,9 @@ jobs:
           DATASOURCE: ${{ matrix.datasources }}
         working-directory: .
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v3
         if: always()
         with:
-          name: playwright-report-typescript-${{ matrix.os }}-${{ matrix.frameworks }}-${{ matrix.datasources }}-node${{ matrix.node-version }}
+          name: playwright-report-typescript
           path: ./playwright-report/
-          overwrite: true
           retention-days: 30

.github/workflows/release_llama_index_server.yml

@@ -1,130 +0,0 @@
-name: Release llama-index-server
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - "llama-index-server/**"
-      - ".github/workflows/release_llama_index_server.yml"
-  pull_request:
-    types:
-      - closed
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  release:
-    name: Create Release PR
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./llama-index-server
-    if: |
-      github.event_name == 'push' && 
-      !startsWith(github.ref, 'refs/heads/release/llama-index-server-v')
-
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-
-      - name: Install Poetry
-        run: |
-          curl -sSL https://install.python-poetry.org | python3 -
-
-      - name: Install dependencies
-        run: poetry install
-
-      - name: Setup Git
-        run: |
-          git config --global user.email "github-actions[bot]@users.noreply.github.com"
-          git config --global user.name "github-actions[bot]"
-
-      - name: Bump patch version
-        run: |
-          poetry version patch
-          git add pyproject.toml
-          git commit -m "chore(release): bump version to $(poetry version -s)"
-
-      - name: Get current version
-        id: get_version
-        run: |
-          version=$(poetry version -s)
-          echo "current_version=${version}" >> "$GITHUB_OUTPUT"
-
-      - name: Create Release PR
-        uses: peter-evans/create-pull-request@v6
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: "Release: llama-index-server v${{ steps.get_version.outputs.current_version }}"
-          title: "Release: llama-index-server v${{ steps.get_version.outputs.current_version }}"
-          body: |
-            This PR was automatically created to release a new version of the llama-index-server package.
-
-            Version: ${{ steps.get_version.outputs.current_version }}
-
-            Please review the changes and merge to trigger the release.
-          branch: release/llama-index-server-v${{ steps.get_version.outputs.current_version }}
-          base: main
-          labels: release, llama-index-server
-
-  publish:
-    name: Publish to PyPI
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./llama-index-server
-    if: |
-      github.event_name == 'pull_request' && 
-      github.event.pull_request.merged == true && 
-      startsWith(github.event.pull_request.title, 'Release: llama-index-server') &&
-      startsWith(github.event.pull_request.head.ref, 'release/llama-index-server-v')
-
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-
-      - name: Install Poetry
-        run: |
-          curl -sSL https://install.python-poetry.org | python3 -
-
-      - name: Install dependencies
-        run: poetry install
-
-      - name: Get current version
-        id: get_version
-        run: |
-          version=$(poetry version -s)
-          echo "current_version=${version}" >> "$GITHUB_OUTPUT"
-
-      - name: Build and publish to PyPI
-        uses: JRubics/poetry-publish@v2.1
-        with:
-          python_version: "3.11"
-          pypi_token: ${{ secrets.PYPI_TOKEN }}
-          package_directory: "llama-index-server"
-          poetry_install_options: "--without dev"
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: llama-index-server-v${{ steps.get_version.outputs.current_version }}
-          name: "llama-index-server v${{ steps.get_version.outputs.current_version }}"
-          body: |
-            Release of llama-index-server v${{ steps.get_version.outputs.current_version }}
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test_llama_index_server.yml

@@ -1,111 +0,0 @@
-name: Build Package
-
-on:
-  pull_request:
-
-env:
-  POETRY_VERSION: "1.8.3"
-  PYTHON_VERSION: "3.9"
-
-jobs:
-  unit-test:
-    name: Unit Tests
-    runs-on: ${{ matrix.os }}
-    defaults:
-      run:
-        working-directory: llama-index-server
-    strategy:
-      matrix:
-        os: [ubuntu-latest, windows-latest]
-        python-version: ["3.9"]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Poetry
-        run: pipx install poetry==${{ env.POETRY_VERSION }}
-
-      - name: Set up python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: "poetry"
-
-      - name: Configure Poetry
-        run: |
-          poetry config virtualenvs.create true
-          poetry config virtualenvs.in-project true
-          poetry env use python
-
-      - name: Install dependencies
-        shell: bash
-        run: poetry install --with dev
-
-      - name: Run unit tests
-        shell: bash
-        run: |
-          poetry run pytest tests
-
-  type-check:
-    name: Type Check
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: llama-index-server
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Poetry
-        run: pipx install poetry==${{ env.POETRY_VERSION }}
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ env.PYTHON_VERSION }}
-          cache: "poetry"
-
-      - name: Configure Poetry
-        run: |
-          poetry config virtualenvs.create true
-          poetry config virtualenvs.in-project true
-          poetry env use python
-
-      - name: Install dependencies
-        shell: bash
-        run: poetry install --with dev
-
-      - name: Run mypy
-        shell: bash
-        run: poetry run mypy llama_index
-
-  build:
-    needs: [unit-test, type-check]
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: llama-index-server
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install Poetry
-        run: pipx install poetry==${{ env.POETRY_VERSION }}
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ env.PYTHON_VERSION }}
-      - name: Clear python cache
-        shell: bash
-        run: poetry cache clear --all pypi
-      - name: Build package
-        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 "from llama_index.server import LlamaIndexServer"
-      - name: Upload artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: llama-index-server
-          path: llama-index-server/dist/

.gitignore

@@ -8,7 +8,6 @@ node_modules
 
 # testing
 coverage
-.coverage
 
 # next.js
 .next/
@@ -49,17 +48,6 @@ e2e/cache
 
 # Python
 .mypy_cache/
-venv/
-.venv/
-dist/
-.__pycache__
-__pycache__
-.python-version
-.ui
 
 # build artifacts
 create-llama-*.tgz
-
-# vscode
-.vscode
-!.vscode/settings.json

CHANGELOG.md

@@ -1,282 +1,5 @@
 # create-llama
 
-## 0.5.9
-
-### Patch Changes
-
-- 4bc53ac: Bump new chat ui and update deep research component
-- 4bc53ac: Support generate UI for deep research use case (Typescript)
-
-## 0.5.8
-
-### Patch Changes
-
-- 765181a: chore: test typescript e2e with node 20 and 22
-
-## 0.5.7
-
-### Patch Changes
-
-- 5988657: chore: bump llmaindex
-
-## 0.5.6
-
-### Patch Changes
-
-- d363ced: Bump llamaindex server packages
-
-## 0.5.5
-
-### Patch Changes
-
-- ee85320: The default custom deep research component does not work.
-
-## 0.5.4
-
-### Patch Changes
-
-- 7c3b279: Support code generation of event components using an LLM (Python)
-
-## 0.5.3
-
-### Patch Changes
-
-- 76ec360: Update templates to use new chat ui config
-
-## 0.5.2
-
-### Patch Changes
-
-- c9f8f8d: Use custom component for deep research use case
-
-## 0.5.1
-
-### Patch Changes
-
-- 08b3e07: Simplify the local index code.
-
-## 0.5.0
-
-### Minor Changes
-
-- 54c9e2f: Simplified generated code using LlamaIndexServer
-
-### Patch Changes
-
-- 0e4ecfa: fix: add trycatch for generating error
-- ee69ce7: bump: chat-ui and tailwind v4
-
-## 0.4.0
-
-### Minor Changes
-
-- 61204a1: chore: bump LITS 0.9
-
-### Patch Changes
-
-- 9e723c3: Standardize the code of the workflow use case (Python)
-- d5da55b: feat: add components.json to use CLI
-- c1552eb: chore: move wikipedia tool to create-llama
-
-## 0.3.28
-
-### Patch Changes
-
-- 4e06714: Fix the error: Unable to view file sources due to CORS.
-
-## 0.3.27
-
-### Patch Changes
-
-- b4e41aa: Add deep research over own documents use case (Python)
-
-## 0.3.26
-
-### Patch Changes
-
-- f73d46b: Fix missing copy of the multiagent code
-
-## 0.3.25
-
-### Patch Changes
-
-- 5450096: bump: react 19 stable
-
-## 0.3.24
-
-### Patch Changes
-
-- a84743c: Change --agents paramameter to --use-case
-- a84743c: Add LlamaCloud support for Reflex templates
-- a7a6592: Fix the npm issue on the full-stack Python template
-- fc5e56e: bump: code interpreter v1
-
-## 0.3.23
-
-### Patch Changes
-
-- 9077cae: Add contract review use case (Python)
-
-## 0.3.22
-
-### Patch Changes
-
-- 25667d4: Make OpenAPI spec usable by custom GPTs
-
-## 0.3.21
-
-### Patch Changes
-
-- 95227a7: Add query endpoint
-
-## 0.3.20
-
-### Patch Changes
-
-- 27d2499: Bump the LlamaCloud library and fix breaking changes (Python).
-
-## 0.3.19
-
-### Patch Changes
-
-- f9a057d: Add support multimodal indexes (e.g. from LlamaCloud)
-- aedd73d: bump: chat-ui
-
-## 0.3.18
-
-### Patch Changes
-
-- fe90a7e: chore: bump ai v4
-- 02b2473: Show streaming errors in Python, optimize system prompts for tool usage and set the weather tool as default for the Agentic RAG use case
-- 63e961e: Use auto_routed retriever mode for LlamaCloudIndex
-
-## 0.3.17
-
-### Patch Changes
-
-- 28c8808: Add fly.io deployment
-- 0a7dfcf: Generate NEXT_PUBLIC_CHAT_API for NextJS backend to specify alternative backend
-
-## 0.3.16
-
-### Patch Changes
-
-- 8b371d8: Set pydantic version to <2.10 to avoid incompatibility with llama-index.
-- 30fe269: Deactive duckduckgo tool for TS
-- 30fe269: Replace DuckDuckGo by Wikipedia tool for agentic template
-
-## 0.3.15
-
-### Patch Changes
-
-- fc5b266: Improve DX for Python template (use one deployment instead of two)
-- f8f97d2: Add support for python 3.13
-
-## 0.3.14
-
-### Patch Changes
-
-- 00f0b3a: fix: dont include user message in chat history
-- 4663dec: chore: bump react19 rc
-- 44b34fb: chore: update eslint 9, nextjs 15, react 19
-- 6925676: feat: use latest chat UI
-
-## 0.3.13
-
-### Patch Changes
-
-- 282eaa0: Ensure that the index and document store are created when uploading a file with no available index.
-
-## 0.3.12
-
-### Patch Changes
-
-- 6edea6a: Optimize generated workflow code for Python
-- 8431b78: Optimize Typescript multi-agent code
-- 8431b78: Add form filling use case (Typescript)
-
-## 0.3.11
-
-### Patch Changes
-
-- 2b8aaa8: Add support for local models via Hugging Face
-- b9570b2: Fix: use generic LLMAgent instead of OpenAIAgent (adds support for Gemini and Anthropic for Agentic RAG)
-- 1fe21f8: Fix the highlight.js issue with the Next.js static build
-- 00009ae: feat: import pdf css
-
-## 0.3.10
-
-### Patch Changes
-
-- 9172fed: feat: bump LITS 0.8.2
-- 78ccde7: feat: use llamaindex chat-ui for nextjs frontend
-
-## 0.3.9
-
-### Patch Changes
-
-- ed59927: Add form filling use case (Python)
-
-## 0.3.8
-
-### Patch Changes
-
-- 4a83469: Add multi-agent financial report for Typescript (and update LITS to 0.7.10)
-
-## 0.3.7
-
-### Patch Changes
-
-- fa80378: DocumentInfo working with relative URLs
-
-## 0.3.6
-
-### Patch Changes
-
-- 0182368: Fix the streaming issue to prevent the UI from hanging.
-
-## 0.3.5
-
-### Patch Changes
-
-- 2209409: Add financial report as the default use case in the multi-agent template (Python).
-
-## 0.3.4
-
-### Patch Changes
-
-- 384a136: Fix import error if the artifact tool is selected
-
-## 0.3.3
-
-### Patch Changes
-
-- 99b8247: Simplify and unify handling file uploads
-
-## 0.3.2
-
-### Patch Changes
-
-- 6d1b6b9: Update README.md for pro mode
-
-## 0.3.1
-
-### Patch Changes
-
-- f3577c5: Fix event streaming is blocked
-- f3577c5: Add upload file to sandbox (artifact and code interpreter)
-
-## 0.3.0
-
-### Minor Changes
-
-- 7562cb4: Simplified default questions and added pro mode
-
-### Patch Changes
-
-- 0a69fe0: fix: missing params when init Astra vectorstore
-- 98a82b0: docs: chroma env variables
-
 ## 0.2.19
 
 ### Patch Changes

README.md

@@ -12,7 +12,7 @@ npx create-llama@latest
 
 to get started, or watch this video for a demo session:
 
-<img src="https://github.com/user-attachments/assets/c4a7fe18-8e30-498a-96f8-78127dd706b9" width="100%">
+https://github.com/user-attachments/assets/dd3edc36-4453-4416-91c2-d24326c6c167
 
 Once your app is generated, run
 
@@ -24,14 +24,14 @@ to start the development server. You can then visit [http://localhost:3000](http
 
 ## What you'll get
 
-- A set of pre-configured use cases to get you started, e.g. Agentic RAG, Data Analysis, Report Generation, etc.
 - A Next.js-powered front-end using components from [shadcn/ui](https://ui.shadcn.com/). The app is set up as a chat interface that can answer questions about your data or interact with your agent
-- Your choice of two back-ends:
+- Your choice of 3 back-ends:
   - **Next.js**: if you select this option, you’ll have a full-stack Next.js application that you can deploy to a host like [Vercel](https://vercel.com/) in just a few clicks. This uses [LlamaIndex.TS](https://www.npmjs.com/package/llamaindex), our TypeScript library.
-  - **Python FastAPI**: if you select this option, you’ll get a separate backend powered by the [llama-index Python package](https://pypi.org/project/llama-index/), which you can deploy to a service like [Render](https://render.com/) or [fly.io](https://fly.io/). The separate Next.js front-end will connect to this backend.
-- Each back-end has two endpoints:
-  - One streaming chat endpoint, that allow you to send the state of your chat and receive additional responses
-  - One endpoint to upload private files which can be used in your chat
+  - **Express**: if you want a more traditional Node.js application you can generate an Express backend. This also uses LlamaIndex.TS.
+  - **Python FastAPI**: if you select this option, you’ll get a backend powered by the [llama-index Python package](https://pypi.org/project/llama-index/), which you can deploy to a service like Render or fly.io.
+- The back-end has two endpoints (one streaming, the other one non-streaming) that allow you to send the state of your chat and receive additional responses
+- You add arbitrary data sources to your chat, like local files, websites, or data retrieved from a database.
+- Turn your chat into an AI agent by adding tools (functions called by the LLM).
 - The app uses OpenAI by default, so you'll need an OpenAI API key, or you can customize it to use any of the dozens of LLMs we support.
 
 Here's how it looks like:
@@ -40,9 +40,9 @@ https://github.com/user-attachments/assets/d57af1a1-d99b-4e9c-98d9-4cbd1327eff8
 
 ## Using your data
 
-Optionally, you can supply your own data; the app will index it and make use of it, e.g. to answer questions. Your generated app will have a folder called `data` (If you're using Express or Python and generate a frontend, it will be `./backend/data`).
+You can supply your own data; the app will index it and answer questions. Your generated app will have a folder called `data` (If you're using Express or Python and generate a frontend, it will be `./backend/data`).
 
-The app will ingest any supported files you put in this directory. Your Next.js and Express apps use LlamaIndex.TS, so they will be able to ingest any PDF, text, CSV, Markdown, Word and HTML files. The Python backend can read even more types, including video and audio files.
+The app will ingest any supported files you put in this directory. Your Next.js and Express apps use LlamaIndex.TS so they will be able to ingest any PDF, text, CSV, Markdown, Word and HTML files. The Python backend can read even more types, including video and audio files.
 
 Before you can use your data, you need to index it. If you're using the Next.js or Express apps, run:
 
@@ -58,6 +58,10 @@ If you're using the Python backend, you can trigger indexing of your data by cal
 poetry run generate
 ```
 
+## Want a front-end?
+
+Optionally generate a frontend if you've selected the Python or Express back-ends. If you do so, `create-llama` will generate two folders: `frontend`, for your Next.js-based frontend code, and `backend` containing your API.
+
 ## Customizing the AI models
 
 The app will default to OpenAI's `gpt-4o-mini` LLM and `text-embedding-3-large` embedding model.
@@ -90,40 +94,46 @@ Need to install the following packages:
   create-llama@latest
 Ok to proceed? (y) y
 ✔ What is your project named? … my-app
-✔ What app do you want to build? › Agentic RAG
-✔ What language do you want to use? › Python (FastAPI)
-✔ Do you want to use LlamaCloud services? … No / Yes
-✔ Please provide your LlamaCloud API key (leave blank to skip): …
+✔ Which template would you like to use? › Agentic RAG (e.g. chat with docs)
+✔ Which framework would you like to use? › NextJS
+✔ Would you like to set up observability? › No
 ✔ Please provide your OpenAI API key (leave blank to skip): …
+✔ Which data source would you like to use? › Use an example PDF
+✔ Would you like to add another data source? › No
+✔ Would you like to use LlamaParse (improved parser for RAG - requires API key)? … no / yes
+✔ Would you like to use a vector database? › No, just store the data in the file system
+✔ Would you like to build an agent using tools? If so, select the tools here, otherwise just press enter › Weather
 ? How would you like to proceed? › - Use arrow-keys. Return to submit.
-    Just generate code (~1 sec)
-❯   Start in VSCode (~1 sec)
-    Generate code and install dependencies (~2 min)
+   Just generate code (~1 sec)
+❯  Start in VSCode (~1 sec)
+   Generate code and install dependencies (~2 min)
+   Generate code, install dependencies, and run the app (~2 min)
 ```
 
 ### Running non-interactively
 
 You can also pass command line arguments to set up a new project
-non-interactively. For a list of the latest options, call `create-llama --help`.
+non-interactively. See `create-llama --help`:
 
-### Running in pro mode
+```bash
+create-llama <project-directory> [options]
 
-If you prefer more advanced customization options, you can run `create-llama` in pro mode using the `--pro` flag.
+Options:
+  -V, --version                      output the version number
 
-In pro mode, instead of selecting a predefined use case, you'll be prompted to select each technical component of your project. This allows for greater flexibility in customizing your project, including:
+  --use-npm
 
-- **Vector Store**: Choose from a variety of vector stores for keeping your documents, including MongoDB, Pinecone, Weaviate, Qdrant and Chroma.
-- **Tools**: Choose from a variety of agent tools (functions called by the LLM), such as:
-  - Code Interpreter: Executes Python code in a secure Jupyter notebook environment
-  - Artifact Code Generator: Generates code artifacts that can be run in a sandbox
-  - OpenAPI Action: Facilitates requests to a provided OpenAPI schema
-  - Image Generator: Creates images based on text descriptions
-  - Web Search: Performs web searches to retrieve up-to-date information
-- **Data Sources**: Integrate various data sources into your chat application, including local files, websites, or database-retrieved data.
-- **Backend Options**: Besides using Next.js or FastAPI, you can also select to use Express for a more traditional Node.js application.
-- **Observability**: Choose from a variety of LLM observability tools, including LlamaTrace and Traceloop.
+    Explicitly tell the CLI to bootstrap the app using npm
 
-Pro mode is ideal for developers who want fine-grained control over their project's configuration and are comfortable with more technical setup options.
+  --use-pnpm
+
+    Explicitly tell the CLI to bootstrap the app using pnpm
+
+  --use-yarn
+
+    Explicitly tell the CLI to bootstrap the app using Yarn
+
+```
 
 ## LlamaIndex Documentation
 

create-app.ts

@@ -7,16 +7,17 @@ import { getOnline } from "./helpers/is-online";
 import { isWriteable } from "./helpers/is-writeable";
 import { makeDir } from "./helpers/make-dir";
 
+import fs from "fs";
 import terminalLink from "terminal-link";
 import type { InstallTemplateArgs, TemplateObservability } from "./helpers";
 import { installTemplate } from "./helpers";
+import { writeDevcontainer } from "./helpers/devcontainer";
 import { templatesDir } from "./helpers/dir";
 import { toolsRequireConfig } from "./helpers/tools";
-import { configVSCode } from "./helpers/vscode";
 
 export type InstallAppArgs = Omit<
   InstallTemplateArgs,
-  "appName" | "root" | "isOnline" | "port"
+  "appName" | "root" | "isOnline" | "customApiPath"
 > & {
   appPath: string;
   frontend: boolean;
@@ -34,12 +35,12 @@ export async function createApp({
   communityProjectConfig,
   llamapack,
   vectorDb,
+  externalPort,
   postInstallAction,
   dataSources,
   tools,
   useLlamaParse,
   observability,
-  useCase,
 }: InstallAppArgs): Promise<void> {
   const root = path.resolve(appPath);
 
@@ -79,30 +80,39 @@ export async function createApp({
     communityProjectConfig,
     llamapack,
     vectorDb,
+    externalPort,
     postInstallAction,
     dataSources,
     tools,
     useLlamaParse,
     observability,
-    useCase,
   };
 
-  // Install backend
-  await installTemplate({ ...args, backend: true });
-
-  if (frontend && framework === "fastapi" && template !== "llamaindexserver") {
+  if (frontend) {
+    // install backend
+    const backendRoot = path.join(root, "backend");
+    await makeDir(backendRoot);
+    await installTemplate({ ...args, root: backendRoot, backend: true });
     // install frontend
-    const frontendRoot = path.join(root, ".frontend");
+    const frontendRoot = path.join(root, "frontend");
     await makeDir(frontendRoot);
     await installTemplate({
       ...args,
       root: frontendRoot,
       framework: "nextjs",
+      customApiPath: `http://localhost:${externalPort ?? 8000}/api/chat`,
       backend: false,
     });
+    // copy readme for fullstack
+    await fs.promises.copyFile(
+      path.join(templatesDir, "README-fullstack.md"),
+      path.join(root, "README.md"),
+    );
+  } else {
+    await installTemplate({ ...args, backend: true });
   }
 
-  await configVSCode(root, templatesDir, framework);
+  await writeDevcontainer(root, templatesDir, framework, frontend);
 
   process.chdir(root);
   if (tryGitInit(root)) {
@@ -110,7 +120,7 @@ export async function createApp({
     console.log();
   }
 
-  if (toolsRequireConfig(tools) && template !== "llamaindexserver") {
+  if (toolsRequireConfig(tools)) {
     const configFile =
       framework === "fastapi" ? "config/tools.yaml" : "config/tools.json";
     console.log(

e2e/python/resolve_dependencies.spec.ts

@@ -63,6 +63,7 @@ if (
             vectorDb,
             tools: "none",
             port: 3000,
+            externalPort: 8000,
             postInstallAction: "none",
             templateUI: undefined,
             appType: "--no-frontend",
@@ -100,6 +101,7 @@ if (
             vectorDb: "none",
             tools: tool,
             port: 3000,
+            externalPort: 8000,
             postInstallAction: "none",
             templateUI: undefined,
             appType: "--no-frontend",
@@ -133,6 +135,7 @@ if (
             vectorDb: "none",
             tools: "none",
             port: 3000,
+            externalPort: 8000,
             postInstallAction: "none",
             templateUI: undefined,
             appType: "--no-frontend",
@@ -166,6 +169,7 @@ if (
             vectorDb: "none",
             tools: "none",
             port: 3000,
+            externalPort: 8000,
             postInstallAction: "none",
             templateUI: undefined,
             appType: "--no-frontend",

e2e/shared/extractor_template.spec.ts

@@ -0,0 +1,63 @@
+/* eslint-disable turbo/no-undeclared-env-vars */
+import { expect, test } from "@playwright/test";
+import { ChildProcess } from "child_process";
+import fs from "fs";
+import path from "path";
+import { TemplateFramework } from "../../helpers";
+import { createTestDir, runCreateLlama } from "../utils";
+
+const templateFramework: TemplateFramework = process.env.FRAMEWORK
+  ? (process.env.FRAMEWORK as TemplateFramework)
+  : "fastapi";
+const dataSource: string = process.env.DATASOURCE
+  ? process.env.DATASOURCE
+  : "--example-file";
+
+// The extractor template currently only works with FastAPI and files (and not on Windows)
+if (
+  process.platform !== "win32" &&
+  templateFramework === "fastapi" &&
+  dataSource === "--example-file"
+) {
+  test.describe("Test extractor template", async () => {
+    let frontendPort: number;
+    let backendPort: number;
+    let name: string;
+    let appProcess: ChildProcess;
+    let cwd: string;
+
+    // Create extractor app
+    test.beforeAll(async () => {
+      cwd = await createTestDir();
+      frontendPort = Math.floor(Math.random() * 10000) + 10000;
+      backendPort = frontendPort + 1;
+      const result = await runCreateLlama({
+        cwd,
+        templateType: "extractor",
+        templateFramework: "fastapi",
+        dataSource: "--example-file",
+        vectorDb: "none",
+        port: frontendPort,
+        externalPort: backendPort,
+        postInstallAction: "runApp",
+      });
+      name = result.projectName;
+      appProcess = result.appProcess;
+    });
+
+    test.afterAll(async () => {
+      appProcess.kill();
+    });
+
+    test("App folder should exist", async () => {
+      const dirExists = fs.existsSync(path.join(cwd, name));
+      expect(dirExists).toBeTruthy();
+    });
+    test("Frontend should have a title", async ({ page }) => {
+      await page.goto(`http://localhost:${frontendPort}`);
+      await expect(page.getByText("Built by LlamaIndex")).toBeVisible({
+        timeout: 2000 * 60,
+      });
+    });
+  });
+}

e2e/shared/llamaindexserver_template.spec.ts

@@ -1,107 +0,0 @@
-/* eslint-disable turbo/no-undeclared-env-vars */
-import { expect, test } from "@playwright/test";
-import { ChildProcess } from "child_process";
-import fs from "fs";
-import path from "path";
-import type {
-  TemplateFramework,
-  TemplatePostInstallAction,
-  TemplateUI,
-} from "../../helpers";
-import { createTestDir, runCreateLlama, type AppType } from "../utils";
-
-const templateFramework: TemplateFramework = process.env.FRAMEWORK
-  ? (process.env.FRAMEWORK as TemplateFramework)
-  : "fastapi";
-const dataSource: string = "--example-file";
-const templateUI: TemplateUI = "shadcn";
-const templatePostInstallAction: TemplatePostInstallAction = "runApp";
-const appType: AppType = "--frontend";
-const userMessage = "Write a blog post about physical standards for letters";
-const templateUseCases = ["financial_report", "agentic_rag", "deep_research"];
-
-for (const useCase of templateUseCases) {
-  test.describe(`Test use case ${useCase} ${templateFramework} ${dataSource} ${templateUI} ${appType} ${templatePostInstallAction}`, async () => {
-    test.skip(
-      process.platform !== "linux" ||
-        process.env.DATASOURCE === "--no-files" ||
-        templateFramework === "express",
-      "The llamaindexserver template currently only works with nextjs, fastapi. We also only run on Linux to speed up tests.",
-    );
-    let port: number;
-    let cwd: string;
-    let name: string;
-    let appProcess: ChildProcess;
-    // Only test without using vector db for now
-    const vectorDb = "none";
-
-    test.beforeAll(async () => {
-      port = Math.floor(Math.random() * 10000) + 10000;
-      cwd = await createTestDir();
-      const result = await runCreateLlama({
-        cwd,
-        templateType: "llamaindexserver",
-        templateFramework,
-        dataSource,
-        vectorDb,
-        port,
-        postInstallAction: templatePostInstallAction,
-        templateUI,
-        appType,
-        useCase,
-      });
-      name = result.projectName;
-      appProcess = result.appProcess;
-    });
-
-    test("App folder should exist", async () => {
-      const dirExists = fs.existsSync(path.join(cwd, name));
-      expect(dirExists).toBeTruthy();
-    });
-
-    test("Frontend should have a title", async ({ page }) => {
-      test.skip(
-        templatePostInstallAction !== "runApp" ||
-          templateFramework === "express",
-      );
-      await page.goto(`http://localhost:${port}`);
-      await expect(page.getByText("Built by LlamaIndex")).toBeVisible({
-        timeout: 5 * 60 * 1000,
-      });
-    });
-
-    test("Frontend should be able to submit a message and receive the start of a streamed response", async ({
-      page,
-    }) => {
-      test.skip(
-        templatePostInstallAction !== "runApp" ||
-          useCase === "financial_report" ||
-          useCase === "deep_research" ||
-          templateFramework === "express",
-        "Skip chat tests for financial report and deep research.",
-      );
-      await page.goto(`http://localhost:${port}`);
-      await page.fill("form textarea", userMessage);
-
-      const responsePromise = page.waitForResponse((res) =>
-        res.url().includes("/api/chat"),
-      );
-
-      await page.click("form button[type=submit]");
-
-      const response = await responsePromise;
-      console.log(`Response status: ${response.status()}`);
-      const responseBody = await response
-        .text()
-        .catch((e) => `Error reading body: ${e}`);
-      console.log(`Response body: ${responseBody}`);
-
-      expect(response.ok()).toBeTruthy();
-    });
-
-    // clean processes
-    test.afterAll(async () => {
-      appProcess?.kill();
-    });
-  });
-}

e2e/shared/multiagent_template.spec.ts

@@ -0,0 +1,85 @@
+/* eslint-disable turbo/no-undeclared-env-vars */
+import { expect, test } from "@playwright/test";
+import { ChildProcess } from "child_process";
+import fs from "fs";
+import path from "path";
+import type {
+  TemplateFramework,
+  TemplatePostInstallAction,
+  TemplateUI,
+} from "../../helpers";
+import { createTestDir, runCreateLlama, type AppType } from "../utils";
+
+const templateFramework: TemplateFramework = process.env.FRAMEWORK
+  ? (process.env.FRAMEWORK as TemplateFramework)
+  : "fastapi";
+const dataSource: string = "--example-file";
+const templateUI: TemplateUI = "shadcn";
+const templatePostInstallAction: TemplatePostInstallAction = "runApp";
+const appType: AppType = templateFramework === "nextjs" ? "" : "--frontend";
+const userMessage = "Write a blog post about physical standards for letters";
+
+test.describe(`Test multiagent template ${templateFramework} ${dataSource} ${templateUI} ${appType} ${templatePostInstallAction}`, async () => {
+  test.skip(
+    process.platform !== "linux" || process.env.DATASOURCE === "--no-files",
+    "The multiagent template currently only works with files. We also only run on Linux to speed up tests.",
+  );
+  let port: number;
+  let externalPort: number;
+  let cwd: string;
+  let name: string;
+  let appProcess: ChildProcess;
+  // Only test without using vector db for now
+  const vectorDb = "none";
+
+  test.beforeAll(async () => {
+    port = Math.floor(Math.random() * 10000) + 10000;
+    externalPort = port + 1;
+    cwd = await createTestDir();
+    const result = await runCreateLlama({
+      cwd,
+      templateType: "multiagent",
+      templateFramework,
+      dataSource,
+      vectorDb,
+      port,
+      externalPort,
+      postInstallAction: templatePostInstallAction,
+      templateUI,
+      appType,
+    });
+    name = result.projectName;
+    appProcess = result.appProcess;
+  });
+
+  test("App folder should exist", async () => {
+    const dirExists = fs.existsSync(path.join(cwd, name));
+    expect(dirExists).toBeTruthy();
+  });
+
+  test("Frontend should have a title", async ({ page }) => {
+    await page.goto(`http://localhost:${port}`);
+    await expect(page.getByText("Built by LlamaIndex")).toBeVisible();
+  });
+
+  test("Frontend should be able to submit a message and receive the start of a streamed response", async ({
+    page,
+  }) => {
+    await page.goto(`http://localhost:${port}`);
+    await page.fill("form textarea", userMessage);
+
+    const responsePromise = page.waitForResponse((res) =>
+      res.url().includes("/api/chat"),
+    );
+
+    await page.click("form button[type=submit]");
+
+    const response = await responsePromise;
+    expect(response.ok()).toBeTruthy();
+  });
+
+  // clean processes
+  test.afterAll(async () => {
+    appProcess?.kill();
+  });
+});

e2e/shared/reflex_template.spec.ts

@@ -1,64 +0,0 @@
-/* eslint-disable turbo/no-undeclared-env-vars */
-import { expect, test } from "@playwright/test";
-import { ChildProcess } from "child_process";
-import fs from "fs";
-import path from "path";
-import { TemplateFramework, TemplateUseCase } from "../../helpers";
-import { createTestDir, runCreateLlama } from "../utils";
-
-const templateFramework: TemplateFramework = process.env.FRAMEWORK
-  ? (process.env.FRAMEWORK as TemplateFramework)
-  : "fastapi";
-const dataSource: string = process.env.DATASOURCE
-  ? process.env.DATASOURCE
-  : "--example-file";
-const templateUseCases: TemplateUseCase[] = ["extractor", "contract_review"];
-
-// The reflex template currently only works with FastAPI and files (and not on Windows)
-if (
-  process.platform !== "win32" &&
-  templateFramework === "fastapi" &&
-  dataSource === "--example-file"
-) {
-  for (const useCase of templateUseCases) {
-    test.describe(`Test reflex template ${useCase} ${templateFramework} ${dataSource}`, async () => {
-      let appPort: number;
-      let name: string;
-      let appProcess: ChildProcess;
-      let cwd: string;
-
-      // Create reflex app
-      test.beforeAll(async () => {
-        cwd = await createTestDir();
-        appPort = Math.floor(Math.random() * 10000) + 10000;
-        const result = await runCreateLlama({
-          cwd,
-          templateType: "reflex",
-          templateFramework: "fastapi",
-          dataSource: "--example-file",
-          vectorDb: "none",
-          port: appPort,
-          postInstallAction: "runApp",
-          useCase,
-        });
-        name = result.projectName;
-        appProcess = result.appProcess;
-      });
-
-      test.afterAll(async () => {
-        appProcess.kill();
-      });
-
-      test("App folder should exist", async () => {
-        const dirExists = fs.existsSync(path.join(cwd, name));
-        expect(dirExists).toBeTruthy();
-      });
-      test("Frontend should have a title", async ({ page }) => {
-        await page.goto(`http://localhost:${appPort}`);
-        await expect(page.getByText("Built by LlamaIndex")).toBeVisible({
-          timeout: 2000 * 60,
-        });
-      });
-    });
-  }
-}

e2e/shared/streaming_template.spec.ts

@@ -22,7 +22,7 @@ const templatePostInstallAction: TemplatePostInstallAction = "runApp";
 const llamaCloudProjectName = "create-llama";
 const llamaCloudIndexName = "e2e-test";
 
-const appType: AppType = templateFramework === "fastapi" ? "--frontend" : "";
+const appType: AppType = templateFramework === "nextjs" ? "" : "--frontend";
 const userMessage =
   dataSource !== "--no-files" ? "Physical standard for letters" : "Hello";
 
@@ -35,6 +35,7 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
   }
 
   let port: number;
+  let externalPort: number;
   let cwd: string;
   let name: string;
   let appProcess: ChildProcess;
@@ -43,6 +44,7 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
 
   test.beforeAll(async () => {
     port = Math.floor(Math.random() * 10000) + 10000;
+    externalPort = port + 1;
     cwd = await createTestDir();
     const result = await runCreateLlama({
       cwd,
@@ -51,6 +53,7 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
       dataSource,
       vectorDb,
       port,
+      externalPort,
       postInstallAction: templatePostInstallAction,
       templateUI,
       appType,
@@ -65,11 +68,8 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
     const dirExists = fs.existsSync(path.join(cwd, name));
     expect(dirExists).toBeTruthy();
   });
-
   test("Frontend should have a title", async ({ page }) => {
-    test.skip(
-      templatePostInstallAction !== "runApp" || templateFramework === "express",
-    );
+    test.skip(templatePostInstallAction !== "runApp");
     await page.goto(`http://localhost:${port}`);
     await expect(page.getByText("Built by LlamaIndex")).toBeVisible();
   });
@@ -77,9 +77,7 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
   test("Frontend should be able to submit a message and receive a response", async ({
     page,
   }) => {
-    test.skip(
-      templatePostInstallAction !== "runApp" || templateFramework === "express",
-    );
+    test.skip(templatePostInstallAction !== "runApp");
     await page.goto(`http://localhost:${port}`);
     await page.fill("form textarea", userMessage);
     const [response] = await Promise.all([
@@ -104,7 +102,7 @@ test.describe(`Test streaming template ${templateFramework} ${dataSource} ${temp
     test.skip(templatePostInstallAction !== "runApp");
     test.skip(templateFramework === "nextjs");
     const response = await request.post(
-      `http://localhost:${port}/api/chat/request`,
+      `http://localhost:${externalPort}/api/chat/request`,
       {
         data: {
           messages: [

e2e/typescript/resolve_dependencies.spec.ts

@@ -56,6 +56,7 @@ test.describe("Test resolve TS dependencies", () => {
       dataSource: dataSource,
       vectorDb: vectorDb,
       port: 3000,
+      externalPort: 8000,
       postInstallAction: "none",
       templateUI: undefined,
       appType: templateFramework === "nextjs" ? "" : "--no-frontend",

e2e/utils.ts

@@ -25,6 +25,7 @@ export type RunCreateLlamaOptions = {
   dataSource: string;
   vectorDb: TemplateVectorDB;
   port: number;
+  externalPort: number;
   postInstallAction: TemplatePostInstallAction;
   templateUI?: TemplateUI;
   appType?: AppType;
@@ -33,7 +34,6 @@ export type RunCreateLlamaOptions = {
   tools?: string;
   useLlamaParse?: boolean;
   observability?: string;
-  useCase?: string;
 };
 
 export async function runCreateLlama({
@@ -43,6 +43,7 @@ export async function runCreateLlama({
   dataSource,
   vectorDb,
   port,
+  externalPort,
   postInstallAction,
   templateUI,
   appType,
@@ -51,7 +52,6 @@ export async function runCreateLlama({
   tools,
   useLlamaParse,
   observability,
-  useCase,
 }: RunCreateLlamaOptions): Promise<CreateLlamaResult> {
   if (!process.env.OPENAI_API_KEY || !process.env.LLAMA_CLOUD_API_KEY) {
     throw new Error(
@@ -88,15 +88,21 @@ export async function runCreateLlama({
     ...dataSourceArgs,
     "--vector-db",
     vectorDb,
-    "--use-npm",
+    "--open-ai-key",
+    process.env.OPENAI_API_KEY,
+    "--use-pnpm",
     "--port",
     port,
+    "--external-port",
+    externalPort,
     "--post-install-action",
     postInstallAction,
     "--tools",
     tools ?? "none",
     "--observability",
     "none",
+    "--llama-cloud-key",
+    process.env.LLAMA_CLOUD_API_KEY,
   ];
 
   if (templateUI) {
@@ -113,14 +119,6 @@ export async function runCreateLlama({
   if (observability) {
     commandArgs.push("--observability", observability);
   }
-  if (
-    (templateType === "multiagent" ||
-      templateType === "reflex" ||
-      templateType === "llamaindexserver") &&
-    useCase
-  ) {
-    commandArgs.push("--use-case", useCase);
-  }
 
   const command = commandArgs.join(" ");
   console.log(`running command '${command}' in ${cwd}`);
@@ -143,7 +141,12 @@ export async function runCreateLlama({
 
   // Wait for app to start
   if (postInstallAction === "runApp") {
-    await waitPorts([port]);
+    await checkAppHasStarted(
+      appType === "--frontend",
+      templateFramework,
+      port,
+      externalPort,
+    );
   } else if (postInstallAction === "dependencies") {
     await waitForProcess(appProcess, 1000 * 60); // wait 1 min for dependencies to be resolved
   } else {
@@ -163,6 +166,19 @@ export async function createTestDir() {
   return cwd;
 }
 
+// eslint-disable-next-line max-params
+async function checkAppHasStarted(
+  frontend: boolean,
+  framework: TemplateFramework,
+  port: number,
+  externalPort: number,
+) {
+  const portsToWait = frontend
+    ? [port, externalPort]
+    : [framework === "nextjs" ? port : externalPort];
+  await waitPorts(portsToWait);
+}
+
 async function waitPorts(ports: number[]): Promise<void> {
   const waitForPort = async (port: number): Promise<void> => {
     await waitPort({

helpers/copy.ts

@@ -61,9 +61,6 @@ export const assetRelocator = (name: string) => {
     case "README-template.md": {
       return "README.md";
     }
-    case "vscode_settings.json": {
-      return "settings.json";
-    }
     default: {
       return name;
     }

helpers/datasources.ts

@@ -11,47 +11,6 @@ export const EXAMPLE_FILE: TemplateDataSource = {
   },
 };
 
-export const EXAMPLE_10K_SEC_FILES: TemplateDataSource[] = [
-  {
-    type: "file",
-    config: {
-      url: new URL(
-        "https://s2.q4cdn.com/470004039/files/doc_earnings/2023/q4/filing/_10-K-Q4-2023-As-Filed.pdf",
-      ),
-      filename: "apple_10k_report.pdf",
-    },
-  },
-  {
-    type: "file",
-    config: {
-      url: new URL(
-        "https://ir.tesla.com/_flysystem/s3/sec/000162828024002390/tsla-20231231-gen.pdf",
-      ),
-      filename: "tesla_10k_report.pdf",
-    },
-  },
-];
-
-export const EXAMPLE_GDPR: TemplateDataSource = {
-  type: "file",
-  config: {
-    url: new URL(
-      "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32016R0679",
-    ),
-    filename: "gdpr.pdf",
-  },
-};
-
-export const AI_REPORTS: TemplateDataSource = {
-  type: "file",
-  config: {
-    url: new URL(
-      "https://www.europarl.europa.eu/RegData/etudes/ATAG/2024/760392/EPRS_ATA(2024)760392_EN.pdf",
-    ),
-    filename: "EPRS_ATA_2024_760392_EN.pdf",
-  },
-};
-
 export function getDataSources(
   files?: string,
   exampleFile?: boolean,

helpers/devcontainer.ts

@@ -1,26 +1,40 @@
 import fs from "fs";
 import path from "path";
-import { assetRelocator, copy } from "./copy";
 import { TemplateFramework } from "./types";
 
 function renderDevcontainerContent(
   templatesDir: string,
   framework: TemplateFramework,
+  frontend: boolean,
 ) {
   const devcontainerJson: any = JSON.parse(
     fs.readFileSync(path.join(templatesDir, "devcontainer.json"), "utf8"),
   );
 
   // Modify postCreateCommand
-  devcontainerJson.postCreateCommand =
-    framework === "fastapi" ? "poetry install" : "npm install";
+  if (frontend) {
+    devcontainerJson.postCreateCommand =
+      framework === "fastapi"
+        ? "cd backend && poetry install && cd ../frontend && npm install"
+        : "cd backend && npm install && cd ../frontend && npm install";
+  } else {
+    devcontainerJson.postCreateCommand =
+      framework === "fastapi" ? "poetry install" : "npm install";
+  }
 
   // Modify containerEnv
   if (framework === "fastapi") {
-    devcontainerJson.containerEnv = {
-      ...devcontainerJson.containerEnv,
-      PYTHONPATH: "${PYTHONPATH}:${workspaceFolder}",
-    };
+    if (frontend) {
+      devcontainerJson.containerEnv = {
+        ...devcontainerJson.containerEnv,
+        PYTHONPATH: "${PYTHONPATH}:${workspaceFolder}/backend",
+      };
+    } else {
+      devcontainerJson.containerEnv = {
+        ...devcontainerJson.containerEnv,
+        PYTHONPATH: "${PYTHONPATH}:${workspaceFolder}",
+      };
+    }
   }
 
   return JSON.stringify(devcontainerJson, null, 2);
@@ -30,6 +44,7 @@ export const writeDevcontainer = async (
   root: string,
   templatesDir: string,
   framework: TemplateFramework,
+  frontend: boolean,
 ) => {
   const devcontainerDir = path.join(root, ".devcontainer");
   if (fs.existsSync(devcontainerDir)) {
@@ -39,6 +54,7 @@ export const writeDevcontainer = async (
   const devcontainerContent = renderDevcontainerContent(
     templatesDir,
     framework,
+    frontend,
   );
   fs.mkdirSync(devcontainerDir);
   await fs.promises.writeFile(
@@ -46,25 +62,3 @@ export const writeDevcontainer = async (
     devcontainerContent,
   );
 };
-
-export const copyVSCodeSettings = async (
-  root: string,
-  templatesDir: string,
-) => {
-  const vscodeDir = path.join(root, ".vscode");
-  await copy("vscode_settings.json", vscodeDir, {
-    cwd: templatesDir,
-    rename: assetRelocator,
-  });
-};
-
-export const configVSCode = async (
-  root: string,
-  templatesDir: string,
-  framework: TemplateFramework,
-) => {
-  await writeDevcontainer(root, templatesDir, framework);
-  if (framework === "fastapi") {
-    await copyVSCodeSettings(root, templatesDir);
-  }
-};

helpers/env-variables.ts

@@ -13,12 +13,6 @@ import {
 
 import { TSYSTEMS_LLMHUB_API_URL } from "./providers/llmhub";
 
-const DEFAULT_SYSTEM_PROMPT =
-  "You are a helpful assistant who helps users with their questions.";
-
-const DATA_SOURCES_PROMPT =
-  "You have access to a knowledge base including the facts that you should start with to find the answer for the user question. Use the query engine tool to retrieve the facts from the knowledge base.";
-
 export type EnvVar = {
   name?: string;
   description?: string;
@@ -44,7 +38,6 @@ const renderEnvVar = (envVars: EnvVar[]): string => {
 const getVectorDBEnvs = (
   vectorDb?: TemplateVectorDB,
   framework?: TemplateFramework,
-  template?: TemplateType,
 ): EnvVar[] => {
   if (!vectorDb || !framework) {
     return [];
@@ -169,7 +162,7 @@ const getVectorDBEnvs = (
           description:
             "The organization ID for the LlamaCloud project (uses default organization if not specified)",
         },
-        ...(framework === "nextjs" && template !== "llamaindexserver"
+        ...(framework === "nextjs"
           ? // activate index selector per default (not needed for non-NextJS backends as it's handled by createFrontendEnvFile)
             [
               {
@@ -224,15 +217,7 @@ Otherwise, use CHROMA_HOST and CHROMA_PORT config above`,
         },
       ];
     default:
-      return template !== "llamaindexserver"
-        ? [
-            {
-              name: "STORAGE_CACHE_DIR",
-              description: "The directory to store the local storage cache.",
-              value: ".cache",
-            },
-          ]
-        : [];
+      return [];
   }
 };
 
@@ -351,20 +336,6 @@ const getModelEnvs = (modelConfig: ModelConfig): EnvVar[] => {
           },
         ]
       : []),
-    ...(modelConfig.provider === "huggingface"
-      ? [
-          {
-            name: "EMBEDDING_BACKEND",
-            description:
-              "The backend to use for the Sentence Transformers embedding model, either 'torch', 'onnx', or 'openvino'. Defaults to 'onnx'.",
-          },
-          {
-            name: "EMBEDDING_TRUST_REMOTE_CODE",
-            description:
-              "Whether to trust remote code for the embedding model, required for some models with custom code.",
-          },
-        ]
-      : []),
     ...(modelConfig.provider === "t-systems"
       ? [
           {
@@ -385,48 +356,37 @@ const getModelEnvs = (modelConfig: ModelConfig): EnvVar[] => {
 
 const getFrameworkEnvs = (
   framework: TemplateFramework,
-  template: TemplateType,
   port?: number,
 ): EnvVar[] => {
   const sPort = port?.toString() || "8000";
-  const result: EnvVar[] =
-    template !== "llamaindexserver"
-      ? [
-          {
-            name: "FILESERVER_URL_PREFIX",
-            description:
-              "FILESERVER_URL_PREFIX is the URL prefix of the server storing the images generated by the interpreter.",
-            value:
-              framework === "nextjs"
-                ? // FIXME: if we are using nextjs, port should be 3000
-                  "http://localhost:3000/api/files"
-                : `http://localhost:${sPort}/api/files`,
-          },
-        ]
-      : [];
+  const result: EnvVar[] = [
+    {
+      name: "FILESERVER_URL_PREFIX",
+      description:
+        "FILESERVER_URL_PREFIX is the URL prefix of the server storing the images generated by the interpreter.",
+      value:
+        framework === "nextjs"
+          ? // FIXME: if we are using nextjs, port should be 3000
+            "http://localhost:3000/api/files"
+          : `http://localhost:${sPort}/api/files`,
+    },
+  ];
   if (framework === "fastapi") {
     result.push(
       ...[
         {
           name: "APP_HOST",
-          description: "The address to start the FastAPI app.",
+          description: "The address to start the backend app.",
           value: "0.0.0.0",
         },
         {
           name: "APP_PORT",
-          description: "The port to start the FastAPI app.",
+          description: "The port to start the backend app.",
           value: sPort,
         },
       ],
     );
   }
-  if (framework === "nextjs" && template !== "llamaindexserver") {
-    result.push({
-      name: "NEXT_PUBLIC_CHAT_API",
-      description:
-        "The API for the chat endpoint. Set when using a custom backend (e.g. Express). Use full URL like http://localhost:8000/api/chat",
-    });
-  }
   return result;
 };
 
@@ -462,6 +422,9 @@ const getSystemPromptEnv = (
   dataSources?: TemplateDataSource[],
   template?: TemplateType,
 ): EnvVar[] => {
+  const defaultSystemPrompt =
+    "You are a helpful assistant who helps users with their questions.";
+
   const systemPromptEnv: EnvVar[] = [];
   // build tool system prompt by merging all tool system prompts
   // multiagent template doesn't need system prompt
@@ -476,12 +439,9 @@ const getSystemPromptEnv = (
       }
     });
 
-    const systemPrompt =
-      '"' +
-      DEFAULT_SYSTEM_PROMPT +
-      (dataSources?.length ? `\n${DATA_SOURCES_PROMPT}` : "") +
-      (toolSystemPrompt ? `\n${toolSystemPrompt}` : "") +
-      '"';
+    const systemPrompt = toolSystemPrompt
+      ? `\"${toolSystemPrompt}\"`
+      : defaultSystemPrompt;
 
     systemPromptEnv.push({
       name: "SYSTEM_PROMPT",
@@ -532,7 +492,7 @@ Here is the conversation history
 ---------------------
 {conversation}
 ---------------------
-Given the conversation history, please give me 3 questions that user might ask next!
+Given the conversation history, please give me 3 questions that you might ask next!
 Your answer should be wrapped in three sticks which follows the following format:
 \`\`\`
 <question 1>
@@ -573,44 +533,28 @@ export const createBackendEnvFile = async (
     | "framework"
     | "dataSources"
     | "template"
-    | "port"
+    | "externalPort"
     | "tools"
     | "observability"
-    | "useLlamaParse"
   >,
 ) => {
   // Init env values
   const envFileName = ".env";
   const envVars: EnvVar[] = [
-    ...(opts.useLlamaParse
-      ? [
-          {
-            name: "LLAMA_CLOUD_API_KEY",
-            description: `The Llama Cloud API key.`,
-            value: opts.llamaCloudKey,
-          },
-        ]
-      : []),
-    ...getVectorDBEnvs(opts.vectorDb, opts.framework, opts.template),
-    ...getToolEnvs(opts.tools),
-    ...getFrameworkEnvs(opts.framework, opts.template, opts.port),
+    {
+      name: "LLAMA_CLOUD_API_KEY",
+      description: `The Llama Cloud API key.`,
+      value: opts.llamaCloudKey,
+    },
     // Add environment variables of each component
-    ...(opts.template === "llamaindexserver"
-      ? [
-          {
-            name: "OPENAI_API_KEY",
-            description: "The OpenAI API key to use.",
-            value: opts.modelConfig.apiKey,
-          },
-        ]
-      : [
-          // don't use this stuff for llama-indexserver
-          ...getModelEnvs(opts.modelConfig),
-          ...getEngineEnvs(),
-          ...getTemplateEnvs(opts.template),
-          ...getObservabilityEnvs(opts.observability),
-          ...getSystemPromptEnv(opts.tools, opts.dataSources, opts.template),
-        ]),
+    ...getModelEnvs(opts.modelConfig),
+    ...getEngineEnvs(),
+    ...getVectorDBEnvs(opts.vectorDb, opts.framework),
+    ...getFrameworkEnvs(opts.framework, opts.externalPort),
+    ...getToolEnvs(opts.tools),
+    ...getTemplateEnvs(opts.template),
+    ...getObservabilityEnvs(opts.observability),
+    ...getSystemPromptEnv(opts.tools, opts.dataSources, opts.template),
   ];
   // Render and write env file
   const content = renderEnvVar(envVars);
@@ -621,10 +565,18 @@ export const createBackendEnvFile = async (
 export const createFrontendEnvFile = async (
   root: string,
   opts: {
+    customApiPath?: string;
     vectorDb?: TemplateVectorDB;
   },
 ) => {
   const defaultFrontendEnvs = [
+    {
+      name: "NEXT_PUBLIC_CHAT_API",
+      description: "The backend API for chat endpoint.",
+      value: opts.customApiPath
+        ? opts.customApiPath
+        : "http://localhost:8000/api/chat",
+    },
     {
       name: "NEXT_PUBLIC_USE_LLAMACLOUD",
       description: "Let's the user change indexes in LlamaCloud projects",

helpers/index.ts

@@ -1,7 +1,7 @@
 import { callPackageManager } from "./install";
 
 import path from "path";
-import picocolors, { cyan } from "picocolors";
+import { cyan } from "picocolors";
 
 import fsExtra from "fs-extra";
 import { writeLoadersConfig } from "./datasources";
@@ -41,11 +41,7 @@ const checkForGenerateScript = (
     missingSettings.push("your LLAMA_CLOUD_API_KEY");
   }
 
-  if (
-    vectorDb !== undefined &&
-    vectorDb !== "none" &&
-    vectorDb !== "llamacloud"
-  ) {
+  if (vectorDb !== "none" && vectorDb !== "llamacloud") {
     missingSettings.push("your Vector DB environment variables");
   }
 
@@ -96,16 +92,10 @@ async function generateContextData(
     }
 
     const settingsMessage = `After setting ${missingSettings.join(" and ")}, run ${runGenerate} to generate the context data.`;
-    console.log(picocolors.yellow(`\n${settingsMessage}\n\n`));
+    console.log(`\n${settingsMessage}\n\n`);
   }
 }
 
-const downloadFile = async (url: string, destPath: string) => {
-  const response = await fetch(url);
-  const fileBuffer = await response.arrayBuffer();
-  await fsExtra.writeFile(destPath, Buffer.from(fileBuffer));
-};
-
 const prepareContextData = async (
   root: string,
   dataSources: TemplateDataSource[],
@@ -113,29 +103,12 @@ const prepareContextData = async (
   await makeDir(path.join(root, "data"));
   for (const dataSource of dataSources) {
     const dataSourceConfig = dataSource?.config as FileSourceConfig;
-    // If the path is URLs, download the data and save it to the data directory
-    if ("url" in dataSourceConfig) {
-      console.log(
-        "Downloading file from URL:",
-        dataSourceConfig.url.toString(),
-      );
-      const destPath = path.join(
-        root,
-        "data",
-        dataSourceConfig.filename ??
-          path.basename(dataSourceConfig.url.toString()),
-      );
-      await downloadFile(dataSourceConfig.url.toString(), destPath);
-    } else {
-      // Copy local data
-      console.log("Copying data from path:", dataSourceConfig.path);
-      const destPath = path.join(
-        root,
-        "data",
-        path.basename(dataSourceConfig.path),
-      );
-      await fsExtra.copy(dataSourceConfig.path, destPath);
-    }
+    // Copy local data
+    const dataPath = dataSourceConfig.path;
+
+    const destPath = path.join(root, "data", path.basename(dataPath));
+    console.log("Copying data from path:", dataPath);
+    await fsExtra.copy(dataPath, destPath);
   }
 };
 
@@ -170,17 +143,6 @@ export const installTemplate = async (
 
   if (props.framework === "fastapi") {
     await installPythonTemplate(props);
-  } else {
-    await installTSTemplate(props);
-  }
-
-  // write configurations
-  if (props.template !== "llamaindexserver") {
-    await writeToolsConfig(
-      props.root,
-      props.tools,
-      props.framework === "fastapi" ? ConfigFileType.YAML : ConfigFileType.JSON,
-    );
     if (props.vectorDb !== "llamacloud") {
       // write loaders configuration (currently Python only)
       // not needed for LlamaCloud as it has its own loaders
@@ -190,13 +152,26 @@ export const installTemplate = async (
         props.useLlamaParse,
       );
     }
+  } else {
+    await installTSTemplate(props);
   }
 
+  // write tools configuration
+  await writeToolsConfig(
+    props.root,
+    props.tools,
+    props.framework === "fastapi" ? ConfigFileType.YAML : ConfigFileType.JSON,
+  );
+
   if (props.backend) {
     // This is a backend, so we need to copy the test data and create the env file.
 
     // Copy the environment file to the target directory.
-    if (props.template !== "community" && props.template !== "llamapack") {
+    if (
+      props.template === "streaming" ||
+      props.template === "multiagent" ||
+      props.template === "extractor"
+    ) {
       await createBackendEnvFile(props.root, props);
     }
 
@@ -228,6 +203,7 @@ export const installTemplate = async (
   } else {
     // this is a frontend for a full-stack app, create .env file with model information
     await createFrontendEnvFile(props.root, {
+      customApiPath: props.customApiPath,
       vectorDb: props.vectorDb,
     });
   }

helpers/providers/anthropic.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import prompts from "prompts";
 import { ModelConfigParams } from ".";
 import { questionHandlers, toChoice } from "../../questions/utils";
@@ -69,7 +70,9 @@ export async function askAnthropicQuestions({
     config.apiKey = key || process.env.ANTHROPIC_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/azure.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import prompts from "prompts";
 import { ModelConfigParams, ModelConfigQuestionsParams } from ".";
 import { questionHandlers } from "../../questions/utils";
@@ -66,7 +67,9 @@ export async function askAzureQuestions({
     },
   };
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/gemini.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import prompts from "prompts";
 import { ModelConfigParams } from ".";
 import { questionHandlers, toChoice } from "../../questions/utils";
@@ -53,7 +54,9 @@ export async function askGeminiQuestions({
     config.apiKey = key || process.env.GOOGLE_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/groq.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import prompts from "prompts";
 import { ModelConfigParams } from ".";
 import { questionHandlers, toChoice } from "../../questions/utils";
@@ -109,7 +110,9 @@ export async function askGroqQuestions({
     config.apiKey = key || process.env.GROQ_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const modelChoices = await getAvailableModelChoicesGroq(config.apiKey!);
 
     const { model } = await prompts(

helpers/providers/huggingface.ts

@@ -1,68 +0,0 @@
-import prompts from "prompts";
-import { ModelConfigParams } from ".";
-import { questionHandlers, toChoice } from "../../questions/utils";
-
-const MODELS = ["HuggingFaceH4/zephyr-7b-alpha"];
-type ModelData = {
-  dimensions: number;
-};
-const EMBEDDING_MODELS: Record<string, ModelData> = {
-  "BAAI/bge-small-en-v1.5": { dimensions: 384 },
-  "BAAI/bge-base-en-v1.5": { dimensions: 768 },
-  "BAAI/bge-large-en-v1.5": { dimensions: 1024 },
-  "sentence-transformers/all-MiniLM-L6-v2": { dimensions: 384 },
-  "sentence-transformers/all-mpnet-base-v2": { dimensions: 768 },
-  "intfloat/multilingual-e5-large": { dimensions: 1024 },
-  "mixedbread-ai/mxbai-embed-large-v1": { dimensions: 1024 },
-  "nomic-ai/nomic-embed-text-v1.5": { dimensions: 768 },
-};
-
-const DEFAULT_MODEL = MODELS[0];
-const DEFAULT_EMBEDDING_MODEL = Object.keys(EMBEDDING_MODELS)[0];
-const DEFAULT_DIMENSIONS = Object.values(EMBEDDING_MODELS)[0].dimensions;
-
-type HuggingfaceQuestionsParams = {
-  askModels: boolean;
-};
-
-export async function askHuggingfaceQuestions({
-  askModels,
-}: HuggingfaceQuestionsParams): Promise<ModelConfigParams> {
-  const config: ModelConfigParams = {
-    model: DEFAULT_MODEL,
-    embeddingModel: DEFAULT_EMBEDDING_MODEL,
-    dimensions: DEFAULT_DIMENSIONS,
-    isConfigured(): boolean {
-      return true;
-    },
-  };
-
-  if (askModels) {
-    const { model } = await prompts(
-      {
-        type: "select",
-        name: "model",
-        message: "Which Hugging Face model would you like to use?",
-        choices: MODELS.map(toChoice),
-        initial: 0,
-      },
-      questionHandlers,
-    );
-    config.model = model;
-
-    const { embeddingModel } = await prompts(
-      {
-        type: "select",
-        name: "embeddingModel",
-        message: "Which embedding model would you like to use?",
-        choices: Object.keys(EMBEDDING_MODELS).map(toChoice),
-        initial: 0,
-      },
-      questionHandlers,
-    );
-    config.embeddingModel = embeddingModel;
-    config.dimensions = EMBEDDING_MODELS[embeddingModel].dimensions;
-  }
-
-  return config;
-}

helpers/providers/index.ts

@@ -5,7 +5,6 @@ import { askAnthropicQuestions } from "./anthropic";
 import { askAzureQuestions } from "./azure";
 import { askGeminiQuestions } from "./gemini";
 import { askGroqQuestions } from "./groq";
-import { askHuggingfaceQuestions } from "./huggingface";
 import { askLLMHubQuestions } from "./llmhub";
 import { askMistralQuestions } from "./mistral";
 import { askOllamaQuestions } from "./ollama";
@@ -40,7 +39,6 @@ export async function askModelConfig({
 
     if (framework === "fastapi") {
       choices.push({ title: "T-Systems", value: "t-systems" });
-      choices.push({ title: "Huggingface", value: "huggingface" });
     }
     const { provider } = await prompts(
       {
@@ -78,9 +76,6 @@ export async function askModelConfig({
     case "t-systems":
       modelConfig = await askLLMHubQuestions({ askModels });
       break;
-    case "huggingface":
-      modelConfig = await askHuggingfaceQuestions({ askModels });
-      break;
     default:
       modelConfig = await askOpenAIQuestions({
         openAiKey,

helpers/providers/llmhub.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import got from "got";
 import ora from "ora";
 import { red } from "picocolors";
@@ -79,7 +80,9 @@ export async function askLLMHubQuestions({
     config.apiKey = key || process.env.T_SYSTEMS_LLMHUB_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/mistral.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import prompts from "prompts";
 import { ModelConfigParams } from ".";
 import { questionHandlers, toChoice } from "../../questions/utils";
@@ -52,7 +53,9 @@ export async function askMistralQuestions({
     config.apiKey = key || process.env.MISTRAL_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/ollama.ts

@@ -1,3 +1,4 @@
+import ciInfo from "ci-info";
 import ollama, { type ModelResponse } from "ollama";
 import { red } from "picocolors";
 import prompts from "prompts";
@@ -33,7 +34,9 @@ export async function askOllamaQuestions({
     },
   };
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/providers/openai.ts

@@ -1,9 +1,9 @@
+import ciInfo from "ci-info";
 import got from "got";
 import ora from "ora";
 import { red } from "picocolors";
 import prompts from "prompts";
 import { ModelConfigParams, ModelConfigQuestionsParams } from ".";
-import { isCI } from "../../questions";
 import { questionHandlers } from "../../questions/utils";
 
 const OPENAI_API_URL = "https://api.openai.com/v1";
@@ -31,7 +31,7 @@ export async function askOpenAIQuestions({
     },
   };
 
-  if (!config.apiKey && !isCI) {
+  if (!config.apiKey) {
     const { key } = await prompts(
       {
         type: "text",
@@ -54,7 +54,9 @@ export async function askOpenAIQuestions({
     config.apiKey = key || process.env.OPENAI_API_KEY;
   }
 
-  if (askModels) {
+  // use default model values in CI or if user should not be asked
+  const useDefaults = ciInfo.isCI || !askModels;
+  if (!useDefaults) {
     const { model } = await prompts(
       {
         type: "select",

helpers/python.ts

@@ -12,7 +12,6 @@ import {
   InstallTemplateArgs,
   ModelConfig,
   TemplateDataSource,
-  TemplateObservability,
   TemplateType,
   TemplateVectorDB,
 } from "./types";
@@ -21,7 +20,6 @@ interface Dependency {
   name: string;
   version?: string;
   extras?: string[];
-  constraints?: Record<string, string>;
 }
 
 const getAdditionalDependencies = (
@@ -30,7 +28,6 @@ const getAdditionalDependencies = (
   dataSources?: TemplateDataSource[],
   tools?: Tool[],
   templateType?: TemplateType,
-  observability?: TemplateObservability,
 ) => {
   const dependencies: Dependency[] = [];
 
@@ -39,31 +36,28 @@ const getAdditionalDependencies = (
     case "mongo": {
       dependencies.push({
         name: "llama-index-vector-stores-mongodb",
-        version: "^0.6.0",
+        version: "^0.3.1",
       });
       break;
     }
     case "pg": {
       dependencies.push({
         name: "llama-index-vector-stores-postgres",
-        version: "^0.3.2",
+        version: "^0.2.5",
       });
       break;
     }
     case "pinecone": {
       dependencies.push({
         name: "llama-index-vector-stores-pinecone",
-        version: "^0.4.1",
-        constraints: {
-          python: ">=3.11,<3.13",
-        },
+        version: "^0.2.1",
       });
       break;
     }
     case "milvus": {
       dependencies.push({
         name: "llama-index-vector-stores-milvus",
-        version: "^0.3.0",
+        version: "^0.2.0",
       });
       dependencies.push({
         name: "pymilvus",
@@ -74,38 +68,35 @@ const getAdditionalDependencies = (
     case "astra": {
       dependencies.push({
         name: "llama-index-vector-stores-astra-db",
-        version: "^0.4.0",
+        version: "^0.2.0",
       });
       break;
     }
     case "qdrant": {
       dependencies.push({
         name: "llama-index-vector-stores-qdrant",
-        version: "^0.4.0",
-        constraints: {
-          python: ">=3.11,<3.13",
-        },
+        version: "^0.3.0",
       });
       break;
     }
     case "chroma": {
       dependencies.push({
         name: "llama-index-vector-stores-chroma",
-        version: "^0.4.0",
+        version: "^0.2.0",
       });
       break;
     }
     case "weaviate": {
       dependencies.push({
         name: "llama-index-vector-stores-weaviate",
-        version: "^1.2.3",
+        version: "^1.1.1",
       });
       break;
     }
     case "llamacloud":
       dependencies.push({
         name: "llama-index-indices-managed-llama-cloud",
-        version: "0.6.3",
+        version: "^0.3.1",
       });
       break;
   }
@@ -124,13 +115,13 @@ const getAdditionalDependencies = (
         case "web":
           dependencies.push({
             name: "llama-index-readers-web",
-            version: "^0.3.0",
+            version: "^0.2.2",
           });
           break;
         case "db":
           dependencies.push({
             name: "llama-index-readers-database",
-            version: "^0.3.0",
+            version: "^0.2.0",
           });
           dependencies.push({
             name: "pymysql",
@@ -169,15 +160,15 @@ const getAdditionalDependencies = (
       if (templateType !== "multiagent") {
         dependencies.push({
           name: "llama-index-llms-openai",
-          version: "^0.3.2",
+          version: "^0.2.0",
         });
         dependencies.push({
           name: "llama-index-embeddings-openai",
-          version: "^0.3.1",
+          version: "^0.2.3",
         });
         dependencies.push({
           name: "llama-index-agent-openai",
-          version: "^0.4.0",
+          version: "^0.3.0",
         });
       }
       break;
@@ -243,21 +234,6 @@ const getAdditionalDependencies = (
         version: "0.2.4",
       });
       break;
-    case "huggingface":
-      dependencies.push({
-        name: "llama-index-llms-huggingface",
-        version: "^0.3.5",
-      });
-      dependencies.push({
-        name: "llama-index-embeddings-huggingface",
-        version: "^0.3.1",
-      });
-      dependencies.push({
-        name: "optimum",
-        version: "^1.23.3",
-        extras: ["onnxruntime"],
-      });
-      break;
     case "t-systems":
       dependencies.push({
         name: "llama-index-agent-openai",
@@ -270,21 +246,6 @@ const getAdditionalDependencies = (
       break;
   }
 
-  if (observability && observability !== "none") {
-    if (observability === "traceloop") {
-      dependencies.push({
-        name: "traceloop-sdk",
-        version: "^0.15.11",
-      });
-    }
-    if (observability === "llamatrace") {
-      dependencies.push({
-        name: "llama-index-callbacks-arize-phoenix",
-        version: "^0.3.0",
-      });
-    }
-  }
-
   return dependencies;
 };
 
@@ -303,19 +264,14 @@ const mergePoetryDependencies = (
     value.version = dependency.version ?? value.version;
     value.extras = dependency.extras ?? value.extras;
 
-    // Merge constraints if they exist
-    if (dependency.constraints) {
-      value = { ...value, ...dependency.constraints };
-    }
-
     if (value.version === undefined) {
       throw new Error(
         `Dependency "${dependency.name}" is missing attribute "version"!`,
       );
     }
 
-    // Serialize as object if there are any additional properties
-    if (Object.keys(value).length > 1) {
+    // Serialize separately only if extras are provided
+    if (value.extras && value.extras.length > 0) {
       existingDependencies[dependency.name] = value;
     } else {
       // Otherwise, serialize just the version string
@@ -396,24 +352,41 @@ export const installPythonDependencies = (
   }
 };
 
-const installLegacyPythonTemplate = async ({
+export const installPythonTemplate = async ({
   root,
   template,
+  framework,
   vectorDb,
   dataSources,
   tools,
-  useCase,
+  postInstallAction,
   observability,
+  modelConfig,
 }: Pick<
   InstallTemplateArgs,
   | "root"
+  | "framework"
   | "template"
   | "vectorDb"
   | "dataSources"
   | "tools"
-  | "useCase"
+  | "postInstallAction"
   | "observability"
+  | "modelConfig"
 >) => {
+  console.log("\nInitializing Python project with template:", template, "\n");
+  let templatePath;
+  if (template === "extractor") {
+    templatePath = path.join(templatesDir, "types", "extractor", framework);
+  } else {
+    templatePath = path.join(templatesDir, "types", "streaming", framework);
+  }
+  await copy("**", root, {
+    parents: true,
+    cwd: templatePath,
+    rename: assetRelocator,
+  });
+
   const compPath = path.join(templatesDir, "components");
   const enginePath = path.join(root, "app", "engine");
 
@@ -474,36 +447,40 @@ const installLegacyPythonTemplate = async ({
     await copyRouterCode(root, tools ?? []);
   }
 
-  // Copy multiagents overrides
   if (template === "multiagent") {
+    // Copy multi-agent code
     await copy("**", path.join(root), {
+      parents: true,
       cwd: path.join(compPath, "multiagent", "python"),
+      rename: assetRelocator,
     });
   }
 
-  if (template === "multiagent" || template === "reflex") {
-    if (useCase) {
-      const sourcePath =
-        template === "multiagent"
-          ? path.join(compPath, "agents", "python", useCase)
-          : path.join(compPath, "reflex", useCase);
+  console.log("Adding additional dependencies");
 
-      await copy("**", path.join(root), {
-        parents: true,
-        cwd: sourcePath,
-        rename: assetRelocator,
-      });
-    } else {
-      console.log(
-        red(
-          `There is no use case selected for ${template} template. Please pick a use case to use via --use-case flag.`,
-        ),
-      );
-      process.exit(1);
-    }
-  }
+  const addOnDependencies = getAdditionalDependencies(
+    modelConfig,
+    vectorDb,
+    dataSources,
+    tools,
+    template,
+  );
 
   if (observability && observability !== "none") {
+    if (observability === "traceloop") {
+      addOnDependencies.push({
+        name: "traceloop-sdk",
+        version: "^0.15.11",
+      });
+    }
+
+    if (observability === "llamatrace") {
+      addOnDependencies.push({
+        name: "llama-index-callbacks-arize-phoenix",
+        version: "^0.2.1",
+      });
+    }
+
     const templateObservabilityPath = path.join(
       templatesDir,
       "components",
@@ -515,137 +492,15 @@ const installLegacyPythonTemplate = async ({
       cwd: templateObservabilityPath,
     });
   }
-};
-
-const installLlamaIndexServerTemplate = async ({
-  root,
-  useCase,
-  useLlamaParse,
-}: Pick<InstallTemplateArgs, "root" | "useCase" | "useLlamaParse">) => {
-  if (!useCase) {
-    console.log(
-      red(
-        `There is no use case selected. Please pick a use case to use via --use-case flag.`,
-      ),
-    );
-    process.exit(1);
-  }
-
-  await copy("workflow.py", path.join(root, "app"), {
-    parents: true,
-    cwd: path.join(templatesDir, "components", "workflows", "python", useCase),
-  });
-
-  // Copy custom UI component code
-  await copy(`*`, path.join(root, "components"), {
-    parents: true,
-    cwd: path.join(templatesDir, "components", "ui", "workflows", useCase),
-  });
-
-  if (useLlamaParse) {
-    await copy("index.py", path.join(root, "app"), {
-      parents: true,
-      cwd: path.join(
-        templatesDir,
-        "components",
-        "vectordbs",
-        "llamaindexserver",
-        "llamacloud",
-        "python",
-      ),
-    });
-    // TODO: Consider moving generate.py to app folder.
-    await copy("generate.py", path.join(root), {
-      parents: true,
-      cwd: path.join(
-        templatesDir,
-        "components",
-        "vectordbs",
-        "llamaindexserver",
-        "llamacloud",
-        "python",
-      ),
-    });
-  }
-  // Copy README.md
-  await copy("README-template.md", path.join(root), {
-    parents: true,
-    cwd: path.join(templatesDir, "components", "workflows", "python", useCase),
-    rename: assetRelocator,
-  });
-};
-
-export const installPythonTemplate = async ({
-  appName,
-  root,
-  template,
-  framework,
-  vectorDb,
-  postInstallAction,
-  modelConfig,
-  dataSources,
-  tools,
-  useLlamaParse,
-  useCase,
-  observability,
-}: Pick<
-  InstallTemplateArgs,
-  | "appName"
-  | "root"
-  | "template"
-  | "framework"
-  | "vectorDb"
-  | "postInstallAction"
-  | "modelConfig"
-  | "dataSources"
-  | "tools"
-  | "useLlamaParse"
-  | "useCase"
-  | "observability"
->) => {
-  console.log("\nInitializing Python project with template:", template, "\n");
-  let templatePath;
-  if (template === "reflex") {
-    templatePath = path.join(templatesDir, "types", "reflex");
-  } else {
-    templatePath = path.join(templatesDir, "types", template, framework);
-  }
-  await copy("**", root, {
-    parents: true,
-    cwd: templatePath,
-    rename: assetRelocator,
-  });
-
-  if (template === "llamaindexserver") {
-    await installLlamaIndexServerTemplate({
-      root,
-      useCase,
-      useLlamaParse,
-    });
-  } else {
-    await installLegacyPythonTemplate({
-      root,
-      template,
-      vectorDb,
-      dataSources,
-      tools,
-      useCase,
-      observability,
-    });
-  }
-
-  console.log("Adding additional dependencies");
-  const addOnDependencies = getAdditionalDependencies(
-    modelConfig,
-    vectorDb,
-    dataSources,
-    tools,
-    template,
-  );
 
   await addDependencies(root, addOnDependencies);
 
   if (postInstallAction === "runApp" || postInstallAction === "dependencies") {
     installPythonDependencies();
   }
+
+  // Copy deployment files for python
+  await copy("**", root, {
+    cwd: path.join(compPath, "deployments", "python"),
+  });
 };

helpers/run-app.ts

@@ -1,39 +1,40 @@
-import { SpawnOptions, spawn } from "child_process";
-import { TemplateFramework, TemplateType } from "./types";
+import { ChildProcess, SpawnOptions, spawn } from "child_process";
+import path from "path";
+import { TemplateFramework } from "./types";
 
 const createProcess = (
   command: string,
   args: string[],
   options: SpawnOptions,
-): Promise<void> => {
-  return new Promise((resolve, reject) => {
-    spawn(command, args, {
-      ...options,
-      shell: true,
+) => {
+  return spawn(command, args, {
+    ...options,
+    shell: true,
+  })
+    .on("exit", function (code) {
+      if (code !== 0) {
+        console.log(`Child process exited with code=${code}`);
+        process.exit(1);
+      }
     })
-      .on("exit", function (code) {
-        if (code !== 0) {
-          console.log(`Child process exited with code=${code}`);
-          reject(code);
-        } else {
-          resolve();
-        }
-      })
-      .on("error", function (err) {
-        console.log("Error when running child process: ", err);
-        reject(err);
-      });
-  });
+    .on("error", function (err) {
+      console.log("Error when running chill process: ", err);
+      process.exit(1);
+    });
 };
 
-export function runReflexApp(appPath: string, port: number) {
-  const commandArgs = [
-    "run",
-    "reflex",
-    "run",
-    "--frontend-port",
-    port.toString(),
-  ];
+export function runReflexApp(
+  appPath: string,
+  frontendPort?: number,
+  backendPort?: number,
+) {
+  const commandArgs = ["run", "reflex", "run"];
+  if (frontendPort) {
+    commandArgs.push("--frontend-port", frontendPort.toString());
+  }
+  if (backendPort) {
+    commandArgs.push("--backend-port", backendPort.toString());
+  }
   return createProcess("poetry", commandArgs, {
     stdio: "inherit",
     cwd: appPath,
@@ -41,10 +42,11 @@ export function runReflexApp(appPath: string, port: number) {
 }
 
 export function runFastAPIApp(appPath: string, port: number) {
-  return createProcess("poetry", ["run", "dev"], {
+  const commandArgs = ["run", "uvicorn", "main:app", "--port=" + port];
+
+  return createProcess("poetry", commandArgs, {
     stdio: "inherit",
     cwd: appPath,
-    env: { ...process.env, APP_PORT: `${port}` },
   });
 }
 
@@ -58,24 +60,40 @@ export function runTSApp(appPath: string, port: number) {
 
 export async function runApp(
   appPath: string,
-  template: TemplateType,
+  template: string,
+  frontend: boolean,
   framework: TemplateFramework,
   port?: number,
-): Promise<void> {
-  try {
-    // Start the app
-    const defaultPort =
-      framework === "nextjs" || template === "reflex" ? 3000 : 8000;
+  externalPort?: number,
+): Promise<any> {
+  const processes: ChildProcess[] = [];
 
-    const appRunner =
-      template === "reflex"
-        ? runReflexApp
-        : framework === "fastapi"
-          ? runFastAPIApp
-          : runTSApp;
-    await appRunner(appPath, port || defaultPort);
-  } catch (error) {
-    console.error("Failed to run app:", error);
-    throw error;
+  // Callback to kill all sub processes if the main process is killed
+  process.on("exit", () => {
+    console.log("Killing app processes...");
+    processes.forEach((p) => p.kill());
+  });
+
+  // Default sub app paths
+  const backendPath = path.join(appPath, "backend");
+  const frontendPath = path.join(appPath, "frontend");
+
+  if (template === "extractor") {
+    processes.push(runReflexApp(appPath, port, externalPort));
   }
+  if (template === "streaming" || template === "multiagent") {
+    if (framework === "fastapi" || framework === "express") {
+      const backendRunner = framework === "fastapi" ? runFastAPIApp : runTSApp;
+      if (frontend) {
+        processes.push(backendRunner(backendPath, externalPort || 8000));
+        processes.push(runTSApp(frontendPath, port || 3000));
+      } else {
+        processes.push(backendRunner(appPath, externalPort || 8000));
+      }
+    } else if (framework === "nextjs") {
+      processes.push(runTSApp(appPath, port || 3000));
+    }
+  }
+
+  return Promise.all(processes);
 }

helpers/tools.ts

@@ -41,7 +41,7 @@ export const supportedTools: Tool[] = [
     dependencies: [
       {
         name: "llama-index-tools-google",
-        version: "^0.3.0",
+        version: "^0.2.0",
       },
     ],
     supportedFrameworks: ["fastapi"],
@@ -62,16 +62,17 @@ export const supportedTools: Tool[] = [
     dependencies: [
       {
         name: "duckduckgo-search",
-        version: "^6.3.5",
+        version: "6.1.7",
       },
     ],
-    supportedFrameworks: ["fastapi"], // TODO: Re-enable this tool once the duck-duck-scrape TypeScript library works again
+    supportedFrameworks: ["fastapi", "nextjs", "express"],
     type: ToolType.LOCAL,
     envVars: [
       {
         name: TOOL_SYSTEM_PROMPT_ENV_VAR,
         description: "System prompt for DuckDuckGo search tool.",
-        value: `You have access to the duckduckgo search tool. Use it to get information from the web to answer user questions.
+        value: `You are a DuckDuckGo search agent. 
+You can use the duckduckgo search tool to get information from the web to answer user questions.
 For better results, you can specify the region parameter to get results from a specific region but it's optional.`,
       },
     ],
@@ -82,11 +83,18 @@ For better results, you can specify the region parameter to get results from a s
     dependencies: [
       {
         name: "llama-index-tools-wikipedia",
-        version: "^0.3.0",
+        version: "^0.2.0",
       },
     ],
     supportedFrameworks: ["fastapi", "express", "nextjs"],
     type: ToolType.LLAMAHUB,
+    envVars: [
+      {
+        name: TOOL_SYSTEM_PROMPT_ENV_VAR,
+        description: "System prompt for wiki tool.",
+        value: `You are a Wikipedia agent. You help users to get information from Wikipedia.`,
+      },
+    ],
   },
   {
     display: "Weather",
@@ -94,6 +102,13 @@ For better results, you can specify the region parameter to get results from a s
     dependencies: [],
     supportedFrameworks: ["fastapi", "express", "nextjs"],
     type: ToolType.LOCAL,
+    envVars: [
+      {
+        name: TOOL_SYSTEM_PROMPT_ENV_VAR,
+        description: "System prompt for weather tool.",
+        value: `You are a weather forecast agent. You help users to get the weather forecast for a given location.`,
+      },
+    ],
   },
   {
     display: "Document generator",
@@ -124,7 +139,7 @@ For better results, you can specify the region parameter to get results from a s
     dependencies: [
       {
         name: "e2b_code_interpreter",
-        version: "1.1.1",
+        version: "0.0.10",
       },
     ],
     supportedFrameworks: ["fastapi", "express", "nextjs"],
@@ -155,7 +170,7 @@ For better results, you can specify the region parameter to get results from a s
     dependencies: [
       {
         name: "e2b_code_interpreter",
-        version: "1.1.1",
+        version: "^0.0.11b38",
       },
     ],
     supportedFrameworks: ["fastapi", "express", "nextjs"],
@@ -196,6 +211,14 @@ For better results, you can specify the region parameter to get results from a s
     },
     supportedFrameworks: ["fastapi", "express", "nextjs"],
     type: ToolType.LOCAL,
+    envVars: [
+      {
+        name: TOOL_SYSTEM_PROMPT_ENV_VAR,
+        description: "System prompt for openapi action tool.",
+        value:
+          "You are an OpenAPI action agent. You help users to make requests to the provided OpenAPI schema.",
+      },
+    ],
   },
   {
     display: "Image Generator",
@@ -208,6 +231,11 @@ For better results, you can specify the region parameter to get results from a s
         description:
           "STABILITY_API_KEY key is required to run image generator. Get it here: https://platform.stability.ai/account/keys",
       },
+      {
+        name: TOOL_SYSTEM_PROMPT_ENV_VAR,
+        description: "System prompt for image generator tool.",
+        value: `You are an image generator agent. You help users to generate images using the Stability API.`,
+      },
     ],
   },
   {
@@ -239,22 +267,6 @@ For better results, you can specify the region parameter to get results from a s
       },
     ],
   },
-  {
-    display: "Form Filling",
-    name: "form_filling",
-    supportedFrameworks: ["fastapi"],
-    type: ToolType.LOCAL,
-    dependencies: [
-      {
-        name: "pandas",
-        version: "^2.2.3",
-      },
-      {
-        name: "tabulate",
-        version: "^0.9.0",
-      },
-    ],
-  },
 ];
 
 export const getTool = (toolName: string): Tool | undefined => {
@@ -325,16 +337,9 @@ export const writeToolsConfig = async (
       yaml.stringify(configContent),
     );
   } else {
-    // For Typescript, we treat llamahub tools as local tools
-    const tsConfigContent = {
-      local: {
-        ...configContent.local,
-        ...configContent.llamahub,
-      },
-    };
     await fs.writeFile(
       path.join(configPath, "tools.json"),
-      JSON.stringify(tsConfigContent, null, 2),
+      JSON.stringify(configContent, null, 2),
     );
   }
 };

helpers/types.ts

@@ -9,7 +9,6 @@ export type ModelProvider =
   | "gemini"
   | "mistral"
   | "azure-openai"
-  | "huggingface"
   | "t-systems";
 export type ModelConfig = {
   provider: ModelProvider;
@@ -20,12 +19,11 @@ export type ModelConfig = {
   isConfigured(): boolean;
 };
 export type TemplateType =
+  | "extractor"
   | "streaming"
   | "community"
   | "llamapack"
-  | "multiagent"
-  | "reflex"
-  | "llamaindexserver";
+  | "multiagent";
 export type TemplateFramework = "nextjs" | "express" | "fastapi";
 export type TemplateUI = "html" | "shadcn";
 export type TemplateVectorDB =
@@ -50,24 +48,10 @@ export type TemplateDataSource = {
 };
 export type TemplateDataSourceType = "file" | "web" | "db";
 export type TemplateObservability = "none" | "traceloop" | "llamatrace";
-export type TemplateUseCase =
-  | "financial_report"
-  | "blog"
-  | "deep_research"
-  | "form_filling"
-  | "extractor"
-  | "contract_review"
-  | "agentic_rag";
 // Config for both file and folder
-export type FileSourceConfig =
-  | {
-      path: string;
-      filename?: string;
-    }
-  | {
-      url: URL;
-      filename?: string;
-    };
+export type FileSourceConfig = {
+  path: string;
+};
 export type WebSourceConfig = {
   baseUrl?: string;
   prefix?: string;
@@ -99,15 +83,15 @@ export interface InstallTemplateArgs {
   framework: TemplateFramework;
   ui: TemplateUI;
   dataSources: TemplateDataSource[];
+  customApiPath?: string;
   modelConfig: ModelConfig;
   llamaCloudKey?: string;
   useLlamaParse?: boolean;
   communityProjectConfig?: CommunityProjectConfig;
   llamapack?: string;
   vectorDb?: TemplateVectorDB;
-  port?: number;
+  externalPort?: number;
   postInstallAction?: TemplatePostInstallAction;
   tools?: Tool[];
   observability?: TemplateObservability;
-  useCase?: TemplateUseCase;
 }

helpers/typescript.ts

@@ -1,111 +1,47 @@
 import fs from "fs/promises";
 import os from "os";
 import path from "path";
-import { bold, cyan, red, yellow } from "picocolors";
+import { bold, cyan, yellow } from "picocolors";
 import { assetRelocator, copy } from "../helpers/copy";
 import { callPackageManager } from "../helpers/install";
 import { templatesDir } from "./dir";
 import { PackageManager } from "./get-pkg-manager";
-import { InstallTemplateArgs, ModelProvider, TemplateVectorDB } from "./types";
+import { InstallTemplateArgs } from "./types";
 
-const installLlamaIndexServerTemplate = async ({
-  root,
-  useCase,
-  vectorDb,
-}: Pick<InstallTemplateArgs, "root" | "useCase" | "vectorDb">) => {
-  if (!useCase) {
-    console.log(
-      red(
-        `There is no use case selected. Please pick a use case to use via --use-case flag.`,
-      ),
-    );
-    process.exit(1);
-  }
-
-  if (!vectorDb) {
-    console.log(
-      red(
-        `There is no vector db selected. Please pick a vector db to use via --vector-db flag.`,
-      ),
-    );
-    process.exit(1);
-  }
-
-  await copy("workflow.ts", path.join(root, "src", "app"), {
-    parents: true,
-    cwd: path.join(
-      templatesDir,
-      "components",
-      "workflows",
-      "typescript",
-      useCase,
-    ),
-  });
-
-  // copy workflow UI components to output/components folder
-  await copy("*", path.join(root, "components"), {
-    parents: true,
-    cwd: path.join(templatesDir, "components", "ui", "workflows", useCase),
-  });
-
-  if (vectorDb === "llamacloud") {
-    await copy("generate.ts", path.join(root, "src"), {
-      parents: true,
-      cwd: path.join(
-        templatesDir,
-        "components",
-        "vectordbs",
-        "llamaindexserver",
-        "llamacloud",
-        "typescript",
-      ),
-    });
-
-    await copy("index.ts", path.join(root, "src", "app"), {
-      parents: true,
-      cwd: path.join(
-        templatesDir,
-        "components",
-        "vectordbs",
-        "llamaindexserver",
-        "llamacloud",
-        "typescript",
-      ),
-      rename: () => "data.ts",
-    });
-  }
-  // Copy README.md
-  await copy("README-template.md", path.join(root), {
-    parents: true,
-    cwd: path.join(
-      templatesDir,
-      "components",
-      "workflows",
-      "typescript",
-      useCase,
-    ),
-    rename: assetRelocator,
-  });
-};
-
-const installLegacyTSTemplate = async ({
+/**
+ * Install a LlamaIndex internal template to a given `root` directory.
+ */
+export const installTSTemplate = async ({
+  appName,
   root,
+  packageManager,
+  isOnline,
   template,
-  backend,
   framework,
   ui,
   vectorDb,
+  postInstallAction,
+  backend,
   observability,
   tools,
   dataSources,
   useLlamaParse,
-  useCase,
-  modelConfig,
-  relativeEngineDestPath,
-}: InstallTemplateArgs & {
-  backend: boolean;
-  relativeEngineDestPath: string;
-}) => {
+}: InstallTemplateArgs & { backend: boolean }) => {
+  console.log(bold(`Using ${packageManager}.`));
+
+  /**
+   * Copy the template files to the target directory.
+   */
+  console.log("\nInitializing project with template:", template, "\n");
+  const templatePath = path.join(templatesDir, "types", "streaming", framework);
+  const copySource = ["**"];
+
+  await copy(copySource, root, {
+    parents: true,
+    cwd: templatePath,
+    rename: assetRelocator,
+  });
+
   /**
    * If next.js is used, update its configuration if necessary
    */
@@ -121,9 +57,11 @@ const installLegacyTSTemplate = async ({
       console.log("\nUsing static site generation\n");
     } else {
       if (vectorDb === "milvus") {
-        nextConfigJson.serverExternalPackages =
-          nextConfigJson.serverExternalPackages ?? [];
-        nextConfigJson.serverExternalPackages.push("@zilliz/milvus2-sdk-node");
+        nextConfigJson.experimental.serverComponentsExternalPackages =
+          nextConfigJson.experimental.serverComponentsExternalPackages ?? [];
+        nextConfigJson.experimental.serverComponentsExternalPackages.push(
+          "@zilliz/milvus2-sdk-node",
+        );
       }
     }
     await fs.writeFile(
@@ -160,6 +98,10 @@ const installLegacyTSTemplate = async ({
   }
 
   const compPath = path.join(templatesDir, "components");
+  const relativeEngineDestPath =
+    framework === "nextjs"
+      ? path.join("app", "api", "chat")
+      : path.join("src", "controllers");
   const enginePath = path.join(root, relativeEngineDestPath, "engine");
 
   // copy llamaindex code for TS templates
@@ -190,34 +132,6 @@ const installLegacyTSTemplate = async ({
       cwd: path.join(multiagentPath, "workflow"),
     });
 
-    // Copy use case code for multiagent template
-    if (useCase) {
-      console.log("\nCopying use case:", useCase, "\n");
-      const useCasePath = path.join(compPath, "agents", "typescript", useCase);
-      const useCaseCodePath = path.join(useCasePath, "workflow");
-
-      // Copy use case codes
-      await copy("**", path.join(root, relativeEngineDestPath, "workflow"), {
-        parents: true,
-        cwd: useCaseCodePath,
-        rename: assetRelocator,
-      });
-
-      // Copy use case files to project root
-      await copy("*.*", path.join(root), {
-        parents: true,
-        cwd: useCasePath,
-        rename: assetRelocator,
-      });
-    } else {
-      console.log(
-        red(
-          `There is no use case selected for ${template} template. Please pick a use case to use via --use-case flag.`,
-        ),
-      );
-      process.exit(1);
-    }
-
     if (framework === "nextjs") {
       // patch route.ts file
       await copy("**", path.join(root, relativeEngineDestPath), {
@@ -240,12 +154,6 @@ const installLegacyTSTemplate = async ({
     cwd: path.join(compPath, "loaders", "typescript", loaderFolder),
   });
 
-  // copy provider settings
-  await copy("**", enginePath, {
-    parents: true,
-    cwd: path.join(compPath, "providers", "typescript", modelConfig.provider),
-  });
-
   // Select and copy engine code based on data sources and tools
   let engine;
   tools = tools ?? [];
@@ -294,75 +202,6 @@ const installLegacyTSTemplate = async ({
     await fs.rm(path.join(root, "app", "api"), { recursive: true });
     await fs.rm(path.join(root, "config"), { recursive: true, force: true });
   }
-};
-
-/**
- * Install a LlamaIndex internal template to a given `root` directory.
- */
-export const installTSTemplate = async ({
-  appName,
-  root,
-  packageManager,
-  isOnline,
-  template,
-  framework,
-  ui,
-  vectorDb,
-  postInstallAction,
-  backend,
-  observability,
-  tools,
-  dataSources,
-  useLlamaParse,
-  useCase,
-  modelConfig,
-}: InstallTemplateArgs & { backend: boolean }) => {
-  console.log(bold(`Using ${packageManager}.`));
-
-  /**
-   * Copy the template files to the target directory.
-   */
-  console.log("\nInitializing project with template:", template, "\n");
-  const templatePath = path.join(templatesDir, "types", template, framework);
-  const copySource = ["**"];
-
-  await copy(copySource, root, {
-    parents: true,
-    cwd: templatePath,
-    rename: assetRelocator,
-  });
-
-  const relativeEngineDestPath =
-    framework === "nextjs"
-      ? path.join("app", "api", "chat")
-      : path.join("src", "controllers");
-
-  if (template === "llamaindexserver") {
-    await installLlamaIndexServerTemplate({
-      root,
-      useCase,
-      vectorDb,
-    });
-  } else {
-    await installLegacyTSTemplate({
-      appName,
-      root,
-      packageManager,
-      isOnline,
-      template,
-      backend,
-      framework,
-      ui,
-      vectorDb,
-      observability,
-      tools,
-      dataSources,
-      useLlamaParse,
-      useCase,
-      modelConfig,
-      relativeEngineDestPath,
-    });
-  }
 
   const packageJson = await updatePackageJson({
     root,
@@ -373,79 +212,16 @@ export const installTSTemplate = async ({
     ui,
     observability,
     vectorDb,
-    backend,
-    modelConfig,
-    template,
   });
 
-  if (
-    backend &&
-    (postInstallAction === "runApp" || postInstallAction === "dependencies")
-  ) {
+  if (postInstallAction === "runApp" || postInstallAction === "dependencies") {
     await installTSDependencies(packageJson, packageManager, isOnline);
   }
-};
 
-const providerDependencies: {
-  [key in ModelProvider]?: Record<string, string>;
-} = {
-  openai: {
-    "@llamaindex/openai": "^0.2.0",
-  },
-  gemini: {
-    "@llamaindex/google": "^0.2.0",
-  },
-  ollama: {
-    "@llamaindex/ollama": "^0.1.0",
-  },
-  mistral: {
-    "@llamaindex/mistral": "^0.2.0",
-  },
-  "azure-openai": {
-    "@llamaindex/openai": "^0.2.0",
-  },
-  groq: {
-    "@llamaindex/groq": "^0.0.61",
-    "@llamaindex/huggingface": "^0.1.0", // groq uses huggingface as default embedding model
-  },
-  anthropic: {
-    "@llamaindex/anthropic": "^0.3.0",
-    "@llamaindex/huggingface": "^0.1.0", // anthropic uses huggingface as default embedding model
-  },
-};
-
-const vectorDbDependencies: Record<TemplateVectorDB, Record<string, string>> = {
-  astra: {
-    "@llamaindex/astra": "^0.0.5",
-  },
-  chroma: {
-    "@llamaindex/chroma": "^0.0.5",
-  },
-  llamacloud: {},
-  milvus: {
-    "@zilliz/milvus2-sdk-node": "^2.4.6",
-    "@llamaindex/milvus": "^0.1.0",
-  },
-  mongo: {
-    mongodb: "6.7.0",
-    "@llamaindex/mongodb": "^0.0.5",
-  },
-  none: {},
-  pg: {
-    pg: "^8.12.0",
-    pgvector: "^0.2.0",
-    "@llamaindex/postgres": "^0.0.33",
-  },
-  pinecone: {
-    "@llamaindex/pinecone": "^0.0.5",
-  },
-  qdrant: {
-    "@qdrant/js-client-rest": "^1.11.0",
-    "@llamaindex/qdrant": "^0.1.0",
-  },
-  weaviate: {
-    "@llamaindex/weaviate": "^0.0.5",
-  },
+  // Copy deployment files for typescript
+  await copy("**", root, {
+    cwd: path.join(compPath, "deployments", "typescript"),
+  });
 };
 
 async function updatePackageJson({
@@ -457,9 +233,6 @@ async function updatePackageJson({
   ui,
   observability,
   vectorDb,
-  backend,
-  modelConfig,
-  template,
 }: Pick<
   InstallTemplateArgs,
   | "root"
@@ -469,11 +242,8 @@ async function updatePackageJson({
   | "ui"
   | "observability"
   | "vectorDb"
-  | "modelConfig"
-  | "template"
 > & {
   relativeEngineDestPath: string;
-  backend: boolean;
 }): Promise<any> {
   const packageJsonFile = path.join(root, "package.json");
   const packageJson: any = JSON.parse(
@@ -482,7 +252,7 @@ async function updatePackageJson({
   packageJson.name = appName;
   packageJson.version = "0.1.0";
 
-  if (relativeEngineDestPath && template !== "llamaindexserver") {
+  if (relativeEngineDestPath) {
     // TODO: move script to {root}/scripts for all frameworks
     // add generate script if using context engine
     packageJson.scripts = {
@@ -509,29 +279,41 @@ async function updatePackageJson({
       "remark-gfm": undefined,
       "remark-math": undefined,
       "react-markdown": undefined,
-      "highlight.js": undefined,
+      "react-syntax-highlighter": undefined,
+    };
+
+    packageJson.devDependencies = {
+      ...packageJson.devDependencies,
+      "@types/react-syntax-highlighter": undefined,
     };
   }
 
-  if (backend) {
+  if (vectorDb === "pg") {
     packageJson.dependencies = {
       ...packageJson.dependencies,
-      "@llamaindex/readers": "^2.0.0",
+      pg: "^8.12.0",
+      pgvector: "^0.2.0",
     };
+  }
 
-    if (vectorDb && vectorDb in vectorDbDependencies) {
-      packageJson.dependencies = {
-        ...packageJson.dependencies,
-        ...vectorDbDependencies[vectorDb],
-      };
-    }
+  if (vectorDb === "qdrant") {
+    packageJson.dependencies = {
+      ...packageJson.dependencies,
+      "@qdrant/js-client-rest": "^1.11.0",
+    };
+  }
+  if (vectorDb === "mongo") {
+    packageJson.dependencies = {
+      ...packageJson.dependencies,
+      mongodb: "^6.7.0",
+    };
+  }
 
-    if (modelConfig.provider && modelConfig.provider in providerDependencies) {
-      packageJson.dependencies = {
-        ...packageJson.dependencies,
-        ...providerDependencies[modelConfig.provider],
-      };
-    }
+  if (vectorDb === "milvus") {
+    packageJson.dependencies = {
+      ...packageJson.dependencies,
+      "@zilliz/milvus2-sdk-node": "^2.4.6",
+    };
   }
 
   if (observability === "traceloop") {

index.ts

@@ -134,6 +134,13 @@ const program = new Command(packageJson.name)
     `
 
   Select UI port.
+`,
+  )
+  .option(
+    "--external-port <external>",
+    `
+
+  Select external port.
 `,
   )
   .option(
@@ -201,13 +208,6 @@ const program = new Command(packageJson.name)
 `,
     false,
   )
-  .option(
-    "--use-case <useCase>",
-    `
-
-  Select which use case to use for the multi-agent template (e.g: financial_report, blog).
-`,
-  )
   .allowUnknownOption()
   .parse(process.argv);
 
@@ -215,7 +215,7 @@ const options = program.opts();
 
 if (
   process.argv.includes("--no-llama-parse") ||
-  options.template === "reflex"
+  options.template === "extractor"
 ) {
   options.useLlamaParse = false;
 }
@@ -326,6 +326,7 @@ async function run(): Promise<void> {
     ...answers,
     appPath: resolvedProjectPath,
     packageManager,
+    externalPort: options.externalPort,
   });
 
   if (answers.postInstallAction === "VSCode") {
@@ -354,7 +355,14 @@ Please check ${cyan(
     }
   } else if (answers.postInstallAction === "runApp") {
     console.log(`Running app in ${root}...`);
-    await runApp(root, answers.template, answers.framework, options.port);
+    await runApp(
+      root,
+      answers.template,
+      answers.frontend,
+      answers.framework,
+      options.port,
+      options.externalPort,
+    );
   }
 }
 

llama-index-server/README.md

@@ -1,141 +0,0 @@
-# LlamaIndex Server
-
-LlamaIndexServer is a FastAPI-based application that allows you to quickly launch your [LlamaIndex Workflows](https://docs.llamaindex.ai/en/stable/module_guides/workflow/#workflows) and [Agent Workflows](https://docs.llamaindex.ai/en/stable/understanding/agent/multi_agent/) as an API server with an optional chat UI. It provides a complete environment for running LlamaIndex workflows with both API endpoints and a user interface for interaction.
-
-## Features
-
-- Serving a workflow as a chatbot
-- Built on FastAPI for high performance and easy API development
-- Optional built-in chat UI with extendable UI components
-- Prebuilt development code
-
-## Installation
-
-```bash
-pip install llama-index-server
-```
-
-## Quick Start
-
-```python
-# main.py
-from llama_index.core.agent.workflow import AgentWorkflow
-from llama_index.core.workflow import Workflow
-from llama_index.core.tools import FunctionTool
-from llama_index.server import LlamaIndexServer
-
-
-# Define a factory function that returns a Workflow or AgentWorkflow
-def create_workflow() -> Workflow:
-    def fetch_weather(city: str) -> str:
-        return f"The weather in {city} is sunny"
-
-    return AgentWorkflow.from_tools(
-        tools=[
-            FunctionTool.from_defaults(
-                fn=fetch_weather,
-            )
-        ]
-    )
-
-
-# Create an API server for the workflow
-app = LlamaIndexServer(
-    workflow_factory=create_workflow,  # Supports Workflow or AgentWorkflow
-    env="dev",  # Enable development mode
-    ui_config={ # Configure the chat UI, optional
-        "app_title": "Weather Bot",
-        "starter_questions": ["What is the weather in LA?", "Will it rain in SF?"],
-    },
-    verbose=True
-)
-```
-
-## Running the Server
-
-- In the same directory as `main.py`, run the following command to start the server:
-
-  ```bash
-  fastapi dev
-  ```
-
-- Making a request to the server:
-
-  ```bash
-  curl -X POST "http://localhost:8000/api/chat" -H "Content-Type: application/json" -d '{"message": "What is the weather in Tokyo?"}'
-  ```
-
-- See the API documentation at `http://localhost:8000/docs`
-- Access the chat UI at `http://localhost:8000/` (Make sure you set the `env="dev"` or `include_ui=True` in the server configuration)
-
-## Configuration Options
-
-The LlamaIndexServer accepts the following configuration parameters:
-
-- `workflow_factory`: A callable that creates a workflow instance for each request
-- `logger`: Optional logger instance (defaults to uvicorn logger)
-- `use_default_routers`: Whether to include default routers (chat, static file serving)
-- `env`: Environment setting ('dev' enables CORS and UI by default)
-- `ui_config`: UI configuration as a dictionary or UIConfig object with options:
-  - `enabled`: Whether to enable the chat UI (default: True)
-  - `app_title`: The title of the chat application (default: "LlamaIndex Server")
-  - `starter_questions`: List of starter questions for the chat UI (default: None)
-  - `ui_path`: Path for downloaded UI static files (default: ".ui")
-  - `component_dir`: The directory for custom UI components rendering events emitted by the workflow. The default is None, which does not render custom UI components.
-  - `llamacloud_index_selector`: Whether to show the LlamaCloud index selector in the chat UI (default: False). Requires `LLAMA_CLOUD_API_KEY` to be set.
-- `verbose`: Enable verbose logging
-- `api_prefix`: API route prefix (default: "/api")
-- `server_url`: The deployment URL of the server (default is None)
-
-## Default Routers and Features
-
-### Chat Router
-
-The server includes a default chat router at `/api/chat` for handling chat interactions.
-
-### Static File Serving
-
-- The server automatically mounts the `data` and `output` folders at `{server_url}{api_prefix}/files/data` (default: `/api/files/data`) and `{server_url}{api_prefix}/files/output` (default: `/api/files/output`) respectively.
-- Your workflows can use both folders to store and access files. As a convention, the `data` folder is used for documents that are ingested and the `output` folder is used for documents that are generated by the workflow.
-- The example workflows from `create-llama` (see below) are following this pattern.
-
-### Chat UI
-
-When enabled, the server provides a chat interface at the root path (`/`) with:
-
-- Configurable starter questions
-- Real-time chat interface
-- API endpoint integration
-
-### Custom UI Components
-
-You can add custom UI components for your workflow by providing `component_dir` config and adding custom .jsx or .tsx files to the directory.
-See [Custom UI Components](https://github.com/run-llama/create-llama/blob/main/llama-index-server/docs/custom_ui_component.md) for more details.
-
-## Development Mode
-
-In development mode (`env="dev"`), the server:
-
-- Enables CORS for all origins
-- Automatically includes the chat UI
-- Provides more verbose logging
-
-## API Endpoints
-
-The server provides the following default endpoints:
-
-- `/api/chat`: Chat interaction endpoint
-- `/api/files/data/*`: Access to data directory files
-- `/api/files/output/*`: Access to output directory files
-
-## Best Practices
-
-1. Always provide a workflow factory that creates fresh workflow instances
-2. Use environment variables for sensitive configuration
-3. Enable verbose logging during development
-4. Configure CORS appropriately for your deployment environment
-5. Use starter questions to guide users in the chat UI
-
-## Getting Started with a New Project
-
-Want to start a new project with LlamaIndexServer? Check out our [create-llama](https://github.com/run-llama/create-llama) tool to quickly generate a new project with LlamaIndexServer.

llama-index-server/docs/custom_ui_component.md

@@ -1,103 +0,0 @@
-# Custom UI Components
-
-The LlamaIndex server provides support for rendering workflow events using custom UI components, allowing you to extend and customize the chat interface.
-
-## Overview
-
-Custom UI components are a powerful feature that enables you to:
-
-- Add custom interface elements to the chat UI using React JSX or TSX files
-- Extend the default chat interface functionality
-- Create specialized visualizations or interactions
-
-## Configuration
-
-### Workflow events
-
-To display custom UI components, your workflow needs to emit `UIEvent` events with data that conforms to the data model of your custom UI component.
-
-```python
-from llama_index.server import UIEvent
-from pydantic import BaseModel, Field
-from typing import Literal, Any
-
-# Define a Pydantic model for your event data
-class DeepResearchEventData(BaseModel):
-    id: str = Field(description="The unique identifier for the event")
-    type: Literal["retrieval", "analysis"] = Field(description="DeepResearch has two main stages: retrieval and analysis")
-    status: Literal["pending", "completed", "failed"] = Field(description="The current status of the event")
-    content: str = Field(description="The textual content of the event")
-
-
-# In your workflow, emit the data model with UIEvent
-ctx.write_event_to_stream(
-    UIEvent(
-        type="deep_research_event",
-        data=DeepResearchEventData(
-            id="123",
-            type="retrieval",
-            status="pending",
-            content="Retrieving data...",
-        ),
-    )
-)
-```
-
-### Server Setup
-
-1. Initialize the LlamaIndex server with a component directory:
-
-```python
-server = LlamaIndexServer(
-    workflow_factory=your_workflow,
-    ui_config={
-        "component_dir": "path/to/components",
-    },
-    include_ui=True
-)
-```
-
-2. Add the custom component code to the directory following the naming pattern:
-
-   - File Extension: `.jsx` and `.tsx` for React components
-   - File Name: Should match the event type from your workflow (e.g., `deep_research_event.jsx` for handling `deep_research_event` type that you defined in your workflow). If there are TSX and JSX files with the same name, the TSX file will be used.
-   - Component Name: Export a default React component named `Component` that receives props from the event data
-
-   Example component structure:
-
-   ```jsx
-   function Component({ events }) {
-       // Your component logic here
-       return (
-           // Your UI code here
-       );
-   }
-   ```
-
-### Generate UI Component
-
-We provide a `generate_event_component` function that uses LLMs to automatically generate UI components for your workflow events.
-
-```python
-from llama_index.server.gen_ui import generate_event_component
-from llama_index.llms.openai import OpenAI
-
-# Generate a component using the event class you defined in your workflow
-from your_workflow import DeepResearchEvent
-ui_code = await generate_event_component(
-    event_cls=DeepResearchEvent,
-    llm=OpenAI(model="gpt-4.1"), # Default LLM is Claude 3.7 Sonnet if not provided
-)
-
-# Alternatively, generate from your workflow file
-ui_code = await generate_event_component(
-    workflow_file="your_workflow.py",
-)
-print(ui_code)
-
-# Save the generated code to a file for use in your project
-with open("deep_research_event.jsx", "w") as f:
-    f.write(ui_code)
-```
-
-> **Tip:** For optimal results, add descriptive documentation to each field in your event data class. This helps the LLM better understand your data structure and generate more appropriate UI components. We also recommend using GPT 4.1, Claude 3.7 Sonnet and Gemini 2.5 Pro for better results.

llama-index-server/llama_index/server/__init__.py

@@ -1,4 +0,0 @@
-from .api.models import UIEvent
-from .server import LlamaIndexServer, UIConfig
-
-__all__ = ["LlamaIndexServer", "UIConfig", "UIEvent"]

llama-index-server/llama_index/server/api/callbacks/__init__.py

@@ -1,13 +0,0 @@
-from llama_index.server.api.callbacks.base import EventCallback
-from llama_index.server.api.callbacks.llamacloud import LlamaCloudFileDownload
-from llama_index.server.api.callbacks.source_nodes import SourceNodesFromToolCall
-from llama_index.server.api.callbacks.suggest_next_questions import (
-    SuggestNextQuestions,
-)
-
-__all__ = [
-    "EventCallback",
-    "SourceNodesFromToolCall",
-    "SuggestNextQuestions",
-    "LlamaCloudFileDownload",
-]

llama-index-server/llama_index/server/api/callbacks/base.py

@@ -1,31 +0,0 @@
-import logging
-from abc import ABC, abstractmethod
-from typing import Any
-
-logger = logging.getLogger("uvicorn")
-
-
-class EventCallback(ABC):
-    """
-    Base class for event callbacks during event streaming.
-    """
-
-    async def run(self, event: Any) -> Any:
-        """
-        Called for each event in the stream.
-        Default behavior: pass through the event unchanged.
-        """
-        return event
-
-    async def on_complete(self, final_response: str) -> Any:
-        """
-        Called when the stream is complete.
-        Default behavior: return None.
-        """
-        return None
-
-    @abstractmethod
-    def from_default(self, *args: Any, **kwargs: Any) -> "EventCallback":
-        """
-        Create a new instance of the processor from default values.
-        """

llama-index-server/llama_index/server/api/callbacks/llamacloud.py

@@ -1,39 +0,0 @@
-import logging
-from typing import Any, List
-
-from fastapi import BackgroundTasks
-from llama_index.core.schema import NodeWithScore
-from llama_index.server.api.callbacks.base import EventCallback
-from llama_index.server.services.llamacloud.file import LlamaCloudFileService
-
-logger = logging.getLogger("uvicorn")
-
-
-class LlamaCloudFileDownload(EventCallback):
-    """
-    Processor for handling LlamaCloud file downloads from source nodes.
-    """
-
-    def __init__(self, background_tasks: BackgroundTasks) -> None:
-        self.background_tasks = background_tasks
-
-    async def run(self, event: Any) -> Any:
-        if hasattr(event, "to_response"):
-            event_response = event.to_response()
-            if event_response.get("type") == "sources" and hasattr(event, "nodes"):
-                await self._process_response_nodes(event.nodes)
-        return event
-
-    async def _process_response_nodes(self, source_nodes: List[NodeWithScore]) -> None:
-        try:
-            LlamaCloudFileService.download_files_from_nodes(
-                source_nodes, self.background_tasks
-            )
-        except ImportError:
-            pass
-
-    @classmethod
-    def from_default(
-        cls, background_tasks: BackgroundTasks
-    ) -> "LlamaCloudFileDownload":
-        return cls(background_tasks=background_tasks)

llama-index-server/llama_index/server/api/callbacks/source_nodes.py

@@ -1,32 +0,0 @@
-from typing import Any
-
-from llama_index.core.agent.workflow.workflow_events import ToolCallResult
-from llama_index.server.api.callbacks.base import EventCallback
-from llama_index.server.api.models import SourceNodesEvent
-
-
-class SourceNodesFromToolCall(EventCallback):
-    """
-    Extract source nodes from the query tool output.
-
-    Args:
-        query_tool_name: The name of the tool that queries the index.
-                         default is "query_index"
-    """
-
-    def __init__(self, query_tool_name: str = "query_index"):
-        self.query_tool_name = query_tool_name
-
-    def transform_tool_call_result(self, event: ToolCallResult) -> SourceNodesEvent:
-        source_nodes = event.tool_output.raw_output.source_nodes
-        return SourceNodesEvent(nodes=source_nodes)
-
-    async def run(self, event: Any) -> Any:
-        if isinstance(event, ToolCallResult):
-            if event.tool_name == self.query_tool_name:
-                return event, self.transform_tool_call_result(event)
-        return event
-
-    @classmethod
-    def from_default(cls, *args: Any, **kwargs: Any) -> "SourceNodesFromToolCall":
-        return cls()

llama-index-server/llama_index/server/api/callbacks/stream_handler.py

@@ -1,69 +0,0 @@
-import logging
-from typing import Any, AsyncGenerator, List, Optional
-
-from llama_index.core.workflow.handler import WorkflowHandler
-from llama_index.server.api.callbacks.base import EventCallback
-
-logger = logging.getLogger("uvicorn")
-
-
-class StreamHandler:
-    """
-    Streams events from a workflow handler through a chain of callbacks.
-    """
-
-    def __init__(
-        self,
-        workflow_handler: WorkflowHandler,
-        callbacks: Optional[List[EventCallback]] = None,
-    ):
-        self.workflow_handler = workflow_handler
-        self.callbacks = callbacks or []
-        self.accumulated_text = ""
-
-    async def cancel_run(self) -> None:
-        """Cancel the workflow handler."""
-        await self.workflow_handler.cancel_run()
-
-    async def stream_events(self) -> AsyncGenerator[Any, None]:
-        """Stream events through the processor chain."""
-        try:
-            async for event in self.workflow_handler.stream_events():
-                events_to_process = [event]
-                for callback in self.callbacks:
-                    next_events: list[Any] = []
-                    for evt in events_to_process:
-                        callback_output = await callback.run(evt)
-                        if isinstance(callback_output, (list, tuple)):
-                            next_events.extend(callback_output)
-                        elif callback_output is not None:
-                            next_events.append(callback_output)
-                    events_to_process = next_events
-
-                # Yield all processed events
-                for evt in events_to_process:
-                    yield evt
-
-            # After all events are processed, call on_complete for each callback
-            for callback in self.callbacks:
-                result = await callback.on_complete(self.accumulated_text)
-                if result:
-                    yield result
-
-        except Exception:
-            # Make sure to cancel the workflow on error
-            await self.workflow_handler.cancel_run()
-            raise
-
-    def accumulate_text(self, text: str) -> None:
-        """Accumulate text from the workflow handler."""
-        self.accumulated_text += text
-
-    @classmethod
-    def from_default(
-        cls,
-        handler: WorkflowHandler,
-        callbacks: Optional[List[EventCallback]] = None,
-    ) -> "StreamHandler":
-        """Create a new instance with the given workflow handler and callbacks."""
-        return cls(workflow_handler=handler, callbacks=callbacks)

llama-index-server/llama_index/server/api/callbacks/suggest_next_questions.py

@@ -1,45 +0,0 @@
-import logging
-from typing import Any, Optional
-
-from llama_index.server.api.callbacks.base import EventCallback
-from llama_index.server.api.models import ChatRequest
-from llama_index.server.services.suggest_next_question import (
-    SuggestNextQuestionsService,
-)
-
-logger = logging.getLogger("uvicorn")
-
-
-class SuggestNextQuestions(EventCallback):
-    """Processor for generating next question suggestions."""
-
-    def __init__(
-        self, chat_request: ChatRequest, logger: Optional[logging.Logger] = None
-    ):
-        self.chat_request = chat_request
-        self.accumulated_text = ""
-        if logger:
-            self.logger = logger
-        else:
-            self.logger = logging.getLogger("uvicorn")
-
-    async def on_complete(self, final_response: str) -> Any:
-        if final_response == "":
-            self.logger.warning(
-                "SuggestNextQuestions is enabled but final response is empty, make sure your content generator accumulates text"
-            )
-            return None
-
-        questions = await SuggestNextQuestionsService.run(
-            self.chat_request.messages, final_response
-        )
-        if questions:
-            return {
-                "type": "suggested_questions",
-                "data": questions,
-            }
-        return None
-
-    @classmethod
-    def from_default(cls, chat_request: ChatRequest) -> "SuggestNextQuestions":
-        return cls(chat_request=chat_request)

llama-index-server/llama_index/server/api/models.py

@@ -1,153 +0,0 @@
-import logging
-import os
-from enum import Enum
-from typing import Any, Dict, List, Optional
-
-from llama_index.core.schema import NodeWithScore
-from llama_index.core.types import ChatMessage, MessageRole
-from llama_index.core.workflow import Event
-from llama_index.server.settings import server_settings
-from pydantic import BaseModel, Field, field_validator
-
-logger = logging.getLogger("uvicorn")
-
-
-class ChatConfig(BaseModel):
-    next_question_suggestions: bool = Field(
-        default=True,
-        description="Whether to suggest next questions",
-    )
-
-
-class ChatAPIMessage(BaseModel):
-    role: MessageRole
-    content: str
-
-    def to_llamaindex_message(self) -> ChatMessage:
-        return ChatMessage(role=self.role, content=self.content)
-
-
-class ChatRequest(BaseModel):
-    messages: List[ChatAPIMessage]
-    data: Optional[Any] = None
-    config: Optional[ChatConfig] = ChatConfig()
-
-    @field_validator("messages")
-    def validate_messages(cls, v: List[ChatAPIMessage]) -> List[ChatAPIMessage]:
-        if v[-1].role != MessageRole.USER:
-            raise ValueError("Last message must be from user")
-        return v
-
-
-class AgentRunEventType(Enum):
-    TEXT = "text"
-    PROGRESS = "progress"
-
-
-class AgentRunEvent(Event):
-    name: str
-    msg: str
-    event_type: AgentRunEventType = AgentRunEventType.TEXT
-    data: Optional[dict] = None
-
-    def to_response(self) -> dict:
-        return {
-            "type": "agent",
-            "data": {
-                "agent": self.name,
-                "type": self.event_type.value,
-                "text": self.msg,
-                "data": self.data,
-            },
-        }
-
-
-class SourceNodesEvent(Event):
-    nodes: List[NodeWithScore]
-
-    def to_response(self) -> dict:
-        return {
-            "type": "sources",
-            "data": {
-                "nodes": [
-                    SourceNodes.from_source_node(node).model_dump()
-                    for node in self.nodes
-                ]
-            },
-        }
-
-
-class SourceNodes(BaseModel):
-    id: str
-    metadata: Dict[str, Any]
-    score: Optional[float]
-    text: str
-    url: Optional[str]
-
-    @classmethod
-    def from_source_node(cls, source_node: NodeWithScore) -> "SourceNodes":
-        metadata = source_node.node.metadata
-        url = cls.get_url_from_metadata(metadata)
-
-        return cls(
-            id=source_node.node.node_id,
-            metadata=metadata,
-            score=source_node.score,
-            text=source_node.node.text,  # type: ignore
-            url=url,
-        )
-
-    @classmethod
-    def get_url_from_metadata(
-        cls,
-        metadata: Dict[str, Any],
-        data_dir: Optional[str] = None,
-    ) -> Optional[str]:
-        url_prefix = server_settings.file_server_url_prefix
-        if data_dir is None:
-            data_dir = "data"
-        file_name = metadata.get("file_name")
-
-        if file_name and url_prefix:
-            # file_name exists and file server is configured
-            pipeline_id = metadata.get("pipeline_id")
-            if pipeline_id:
-                # file is from LlamaCloud
-                file_name = f"{pipeline_id}${file_name}"
-                return f"{url_prefix}/output/llamacloud/{file_name}"
-            is_private = metadata.get("private", "false") == "true"
-            if is_private:
-                # file is a private upload
-                return f"{url_prefix}/output/uploaded/{file_name}"
-            # file is from calling the 'generate' script
-            # Get the relative path of file_path to data_dir
-            file_path = metadata.get("file_path")
-            data_dir = os.path.abspath(data_dir)
-            if file_path and data_dir:
-                relative_path = os.path.relpath(file_path, data_dir)
-                return f"{url_prefix}/data/{relative_path}"
-        # fallback to URL in metadata (e.g. for websites)
-        return metadata.get("URL")
-
-    @classmethod
-    def from_source_nodes(
-        cls, source_nodes: List[NodeWithScore]
-    ) -> List["SourceNodes"]:
-        return [cls.from_source_node(node) for node in source_nodes]
-
-
-class ComponentDefinition(BaseModel):
-    type: str
-    code: str
-    filename: str
-
-
-class UIEvent(Event):
-    type: str
-    data: BaseModel
-
-    def to_response(self) -> dict:
-        return {
-            "type": self.type,
-            "data": self.data.model_dump(),
-        }

llama-index-server/llama_index/server/api/routers/__init__.py

@@ -1,4 +0,0 @@
-from llama_index.server.api.routers.chat import chat_router
-from llama_index.server.api.routers.ui import custom_components_router
-
-__all__ = ["chat_router", "custom_components_router"]

llama-index-server/llama_index/server/api/routers/chat.py

@@ -1,144 +0,0 @@
-import asyncio
-import inspect
-import logging
-import os
-from typing import AsyncGenerator, Callable, Union
-
-from fastapi import APIRouter, BackgroundTasks, HTTPException
-from fastapi.responses import StreamingResponse
-
-from llama_index.core.agent.workflow.workflow_events import AgentStream
-from llama_index.core.workflow import StopEvent, Workflow
-from llama_index.server.api.callbacks import (
-    SourceNodesFromToolCall,
-    SuggestNextQuestions,
-)
-from llama_index.server.api.callbacks.base import EventCallback
-from llama_index.server.api.callbacks.llamacloud import LlamaCloudFileDownload
-from llama_index.server.api.callbacks.stream_handler import StreamHandler
-from llama_index.server.api.models import ChatRequest
-from llama_index.server.api.utils.vercel_stream import VercelStreamResponse
-from llama_index.server.services.llamacloud import LlamaCloudFileService
-
-
-def chat_router(
-    workflow_factory: Callable[..., Workflow],
-    logger: logging.Logger,
-) -> APIRouter:
-    router = APIRouter(prefix="/chat")
-
-    @router.post("")
-    async def chat(
-        request: ChatRequest,
-        background_tasks: BackgroundTasks,
-    ) -> StreamingResponse:
-        try:
-            user_message = request.messages[-1].to_llamaindex_message()
-            chat_history = [
-                message.to_llamaindex_message() for message in request.messages[:-1]
-            ]
-            # detect if the workflow factory has chat_request as a parameter
-            factory_sig = inspect.signature(workflow_factory)
-            if "chat_request" in factory_sig.parameters:
-                workflow = workflow_factory(chat_request=request)
-            else:
-                workflow = workflow_factory()
-            workflow_handler = workflow.run(
-                user_msg=user_message.content,
-                chat_history=chat_history,
-            )
-
-            callbacks: list[EventCallback] = [
-                SourceNodesFromToolCall(),
-                LlamaCloudFileDownload(background_tasks),
-            ]
-            if request.config and request.config.next_question_suggestions:
-                callbacks.append(SuggestNextQuestions(request))
-            stream_handler = StreamHandler(
-                workflow_handler=workflow_handler,
-                callbacks=callbacks,
-            )
-
-            return VercelStreamResponse(
-                content_generator=_stream_content(stream_handler, request, logger),
-            )
-        except Exception as e:
-            logger.error(e)
-            raise HTTPException(status_code=500, detail=str(e))
-
-    if LlamaCloudFileService.is_configured():
-
-        @router.get("/config/llamacloud")
-        async def chat_llama_cloud_config() -> dict:
-            if not os.getenv("LLAMA_CLOUD_API_KEY"):
-                raise HTTPException(
-                    status_code=500, detail="LlamaCloud API KEY is not configured"
-                )
-            projects = LlamaCloudFileService.get_all_projects_with_pipelines()
-            pipeline = os.getenv("LLAMA_CLOUD_INDEX_NAME")
-            project = os.getenv("LLAMA_CLOUD_PROJECT_NAME")
-            pipeline_config = None
-            if pipeline and project:
-                pipeline_config = {
-                    "pipeline": pipeline,
-                    "project": project,
-                }
-            return {
-                "projects": projects,
-                "pipeline": pipeline_config,
-            }
-
-    return router
-
-
-async def _stream_content(
-    handler: StreamHandler,
-    request: ChatRequest,
-    logger: logging.Logger,
-) -> AsyncGenerator[str, None]:
-    async def _text_stream(
-        event: Union[AgentStream, StopEvent],
-    ) -> AsyncGenerator[str, None]:
-        if isinstance(event, AgentStream):
-            # Normally, if the stream is a tool call, the delta is always empty
-            # so it's not a text stream.
-            if len(event.tool_calls) == 0:
-                yield event.delta
-        elif isinstance(event, StopEvent):
-            if isinstance(event.result, str):
-                yield event.result
-            elif isinstance(event.result, AsyncGenerator):
-                async for chunk in event.result:
-                    if isinstance(chunk, str):
-                        yield chunk
-                    elif hasattr(chunk, "delta") and chunk.delta:
-                        yield chunk.delta
-
-    stream_started = False
-    try:
-        async for event in handler.stream_events():
-            if not stream_started:
-                # Start the stream with an empty message
-                stream_started = True
-                yield VercelStreamResponse.convert_text("")
-
-            # Handle different types of events
-            if isinstance(event, (AgentStream, StopEvent)):
-                async for chunk in _text_stream(event):
-                    handler.accumulate_text(chunk)
-                    yield VercelStreamResponse.convert_text(chunk)
-            elif isinstance(event, dict):
-                yield VercelStreamResponse.convert_data(event)
-            elif hasattr(event, "to_response"):
-                event_response = event.to_response()
-                yield VercelStreamResponse.convert_data(event_response)
-            else:
-                yield VercelStreamResponse.convert_data(event.model_dump())
-
-    except asyncio.CancelledError:
-        logger.warning("Client cancelled the request!")
-        await handler.cancel_run()
-    except Exception as e:
-        logger.error(f"Error in stream response: {e}")
-        yield VercelStreamResponse.convert_error(str(e))
-        await handler.cancel_run()

llama-index-server/llama_index/server/api/routers/ui.py

@@ -1,20 +0,0 @@
-import logging
-from typing import List
-
-from fastapi import APIRouter
-from llama_index.server.api.models import ComponentDefinition
-from llama_index.server.services.custom_ui import CustomUI
-
-
-def custom_components_router(
-    component_dir: str,
-    logger: logging.Logger,
-) -> APIRouter:
-    router = APIRouter(prefix="/components")
-
-    @router.get("")
-    async def components() -> List[ComponentDefinition]:
-        custom_ui = CustomUI(component_dir=component_dir, logger=logger)
-        return custom_ui.get_components()
-
-    return router

llama-index-server/llama_index/server/api/utils/vercel_stream.py

@@ -1,44 +0,0 @@
-import json
-import logging
-from typing import Any, AsyncGenerator, Union
-
-from fastapi.responses import StreamingResponse
-
-logger = logging.getLogger("uvicorn")
-
-
-class VercelStreamResponse(StreamingResponse):
-    """
-    Converts preprocessed events into Vercel-compatible streaming response format.
-    """
-
-    TEXT_PREFIX = "0:"
-    DATA_PREFIX = "8:"
-    ERROR_PREFIX = "3:"
-
-    def __init__(
-        self,
-        content_generator: AsyncGenerator[str, None],
-        *args: Any,
-        **kwargs: Any,
-    ):
-        super().__init__(content_generator, *args, **kwargs)
-
-    @classmethod
-    def convert_text(cls, token: str) -> str:
-        """Convert text event to Vercel format."""
-        # Escape newlines and double quotes to avoid breaking the stream
-        token = json.dumps(token)
-        return f"{cls.TEXT_PREFIX}{token}\n"
-
-    @classmethod
-    def convert_data(cls, data: Union[dict, str]) -> str:
-        """Convert data event to Vercel format."""
-        data_str = json.dumps(data) if isinstance(data, dict) else data
-        return f"{cls.DATA_PREFIX}[{data_str}]\n"
-
-    @classmethod
-    def convert_error(cls, error: str) -> str:
-        """Convert error event to Vercel format."""
-        error_str = json.dumps(error)
-        return f"{cls.ERROR_PREFIX}{error_str}\n"

llama-index-server/llama_index/server/chat_ui.py

@@ -1,55 +0,0 @@
-import logging
-import shutil
-from pathlib import Path
-from typing import Optional
-
-import requests
-
-CHAT_UI_VERSION = "0.1.5"
-
-
-def download_chat_ui(
-    logger: Optional[logging.Logger] = None, target_path: str = ".ui"
-) -> None:
-    if logger is None:
-        logger = logging.getLogger("uvicorn")
-    path = Path(target_path)
-    temp_dir = _download_package(_get_download_link(CHAT_UI_VERSION))
-    _copy_ui_files(temp_dir, path)
-    logger.info("Chat UI downloaded and copied to static folder")
-
-
-def _get_download_link(version: str) -> str:
-    """Get the download link for the chat UI from the npm registry."""
-    return f"https://registry.npmjs.org/@llamaindex/server/-/server-{version}.tgz"
-
-
-def _download_package(url: str) -> Path:
-    """Download tar.gz file and extract all files into a temporary directory."""
-    import io
-    import tarfile
-    import tempfile
-
-    response = requests.get(url, headers={"User-Agent": "Mozilla/5.0"})
-    content = response.content
-
-    temp_dir = Path(tempfile.mkdtemp())
-
-    with tarfile.open(fileobj=io.BytesIO(content), mode="r:gz") as tar:
-        tar.extractall(path=temp_dir)
-
-    return temp_dir
-
-
-def _copy_ui_files(temp_dir: Path, target_path: Path) -> None:
-    """Copy files from the .next directory to the static directory."""
-    target_path.mkdir(parents=True, exist_ok=True)
-    next_dir = temp_dir / "package/dist/static"
-
-    if next_dir.exists():
-        for item in next_dir.iterdir():
-            dest = target_path / item.name
-            if item.is_dir():
-                shutil.copytree(item, dest, dirs_exist_ok=True)
-            else:
-                shutil.copy2(item, dest)

llama-index-server/llama_index/server/gen_ui/__init__.py

@@ -1,4 +0,0 @@
-from .main import generate_event_component
-from .parse_workflow_code import get_workflow_event_schemas
-
-__all__ = ["generate_event_component", "get_workflow_event_schemas"]

llama-index-server/llama_index/server/gen_ui/main.py

@@ -1,442 +0,0 @@
-import re
-from typing import Any, Dict, List, Optional, Type
-
-from pydantic import BaseModel
-from rich.console import Console
-from rich.live import Live
-from rich.panel import Panel
-
-from llama_index.core.llms import LLM
-from llama_index.core.prompts import PromptTemplate
-from llama_index.core.workflow import (
-    Context,
-    Event,
-    StartEvent,
-    StopEvent,
-    Workflow,
-    step,
-)
-from llama_index.server.gen_ui.parse_workflow_code import get_workflow_event_schemas
-
-
-class PlanningEvent(Event):
-    """
-    Event for planning the UI.
-    """
-
-    events: List[Dict[str, Any]]
-
-
-class WriteAggregationEvent(Event):
-    """
-    Event for aggregating events.
-    """
-
-    events: List[Dict[str, Any]]
-    ui_description: str
-
-
-class WriteUIComponentEvent(Event):
-    """
-    Event for writing UI component.
-    """
-
-    events: List[Dict[str, Any]]
-    aggregation_function: Optional[str]
-    ui_description: str
-
-
-class RefineGeneratedCodeEvent(Event):
-    """
-    Refine the generated code.
-    """
-
-    generated_code: str
-    aggregation_function_context: Optional[str]
-    events: List[Dict[str, Any]]
-
-
-class ExtractEventSchemaEvent(Event):
-    """
-    Extract the event schema from the event.
-    """
-
-    events: List[Any]
-
-
-class AggregatePrediction(BaseModel):
-    """
-    Prediction for aggregating events or not.
-    If need_aggregation is True, the aggregation_function will be provided.
-    """
-
-    need_aggregation: bool
-    aggregation_function: Optional[str]
-
-
-class GenUIWorkflow(Workflow):
-    """
-    Generate UI component for event from workflow.
-    """
-
-    code_structure: str = """
-        ```jsx
-            // Note: Only React, shadcn/ui, lucide-react, LlamaIndex's markdown-ui and tailwind css (cn) are allowed.
-
-            // export the component
-            export default function Component({ events }) {
-                // logic for aggregating events (if needed)
-                const aggregateEvents = () => {
-                    // code for aggregating events here
-                }
-            
-                // State handling
-                // e.g: const [state, setState] = useState({});
-
-                return (
-                    // UI code here
-                )
-            }
-        ```
-    """
-
-    supported_deps = """
-        - React: import { useState } from "react";
-        - shadcn/ui: import { ComponentName } from "@/components/ui/<component_path>";
-            Supported shadcn components:  
-                accordion, alert, alert-dialog, aspect-ratio, avatar, badge, 
-                breadcrumb, button, calendar, card, carousel, chart, checkbox, collapsible, command, 
-                context-menu, dialog, drawer, dropdown-menu, form, hover-card, input, input-otp, label, 
-                menubar, navigation-menu, pagination, popover, progress, radio-group, resizable, 
-                scroll-area, select, separator, sheet, sidebar, skeleton, slider, sonner, switch, table, 
-                tabs, textarea, toggle, toggle-group, tooltip  
-        - lucide-react: import { IconName } from "lucide-react";
-        - tailwind css: import { cn } from "@/lib/utils"; // Note: clsx is not supported
-        - LlamaIndex's markdown-ui: import { Markdown } from "@llamaindex/chat-ui/widgets";
-    """
-
-    def __init__(self, llm: LLM, **kwargs: Any):
-        super().__init__(**kwargs)
-        self.llm = llm
-        self.console = Console()
-        self._live: Optional[Live] = None
-        self._completed_steps: List[str] = []
-        self._current_step: Optional[str] = None
-
-    def update_status(self, message: str, completed: bool = False) -> None:
-        """Show completed and current steps in a panel."""
-        if completed:
-            if self._current_step:
-                self._completed_steps.append(self._current_step)
-            self._current_step = None
-        else:
-            self._current_step = message
-
-        if self._live is None:
-            self._live = Live("", console=self.console, refresh_per_second=4)
-            self._live.start()
-
-        # Build status display
-        status_lines = []
-        for completed_step in self._completed_steps:
-            status_lines.append(f"[green]✓[/green] {completed_step}")
-        if self._current_step:
-            status_lines.append(f"[yellow]⋯[/yellow] {self._current_step}")
-
-        self._live.update(Panel("\n".join(status_lines)))
-
-    @step
-    async def start(self, ctx: Context, ev: StartEvent) -> PlanningEvent:
-        events = ev.events
-        if not events:
-            raise ValueError(
-                "events is required, provide list of filtered events to generate UI components for"
-            )
-        await ctx.set("events", events)
-        self.update_status("Planning the UI")
-        return PlanningEvent(events=events)
-
-    @step
-    async def planning(self, ctx: Context, ev: PlanningEvent) -> WriteAggregationEvent:
-        prompt_template = """
-            # Your role
-            You are a designer who is designing a UI for given events that are emitted from a backend workflow.
-            Here are the events that you need to work on: {events}
-
-            # Task
-            Your task is to analyze the event schema and data and provide a description that how the UI would look like.
-            The UI should be beautiful, no monotonous, and visually pleasing.
-            Focus on the elements and the layout, don't ask too much on the styles (transition, dark mode, responsive, etc...).
-
-            e.g: Assume that the backend produce list of events with animal name, action, and status.
-            ```
-            A card-based layout displaying animal actions:
-            - Each card shows an animal's image at the top
-            - Below the image: animal name as the card title
-            - Action details in the card body with an icon (eating 🍖, sleeping 😴, playing 🎾)
-            - Status badge in the corner showing if action is ongoing/completed
-            - Expandable section for additional details
-            - Soft color scheme based on action type
-            ```
-            Don't be verbose, just return the description for the UI based on the event schema and data.
-        """
-        response = await self.llm.acomplete(
-            PromptTemplate(prompt_template).format(events=ev.events),
-            formatted=True,
-        )
-        await ctx.set("ui_description", response.text)
-        self.update_status("Planning the UI", completed=True)
-        # Update the planning description to the console
-        self.console.print(
-            Panel(
-                response.text,
-                title="UI Description",
-                border_style="cyan",
-            )
-        )
-        self.update_status("Generating aggregation function")
-        return WriteAggregationEvent(
-            events=ev.events,
-            ui_description=response.text,
-        )
-
-    @step
-    async def generate_event_aggregations(
-        self, ctx: Context, ev: WriteAggregationEvent
-    ) -> WriteUIComponentEvent:
-        prompt_template = """
-            # Your role
-            You are a frontend developer who is developing a React component for given events that are emitted from a backend workflow.
-            Here are the events that you need to work on: {events}
-            Here is the description of the UI:
-            ```
-                {ui_description}
-            ```
-
-            # Task
-            Based on the description of the UI and the list of events, write the aggregation function that will be used to aggregate the events.
-            Take into account that the list of events grows with time. At the beginning, there is only one event in the list, and events are incrementally added. 
-            To render the events in a visually pleasing way, try to aggregate them by their attributes and render the aggregates instead of just rendering a list of all events.
-            Don't add computation to the aggregation function, just group the events by their attributes.
-            Make sure that the aggregation should reflect the description of the UI and the grouped events are not duplicated, make it as simple as possible to avoid unnecessary issues.
-
-            # Answer with the following format:
-            ```jsx
-            const aggregateEvents = () => {
-                // code for aggregating events here if needed otherwise let the jsx code block empty
-            }
-            ```
-            """
-
-        response = await self.llm.acomplete(
-            PromptTemplate(prompt_template).format(
-                events=ev.events,
-                ui_description=ev.ui_description,
-            ),
-            formatted=True,
-        )
-        await ctx.set("aggregation_context", response.text)
-
-        self.update_status("Generating aggregation function", completed=True)
-        self.update_status("Generating UI components")
-        return WriteUIComponentEvent(
-            events=ev.events,
-            aggregation_function=response.text,
-            ui_description=ev.ui_description,
-        )
-
-    @step
-    async def write_ui_component(
-        self, ctx: Context, ev: WriteUIComponentEvent
-    ) -> RefineGeneratedCodeEvent:
-        prompt_template = """
-            # Your role
-            You are a frontend developer who is developing a React component using shadcn/ui, lucide-react, LlamaIndex's chat-ui, and tailwind css (cn) for the UI.
-            You are given a list of events and other context.
-            Your task is to write a beautiful UI for the events that will be included in a chat UI.
-
-            # Context:
-            Here are the events that you need to work on: {events}
-            {aggregation_function_context}
-            Here is the description of the UI:
-            ```
-                {ui_description}
-            ```
-
-            # Supported dependencies:
-            {supported_deps}
-
-            # Requirements:
-            - Write beautiful UI components for the events using the supported dependencies
-            - The component text/label should be specified for each event type.
-
-            # Instructions:
-            ## Event and schema notice
-            - Based on the provided list of events, determine their types and attributes.
-            - It's normal that the schema is applied to all events, but the events might completely different which some of schema attributes aren't used.
-            - You should make the component visually distinct for each event type.
-              e.g: A simple cat schema
-                ```{"type": "cat", "action": ["jump", "run", "meow"], "jump": {"height": 10, "distance": 20}, "run": {"distance": 100}}```
-                You should display the jump, run and meow actions in different ways. don't try to render "height" for the "run" and "meow" action.
-
-            ## UI notice
-            - Use the supported dependencies for the UI.
-            - Be careful on state handling, make sure the update should be updated in the state and there is no duplicate state.
-            - For a long content, consider to use markdown along with dropdown to show the full content.
-                e.g:
-                ```jsx
-                import { Markdown } from "@llamaindex/chat-ui/widgets";
-                <Markdown content={content} />
-                ```
-            - Try to make the component placement not monotonous, consider use row/column/flex/grid layout.
-            """
-
-        aggregation_function_context = (
-            f"\nBefore rendering the events, we're using the following aggregation function: {ev.aggregation_function}"
-            if ev.aggregation_function
-            else ""
-        )
-
-        prompt = PromptTemplate(prompt_template).format(
-            events=ev.events,
-            aggregation_function_context=aggregation_function_context,
-            code_structure=self.code_structure,
-            ui_description=ev.ui_description,
-            supported_deps=self.supported_deps,
-        )
-        response = await self.llm.acomplete(prompt, formatted=True)
-
-        self.update_status("Generating UI components", completed=True)
-        self.update_status("Refining generated code")
-        return RefineGeneratedCodeEvent(
-            generated_code=response.text,
-            events=ev.events,
-            aggregation_function_context=aggregation_function_context,
-        )
-
-    @step
-    async def refine_code(
-        self, ctx: Context, ev: RefineGeneratedCodeEvent
-    ) -> StopEvent:
-        prompt_template = """
-            # Your role
-            You are a frontend developer who is developing a React component for given events that are emitted from a backend workflow.
-            Your task is to assemble the pieces of code into a complete code segment that follows the specified code structure.
-
-            # Context:
-            ## Here is the generated code:
-            {generated_code}
-
-            {aggregation_function_context}
-
-            ## The generated code should follow the following structure:
-            {code_structure}
-
-            # Requirements:
-            - Only use supported dependencies: {supported_deps}
-            - Refine the code if needed to ensure there are no potential bugs. 
-            - Be careful on code placement, make sure it doesn't call any undefined code.
-            - Make sure the import statements are correct. 
-              e.g: import { Button, Card, Accordion } from "@/components/ui" is correct because Button, Card are defined in different shadcn/ui components.
-              -> correction: import { Button } from "@/components/ui/button";
-                             import { Card } from "@/components/ui/card";
-            - Don't be verbose, only return the code, wrap it in ```jsx <code>```
-        """
-        prompt = PromptTemplate(prompt_template).format(
-            generated_code=ev.generated_code,
-            code_structure=self.code_structure,
-            aggregation_function_context=ev.aggregation_function_context,
-            supported_deps=self.supported_deps,
-        )
-
-        response = await self.llm.acomplete(prompt, formatted=True)
-
-        # Extract code from response, handling case where code block is missing
-        code_match = re.search(r"```jsx(.*)```", response.text, re.DOTALL)
-        if code_match is None:
-            # If no code block found, use full response
-            code = response.text
-        else:
-            code = code_match.group(1).strip()
-
-        self.update_status("Refining generated code", completed=True)
-        if self._live is not None:
-            self._live.stop()
-            self._live = None
-
-        return StopEvent(
-            result=code,
-        )
-
-
-async def generate_event_component(
-    workflow_file: Optional[str] = None,
-    event_cls: Optional[Type[BaseModel]] = None,
-    llm: Optional[LLM] = None,
-) -> str:
-    """
-    Generate UI component for events from workflow.
-    Either workflow_file or event_cls must be provided.
-
-    Args:
-        workflow_file: The path to the workflow file that contains the event to generate UI for. e.g: `app/workflow.py`.
-        event_cls: A Pydantic class to generate UI for. e.g: `DeepResearchEvent`.
-        llm: The LLM to use for the generation. Default is Anthropic's Claude 3.7 Sonnet.
-             We recommend using these LLMs:
-                - Anthropic's Claude 3.7 Sonnet
-                - OpenAI's GPT-4.1
-                - Google Gemini 2.5 Pro
-    Returns:
-        The generated UI component code.
-    """
-    if workflow_file is None and event_cls is None:
-        raise ValueError(
-            "Either workflow_file or event_cls must be provided. Please provide one of them."
-        )
-    if workflow_file is not None and event_cls is not None:
-        raise ValueError(
-            "Only one of workflow_file or event_cls can be provided. Please provide only one of them."
-        )
-    if llm is None:
-        from llama_index.llms.anthropic import Anthropic
-
-        llm = Anthropic(model="claude-3-7-sonnet-latest", max_tokens=8192)
-
-    console = Console()
-
-    # Get event schemas
-    if workflow_file is not None:
-        # Get event schemas from the input file
-        console.rule("[bold blue]Analyzing Events[/bold blue]")
-        event_schemas = get_workflow_event_schemas(workflow_file)
-        if len(event_schemas) == 0:
-            console.print(
-                Panel(
-                    "[red]No events found that are used with write_event_to_stream[/red]",
-                    title="❌ Error",
-                    border_style="red",
-                )
-            )
-            raise RuntimeError(
-                "No events found that are used with write_event_to_stream. Please check the workflow file."
-            )
-    elif event_cls is not None:
-        event_schemas = [
-            {"type": event_cls.__name__, "schema": event_cls.model_json_schema()}
-        ]
-
-    # Generate UI component from event schemas
-    console.rule("[bold blue]Generate UI Components[/bold blue]")
-
-    workflow = GenUIWorkflow(llm=llm, timeout=500.0)
-    code = await workflow.run(events=event_schemas)
-
-    console.print(
-        Panel(
-            "[green]UI component has been generated successfully![/green]\n",
-            title="✨ Complete",
-            border_style="green",
-        )
-    )
-
-    return code

llama-index-server/llama_index/server/gen_ui/parse_workflow_code.py

@@ -1,93 +0,0 @@
-import ast
-import importlib
-import inspect
-import os
-import sys
-from typing import Any, Dict, List
-
-
-class EventAnalyzer(ast.NodeVisitor):
-    """
-    Parse the workflow code to find UIEvent instances passed to write_event_to_stream.
-    """
-
-    def __init__(self) -> None:
-        self.found_ui_event = False
-
-    def visit_Call(self, node: ast.Call) -> None:
-        # Check for ctx.write_event_to_stream call with UIEvent arg
-        if (
-            isinstance(node.func, ast.Attribute)
-            and isinstance(node.func.value, ast.Name)
-            and node.func.attr == "write_event_to_stream"
-            and node.args
-            and isinstance(node.args[0], ast.Call)
-            and isinstance(node.args[0].func, ast.Name)
-            and node.args[0].func.id == "UIEvent"
-        ):
-            self.found_ui_event = True
-
-        self.generic_visit(node)
-
-
-def get_workflow_event_schemas(file_path: str) -> List[Dict[str, Any]]:
-    """
-    Find UIEvent instances passed to write_event_to_stream and return their data type schema.
-    """
-    # Get absolute path for module importing
-    abs_file_path = os.path.abspath(file_path)
-    project_root = os.path.dirname(os.path.dirname(abs_file_path))
-
-    # Convert file path to module name
-    rel_path = os.path.relpath(abs_file_path, project_root)
-    module_name = rel_path.replace(os.sep, ".").replace(".py", "")
-
-    # Temporarily modify sys.path to allow imports
-    original_path = list(sys.path)
-    if project_root not in sys.path:
-        sys.path.insert(0, project_root)
-
-    try:
-        # Import the module
-        module = importlib.import_module(module_name)
-        importlib.reload(module)
-    except ImportError as e:
-        print(f"Error importing module {module_name}: {e}")
-        sys.path = original_path
-        return []
-    finally:
-        # Restore original path
-        if project_root in sys.path and project_root not in original_path:
-            sys.path.remove(project_root)
-
-    # Parse the file to check for UIEvent usage
-    try:
-        with open(file_path, "r") as f:
-            tree = ast.parse(f.read())
-    except (FileNotFoundError, SyntaxError) as e:
-        print(f"Error parsing {file_path}: {e}")
-        return []
-
-    # Check if UIEvent is passed to write_event_to_stream
-    analyzer = EventAnalyzer()
-    analyzer.visit(tree)
-
-    schema_list = []
-
-    # Only proceed if UIEvent was found and the module has the class
-    if analyzer.found_ui_event and hasattr(module, "UIEvent"):
-        # Look for class names containing "EventData" in the module
-        for name, obj in inspect.getmembers(module):
-            if (
-                inspect.isclass(obj)
-                and name.endswith("EventData")
-                and hasattr(obj, "model_json_schema")
-            ):
-                try:
-                    schema = obj.model_json_schema()
-                    if schema:
-                        schema_list.append(schema)
-                except Exception:
-                    pass
-
-    return schema_list

llama-index-server/llama_index/server/server.py

@@ -1,230 +0,0 @@
-import json
-import logging
-import os
-from typing import Any, Callable, Optional, Union
-
-from fastapi import FastAPI
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.staticfiles import StaticFiles
-from llama_index.core.workflow import Workflow
-from llama_index.server.api.routers import chat_router, custom_components_router
-from llama_index.server.chat_ui import download_chat_ui
-from llama_index.server.settings import server_settings
-from pydantic import BaseModel, Field
-
-
-class UIConfig(BaseModel):
-    enabled: bool = Field(default=True, description="Whether to enable the chat UI")
-    app_title: str = Field(
-        default="LlamaIndex Server", description="The title of the chat UI"
-    )
-    starter_questions: Optional[list[str]] = Field(
-        default=None, description="The starter questions for the chat UI"
-    )
-    llamacloud_index_selector: bool = Field(
-        default=False,
-        description="Whether to show the LlamaCloud index selector in the chat UI (need to set the LLAMA_CLOUD_API_KEY environment variable)",
-    )
-    ui_path: str = Field(
-        default=".ui", description="The path that stores static files for the chat UI"
-    )
-    component_dir: Optional[str] = Field(
-        default=None, description="The directory to custom UI components code"
-    )
-
-    def get_config_content(self) -> str:
-        return json.dumps(
-            {
-                "CHAT_API": f"{server_settings.api_url}/chat",
-                "STARTER_QUESTIONS": self.starter_questions or [],
-                "LLAMA_CLOUD_API": f"{server_settings.api_url}/chat/config/llamacloud"
-                if self.llamacloud_index_selector and os.getenv("LLAMA_CLOUD_API_KEY")
-                else None,
-                "APP_TITLE": self.app_title,
-                "COMPONENTS_API": f"{server_settings.api_url}/components"
-                if self.component_dir
-                else None,
-            },
-            indent=2,
-        )
-
-
-class LlamaIndexServer(FastAPI):
-    workflow_factory: Callable[..., Workflow]
-    verbose: bool = False
-    ui_config: UIConfig
-
-    def __init__(
-        self,
-        workflow_factory: Callable[..., Workflow],
-        logger: Optional[logging.Logger] = None,
-        use_default_routers: Optional[bool] = True,
-        env: Optional[str] = None,
-        ui_config: Optional[Union[UIConfig, dict]] = None,
-        server_url: Optional[str] = None,
-        api_prefix: Optional[str] = None,
-        verbose: bool = False,
-        *args: Any,
-        **kwargs: Any,
-    ):
-        """
-        Initialize the LlamaIndexServer.
-
-        Args:
-            workflow_factory: A factory function that creates a workflow instance for each request.
-            logger: The logger to use.
-            use_default_routers: Whether to use the default routers (chat, mount `data` and `output` directories).
-            env: The environment to run the server in.
-            ui_config: The configuration for the chat UI.
-            server_url: The URL of the server.
-            api_prefix: The prefix for the API endpoints.
-            verbose: Whether to show verbose logs.
-        """
-        super().__init__(*args, **kwargs)
-
-        self.workflow_factory = workflow_factory
-        self.logger = logger or logging.getLogger("uvicorn")
-        self.verbose = verbose
-        self.use_default_routers = use_default_routers or True
-        if ui_config is None:
-            self.ui_config = UIConfig()
-        elif isinstance(ui_config, dict):
-            self.ui_config = UIConfig(**ui_config)
-        else:
-            self.ui_config = ui_config
-
-        # Update the settings
-        if server_url:
-            server_settings.set_url(server_url)
-        if api_prefix:
-            server_settings.set_api_prefix(api_prefix)
-
-        if self.use_default_routers:
-            self.add_default_routers()
-
-        if str(env).lower() == "dev":
-            self.allow_cors("*")
-            if self.ui_config.enabled is None:
-                self.ui_config.enabled = True
-
-        if self.ui_config.enabled is None:
-            self.ui_config.enabled = False
-
-        if self.ui_config.enabled:
-            self.mount_ui()
-
-    # Default routers
-    def add_default_routers(self) -> None:
-        self.add_chat_router()
-        self.mount_data_dir()
-        self.mount_output_dir()
-
-    def add_chat_router(self) -> None:
-        """
-        Add the chat router.
-        """
-        self.include_router(
-            chat_router(
-                self.workflow_factory,
-                self.logger,
-            ),
-            prefix=server_settings.api_prefix,
-        )
-
-    def add_components_router(self) -> None:
-        """
-        Add the UI router.
-        """
-        if self.ui_config.component_dir is None:
-            raise ValueError("component_dir must be specified to add components router")
-
-        self.include_router(
-            custom_components_router(self.ui_config.component_dir, self.logger),
-            prefix=server_settings.api_prefix,
-        )
-
-    def mount_ui(self) -> None:
-        """
-        Mount the UI.
-        """
-        # Check if the static folder exists
-        if self.ui_config.enabled:
-            # Component dir
-            if self.ui_config.component_dir:
-                if not os.path.exists(self.ui_config.component_dir):
-                    os.makedirs(self.ui_config.component_dir)
-                self.add_components_router()
-            # UI static files
-            if not os.path.exists(self.ui_config.ui_path):
-                os.makedirs(self.ui_config.ui_path)
-                self.logger.warning(
-                    f"UI files not found, downloading UI to {self.ui_config.ui_path}"
-                )
-                download_chat_ui(logger=self.logger, target_path=self.ui_config.ui_path)
-            self._mount_static_files(
-                directory=self.ui_config.ui_path, path="/", html=True
-            )
-            self._override_ui_config()
-
-    def _override_ui_config(self) -> None:
-        """
-        Override the UI config by writing a complete configuration file.
-        """
-        try:
-            config_path = os.path.join(self.ui_config.ui_path, "config.js")
-            if not os.path.exists(config_path):
-                self.logger.error("Config file not found")
-                return
-            config_content = (
-                f"window.LLAMAINDEX = {self.ui_config.get_config_content()};"
-            )
-            with open(config_path, "w") as f:
-                f.write(config_content)
-        except Exception as e:
-            self.logger.error(f"Error overriding UI config: {e}")
-
-    def mount_data_dir(self, data_dir: str = "data") -> None:
-        """
-        Mount the data directory.
-        """
-        self._mount_static_files(
-            directory=data_dir,
-            path=f"{server_settings.api_prefix}/files/data",
-            html=True,
-        )
-
-    def mount_output_dir(self, output_dir: str = "output") -> None:
-        """
-        Mount the output directory.
-        """
-        self._mount_static_files(
-            directory=output_dir,
-            path=f"{server_settings.api_prefix}/files/output",
-            html=True,
-        )
-
-    def _mount_static_files(
-        self, directory: str, path: str, html: bool = False
-    ) -> None:
-        """
-        Mount static files from a directory if it exists.
-        """
-        if os.path.exists(directory):
-            self.logger.info(f"Mounting static files '{directory}' at '{path}'")
-            self.mount(
-                path,
-                StaticFiles(directory=directory, check_dir=False, html=html),
-                name=f"{directory}-static",
-            )
-
-    def allow_cors(self, origin: str = "*") -> None:
-        """
-        Allow CORS for a specific origin.
-        """
-        self.add_middleware(
-            CORSMiddleware,
-            allow_origins=[origin],
-            allow_credentials=True,
-            allow_methods=["*"],
-            allow_headers=["*"],
-        )

llama-index-server/llama_index/server/services/custom_ui.py

@@ -1,81 +0,0 @@
-import logging
-import os
-from typing import List, Optional
-
-from llama_index.server.api.models import ComponentDefinition
-
-
-class CustomUI:
-    def __init__(
-        self, component_dir: str, logger: Optional[logging.Logger] = None
-    ) -> None:
-        self.component_dir = component_dir
-        self.logger = logger or logging.getLogger(__name__)
-
-    def get_components(self) -> List[ComponentDefinition]:
-        """
-        List all js files in the component directory and return a list of ComponentDefinition objects.
-        Ignores files that fail to load and logs the error.
-        TSX files take precedence over JSX files when duplicate component names are found.
-        """
-        components_dict: dict[str, ComponentDefinition] = {}
-        if not os.path.exists(self.component_dir):
-            self.logger.warning(
-                f"Component directory {self.component_dir} does not exist"
-            )
-            return []
-        try:
-            for file in os.listdir(self.component_dir):
-                if not file.endswith((".jsx", ".tsx")):
-                    continue
-
-                component_name = file.split(".")[0]
-                file_path = os.path.join(self.component_dir, file)
-                file_ext = os.path.splitext(file)[1]
-
-                try:
-                    with open(file_path, "r", encoding="utf-8") as f:
-                        code = f.read()
-                        new_component = ComponentDefinition(
-                            type=component_name,
-                            code=code,
-                            filename=file,
-                        )
-
-                        if component_name in components_dict:
-                            existing_ext = os.path.splitext(
-                                components_dict[component_name].filename
-                            )[1]
-
-                            # If existing is TSX and new is JSX, skip and warn
-                            if existing_ext == ".tsx" and file_ext == ".jsx":
-                                self.logger.warning(
-                                    f"Skipping duplicate JSX component {file} as TSX version already exists"
-                                )
-                                continue
-
-                            # If both are same extension, warn and skip
-                            if existing_ext == file_ext:
-                                self.logger.warning(
-                                    f"Skipping duplicate component {file} with same extension"
-                                )
-                                continue
-
-                            # If existing is JSX and new is TSX, replace and warn
-                            if existing_ext == ".jsx" and file_ext == ".tsx":
-                                self.logger.warning(
-                                    f"Replacing JSX component {components_dict[component_name].filename} with TSX version {file}"
-                                )
-                                components_dict[component_name] = new_component
-                                continue
-
-                        components_dict[component_name] = new_component
-
-                except Exception as e:
-                    self.logger.error(f"Failed to load component {file}: {str(e)}")
-                    continue
-
-        except Exception as e:
-            self.logger.error(f"Error reading component directory: {str(e)}")
-
-        return list(components_dict.values())

llama-index-server/llama_index/server/services/file.py

@@ -1,117 +0,0 @@
-import logging
-import os
-import re
-import uuid
-from pathlib import Path
-from typing import List, Optional, Union
-
-from llama_index.server.settings import server_settings
-from pydantic import BaseModel, Field
-
-logger = logging.getLogger(__name__)
-
-PRIVATE_STORE_PATH = str(Path("output", "uploaded"))
-TOOL_STORE_PATH = str(Path("output", "tools"))
-LLAMA_CLOUD_STORE_PATH = str(Path("output", "llamacloud"))
-
-
-class DocumentFile(BaseModel):
-    id: str
-    name: str  # Stored file name
-    type: Optional[str] = None
-    size: Optional[int] = None
-    url: Optional[str] = None
-    path: Optional[str] = Field(
-        None,
-        description="The stored file path. Used internally in the server.",
-        exclude=True,
-    )
-    refs: Optional[List[str]] = Field(
-        None, description="The document ids in the index."
-    )
-
-
-class FileService:
-    """
-    To store the files uploaded by the user.
-    """
-
-    @classmethod
-    def save_file(
-        cls,
-        content: Union[bytes, str],
-        file_name: str,
-        save_dir: Optional[str] = None,
-    ) -> DocumentFile:
-        """
-        Save the content to a file in the local file server (accessible via URL).
-
-        Args:
-            content (bytes | str): The content to save, either bytes or string.
-            file_name (str): The original name of the file.
-            save_dir (Optional[str]): The relative path from the current working directory. Defaults to the `output/uploaded` directory.
-
-        Returns:
-            The metadata of the saved file.
-        """
-        if save_dir is None:
-            save_dir = os.path.join("output", "uploaded")
-
-        file_id = str(uuid.uuid4())
-        name, extension = os.path.splitext(file_name)
-        extension = extension.lstrip(".")
-        sanitized_name = _sanitize_file_name(name)
-        if extension == "":
-            raise ValueError("File is not supported!")
-        new_file_name = f"{sanitized_name}_{file_id}.{extension}"
-
-        file_path = os.path.join(save_dir, new_file_name)
-
-        if isinstance(content, str):
-            content = content.encode()
-
-        try:
-            os.makedirs(os.path.dirname(file_path), exist_ok=True)
-            with open(file_path, "wb") as file:
-                file.write(content)
-        except PermissionError as e:
-            logger.error(f"Permission denied when writing to file {file_path}: {e!s}")
-            raise
-        except OSError as e:
-            logger.error(f"IO error occurred when writing to file {file_path}: {e!s}")
-            raise
-        except Exception as e:
-            logger.error(f"Unexpected error when writing to file {file_path}: {e!s}")
-            raise
-
-        logger.info(f"Saved file to {file_path}")
-
-        file_size = os.path.getsize(file_path)
-        file_url = (
-            f"{server_settings.file_server_url_prefix}/{save_dir}/{new_file_name}"
-        )
-        return DocumentFile(
-            id=file_id,
-            name=new_file_name,
-            type=extension,
-            size=file_size,
-            path=file_path,
-            url=file_url,
-            refs=None,
-        )
-
-    @classmethod
-    def get_file_url(cls, file_name: str, save_dir: Optional[str] = None) -> str:
-        """
-        Get the URL of a file.
-        """
-        if save_dir is None:
-            save_dir = os.path.join("output", "uploaded")
-        return f"{server_settings.file_server_url_prefix}/{save_dir}/{file_name}"
-
-
-def _sanitize_file_name(file_name: str) -> str:
-    """
-    Sanitize the file name by replacing all non-alphanumeric characters with underscores.
-    """
-    return re.sub(r"[^a-zA-Z0-9.]", "_", file_name)

llama-index-server/llama_index/server/services/llamacloud/__init__.py

@@ -1,11 +0,0 @@
-from .file import LlamaCloudFileService
-from .generate import load_to_llamacloud
-from .index import LlamaCloudIndex, get_client, get_index
-
-__all__ = [
-    "LlamaCloudFileService",
-    "LlamaCloudIndex",
-    "get_client",
-    "get_index",
-    "load_to_llamacloud",
-]

llama-index-server/llama_index/server/services/llamacloud/file.py

@@ -1,184 +0,0 @@
-import logging
-import os
-import time
-import typing
-from io import BytesIO
-from typing import Any, Dict, List, Optional, Set, Tuple, Union
-
-import requests
-from fastapi import BackgroundTasks
-from llama_cloud import ManagedIngestionStatus, PipelineFileCreateCustomMetadataValue
-from llama_index.core.schema import NodeWithScore
-from llama_index.server.api.models import SourceNodes
-from llama_index.server.services.llamacloud.index import get_client
-from pydantic import BaseModel
-
-logger = logging.getLogger("uvicorn")
-
-
-class LlamaCloudFile(BaseModel):
-    file_name: str
-    pipeline_id: str
-
-    def __eq__(self, other: Any) -> bool:
-        if not isinstance(other, LlamaCloudFile):
-            return NotImplemented
-        return (
-            self.file_name == other.file_name and self.pipeline_id == other.pipeline_id
-        )
-
-    def __hash__(self) -> int:
-        return hash((self.file_name, self.pipeline_id))
-
-
-class LlamaCloudFileService:
-    LOCAL_STORE_PATH = "output/llamacloud"
-    DOWNLOAD_FILE_NAME_TPL = "{pipeline_id}${filename}"
-
-    @classmethod
-    def get_all_projects_with_pipelines(cls) -> List[Dict[str, Any]]:
-        try:
-            client = get_client()
-            projects = client.projects.list_projects()
-            pipelines = client.pipelines.search_pipelines()
-            return [
-                {
-                    **(project.dict()),
-                    "pipelines": [
-                        {"id": p.id, "name": p.name}
-                        for p in pipelines
-                        if p.project_id == project.id
-                    ],
-                }
-                for project in projects
-            ]
-        except Exception as error:
-            logger.error(f"Error listing projects and pipelines: {error}")
-            return []
-
-    @classmethod
-    def add_file_to_pipeline(
-        cls,
-        project_id: str,
-        pipeline_id: str,
-        upload_file: Union[typing.IO, Tuple[str, BytesIO]],
-        custom_metadata: Optional[Dict[str, PipelineFileCreateCustomMetadataValue]],
-        wait_for_processing: bool = True,
-    ) -> str:
-        client = get_client()
-        file = client.files.upload_file(project_id=project_id, upload_file=upload_file)
-        file_id = file.id
-        files = [
-            {
-                "file_id": file_id,
-                "custom_metadata": {"file_id": file_id, **(custom_metadata or {})},
-            }
-        ]
-        files = client.pipelines.add_files_to_pipeline_api(pipeline_id, request=files)
-
-        if not wait_for_processing:
-            return file_id
-
-        # Wait 2s for the file to be processed
-        max_attempts = 20
-        attempt = 0
-        while attempt < max_attempts:
-            result = client.pipelines.get_pipeline_file_status(
-                file_id=file_id, pipeline_id=pipeline_id
-            )
-            if result.status == ManagedIngestionStatus.ERROR:
-                raise Exception(f"File processing failed: {str(result)}")
-            if result.status == ManagedIngestionStatus.SUCCESS:
-                # File is ingested - return the file id
-                return file_id
-            attempt += 1
-            time.sleep(0.1)  # Sleep for 100ms
-        raise Exception(
-            f"File processing did not complete after {max_attempts} attempts."
-        )
-
-    @classmethod
-    def download_pipeline_file(
-        cls,
-        file: LlamaCloudFile,
-        force_download: bool = False,
-    ) -> None:
-        client = get_client()
-        file_name = file.file_name
-        pipeline_id = file.pipeline_id
-
-        # Check is the file already exists
-        downloaded_file_path = cls._get_file_path(file_name, pipeline_id)
-        if os.path.exists(downloaded_file_path) and not force_download:
-            logger.debug(f"File {file_name} already exists in local storage")
-            return
-        try:
-            logger.info(f"Downloading file {file_name} for pipeline {pipeline_id}")
-            files = client.pipelines.list_pipeline_files(pipeline_id)
-            if not files or not isinstance(files, list):
-                raise Exception("No files found in LlamaCloud")
-            for file_entry in files:
-                if file_entry.name == file_name:
-                    file_id = file_entry.file_id
-                    project_id = file_entry.project_id
-                    file_detail = client.files.read_file_content(
-                        file_id, project_id=project_id
-                    )
-                    cls._download_file(file_detail.url, downloaded_file_path)
-                    break
-        except Exception as error:
-            logger.info(f"Error fetching file from LlamaCloud: {error}")
-
-    @classmethod
-    def download_files_from_nodes(
-        cls, nodes: List[NodeWithScore], background_tasks: BackgroundTasks
-    ) -> None:
-        files = cls._get_files_to_download(nodes)
-        for file in files:
-            logger.info(f"Adding download of {file.file_name} to background tasks")
-            background_tasks.add_task(cls.download_pipeline_file, file)
-
-    @classmethod
-    def _get_files_to_download(cls, nodes: List[NodeWithScore]) -> Set[LlamaCloudFile]:
-        source_nodes = SourceNodes.from_source_nodes(nodes)
-        llama_cloud_files = [
-            LlamaCloudFile(
-                file_name=node.metadata.get("file_name"),  # type: ignore
-                pipeline_id=node.metadata.get("pipeline_id"),  # type: ignore
-            )
-            for node in source_nodes
-            if (
-                node.metadata.get("pipeline_id") is not None
-                and node.metadata.get("file_name") is not None
-            )
-        ]
-        # Remove duplicates and return
-        return set(llama_cloud_files)
-
-    @classmethod
-    def _get_file_name(cls, name: str, pipeline_id: str) -> str:
-        return cls.DOWNLOAD_FILE_NAME_TPL.format(pipeline_id=pipeline_id, filename=name)
-
-    @classmethod
-    def _get_file_path(cls, name: str, pipeline_id: str) -> str:
-        return os.path.join(cls.LOCAL_STORE_PATH, cls._get_file_name(name, pipeline_id))
-
-    @classmethod
-    def _download_file(cls, url: str, local_file_path: str) -> None:
-        logger.info(f"Saving file to {local_file_path}")
-        # Create directory if it doesn't exist
-        os.makedirs(cls.LOCAL_STORE_PATH, exist_ok=True)
-        # Download the file
-        with requests.get(url, stream=True) as r:
-            r.raise_for_status()
-            with open(local_file_path, "wb") as f:
-                for chunk in r.iter_content(chunk_size=8192):
-                    f.write(chunk)
-        logger.info("File downloaded successfully")
-
-    @classmethod
-    def is_configured(cls) -> bool:
-        try:
-            return os.environ.get("LLAMA_CLOUD_API_KEY") is not None
-        except Exception:
-            return False

llama-index-server/llama_index/server/services/llamacloud/generate.py

@@ -1,56 +0,0 @@
-import logging
-from typing import Optional
-
-from tqdm import tqdm
-
-from llama_index.core.readers import SimpleDirectoryReader
-from llama_index.indices.managed.llama_cloud import LlamaCloudIndex
-from llama_index.server.services.llamacloud.file import LlamaCloudFileService
-
-
-def load_to_llamacloud(
-    index: LlamaCloudIndex,
-    data_dir: Optional[str] = None,
-    recursive: Optional[bool] = None,
-    logger: Optional[logging.Logger] = None,
-) -> None:
-    if logger is None:
-        logging.basicConfig(level=logging.INFO)
-        logger = logging.getLogger()
-
-    logger.info("Generate index for the provided data")
-
-    # use SimpleDirectoryReader to retrieve the files to process
-    reader = SimpleDirectoryReader(
-        data_dir or "data",
-        recursive=recursive or True,
-    )
-    files_to_process = reader.input_files
-
-    # add each file to the LlamaCloud pipeline
-    error_files = []
-    for input_file in tqdm(
-        files_to_process,
-        desc="Processing files",
-        unit="file",
-    ):
-        with open(input_file, "rb") as f:
-            logger.debug(
-                f"Adding file {input_file} to pipeline {index.name} in project {index.project_name}"
-            )
-            try:
-                LlamaCloudFileService.add_file_to_pipeline(
-                    index.project.id,
-                    index.pipeline.id,
-                    f,
-                    custom_metadata={},
-                    wait_for_processing=False,
-                )
-            except Exception as e:
-                error_files.append(input_file)
-                logger.error(f"Error adding file {input_file}: {e}")
-
-    if error_files:
-        logger.error(f"Failed to add the following files: {error_files}")
-
-    logger.info("Finished generating the index")

llama-index-server/llama_index/server/services/llamacloud/index.py

@@ -1,164 +0,0 @@
-import logging
-import os
-from typing import TYPE_CHECKING, Any, Optional
-
-from llama_cloud import PipelineType
-from llama_index.core.callbacks import CallbackManager
-from llama_index.core.ingestion.api_utils import (
-    get_client as llama_cloud_get_client,
-)
-from llama_index.core.settings import Settings
-from llama_index.indices.managed.llama_cloud import LlamaCloudIndex
-from llama_index.server.api.models import ChatRequest
-from pydantic import BaseModel, Field, field_validator
-
-if TYPE_CHECKING:
-    from llama_cloud.client import LlamaCloud
-
-logger = logging.getLogger("uvicorn")
-
-
-class LlamaCloudConfig(BaseModel):
-    # Private attributes
-    api_key: str = Field(
-        exclude=True,  # Exclude from the model representation
-    )
-    base_url: Optional[str] = Field(
-        exclude=True,
-    )
-    organization_id: Optional[str] = Field(
-        exclude=True,
-    )
-    # Configuration attributes, can be set by the user
-    pipeline: str = Field(
-        description="The name of the pipeline to use",
-    )
-    project: str = Field(
-        description="The name of the LlamaCloud project",
-    )
-
-    def __init__(self, **kwargs: Any) -> None:
-        if "api_key" not in kwargs:
-            kwargs["api_key"] = os.getenv("LLAMA_CLOUD_API_KEY")
-        if "base_url" not in kwargs:
-            kwargs["base_url"] = os.getenv("LLAMA_CLOUD_BASE_URL")
-        if "organization_id" not in kwargs:
-            kwargs["organization_id"] = os.getenv("LLAMA_CLOUD_ORGANIZATION_ID")
-        if "pipeline" not in kwargs:
-            kwargs["pipeline"] = os.getenv("LLAMA_CLOUD_INDEX_NAME")
-        if "project" not in kwargs:
-            kwargs["project"] = os.getenv("LLAMA_CLOUD_PROJECT_NAME")
-        super().__init__(**kwargs)
-
-    # Validate and throw error if the env variables are not set before starting the app
-    @field_validator("pipeline", "project", "api_key", mode="before")
-    @classmethod
-    def validate_fields(cls, value: Any) -> Any:
-        if value is None:
-            raise ValueError(
-                "Please set LLAMA_CLOUD_INDEX_NAME, LLAMA_CLOUD_PROJECT_NAME and LLAMA_CLOUD_API_KEY"
-                " to your environment variables or config them in .env file"
-            )
-        return value
-
-    def to_client_kwargs(self) -> dict:
-        return {
-            "api_key": self.api_key,
-            "base_url": self.base_url,
-        }
-
-
-class IndexConfig(BaseModel):
-    llama_cloud_pipeline_config: LlamaCloudConfig = Field(
-        default_factory=lambda: LlamaCloudConfig(),
-        alias="llamaCloudPipeline",
-    )
-    callback_manager: Optional[CallbackManager] = Field(
-        default=None,
-    )
-
-    def to_index_kwargs(self) -> dict:
-        return {
-            "name": self.llama_cloud_pipeline_config.pipeline,
-            "project_name": self.llama_cloud_pipeline_config.project,
-            "api_key": self.llama_cloud_pipeline_config.api_key,
-            "base_url": self.llama_cloud_pipeline_config.base_url,
-            "organization_id": self.llama_cloud_pipeline_config.organization_id,
-            "callback_manager": self.callback_manager,
-        }
-
-    @classmethod
-    def from_default(cls, chat_request: Optional[ChatRequest] = None) -> "IndexConfig":
-        default_config = cls()
-        if chat_request is not None and chat_request.data is not None:
-            llamacloud_config = chat_request.data.get("llamaCloudPipeline")
-            if llamacloud_config is not None:
-                default_config.llama_cloud_pipeline_config.pipeline = llamacloud_config[
-                    "pipeline"
-                ]
-                default_config.llama_cloud_pipeline_config.project = llamacloud_config[
-                    "project"
-                ]
-        return default_config
-
-
-def get_index(
-    chat_request: Optional[ChatRequest] = None,
-    create_if_missing: bool = False,
-) -> Optional[LlamaCloudIndex]:
-    config = IndexConfig.from_default(chat_request)
-    # Check whether the index exists
-    try:
-        index = LlamaCloudIndex(**config.to_index_kwargs())
-        return index
-    except ValueError:
-        logger.warning("Index not found")
-        if create_if_missing:
-            logger.info("Creating index")
-            _create_index(config)
-            return LlamaCloudIndex(**config.to_index_kwargs())
-        return None
-
-
-def get_client() -> "LlamaCloud":
-    config = LlamaCloudConfig()
-    return llama_cloud_get_client(**config.to_client_kwargs())
-
-
-def _create_index(
-    config: IndexConfig,
-) -> None:
-    client = get_client()
-    pipeline_name = config.llama_cloud_pipeline_config.pipeline
-
-    pipelines = client.pipelines.search_pipelines(
-        pipeline_name=pipeline_name,
-        pipeline_type=PipelineType.MANAGED.value,
-    )
-    if len(pipelines) == 0:
-        from llama_index.embeddings.openai import OpenAIEmbedding
-
-        if not isinstance(Settings.embed_model, OpenAIEmbedding):
-            raise ValueError(
-                "Creating a new pipeline with a non-OpenAI embedding model is not supported."
-            )
-        client.pipelines.upsert_pipeline(
-            request={
-                "name": pipeline_name,
-                "embedding_config": {
-                    "type": "OPENAI_EMBEDDING",
-                    "component": {
-                        "api_key": os.getenv("OPENAI_API_KEY"),  # editable
-                        "model_name": Settings.embed_model.model_name
-                        or "text-embedding-3-small",
-                    },
-                },
-                "transform_config": {
-                    "mode": "auto",
-                    "config": {
-                        "chunk_size": Settings.chunk_size,  # editable
-                        "chunk_overlap": Settings.chunk_overlap,  # editable
-                    },
-                },
-            },
-        )

llama-index-server/llama_index/server/services/suggest_next_question.py

@@ -1,95 +0,0 @@
-import logging
-import os
-import re
-from typing import List, Optional, Union
-
-from llama_index.core.prompts import PromptTemplate
-from llama_index.core.settings import Settings
-from llama_index.server.api.models import ChatAPIMessage
-
-logger = logging.getLogger("uvicorn")
-
-
-class SuggestNextQuestionsService:
-    """
-    Suggest the next questions that user might ask based on the conversation history.
-    """
-
-    prompt = PromptTemplate(
-        r"""
-You're a helpful assistant! Your task is to suggest the next questions that user might interested in to keep the conversation going.
-Here is the conversation history
----------------------
-{conversation}
----------------------
-Given the conversation history, please give me 3 questions that user might ask next!
-Your answer should be wrapped in three sticks without any index numbers and follows the following format:
-\`\`\`
-<question 1>
-<question 2>
-<question 3>
-\`\`\`
-"""
-    )
-
-    @classmethod
-    def get_configured_prompt(cls) -> PromptTemplate:
-        prompt = os.getenv("NEXT_QUESTION_PROMPT", None)
-        if not prompt:
-            return cls.prompt
-        return PromptTemplate(prompt)
-
-    @classmethod
-    async def suggest_next_questions_all_messages(
-        cls,
-        messages: List[ChatAPIMessage],
-    ) -> Optional[List[str]]:
-        """
-        Suggest the next questions that user might ask based on the conversation history.
-        """
-        prompt_template = cls.get_configured_prompt()
-
-        try:
-            # Reduce the cost by only using the last two messages
-            last_user_message = None
-            last_assistant_message = None
-            for message in reversed(messages):
-                if message.role == "user":
-                    last_user_message = f"User: {message.content}"
-                elif message.role == "assistant":
-                    last_assistant_message = f"Assistant: {message.content}"
-                if last_user_message and last_assistant_message:
-                    break
-            conversation: str = f"{last_user_message}\n{last_assistant_message}"
-
-            # Call the LLM and parse questions from the output
-            prompt = prompt_template.format(conversation=conversation)
-            output = await Settings.llm.acomplete(prompt)
-            return cls._extract_questions(output.text)
-
-        except Exception as e:
-            logger.error(f"Error when generating next question: {e}")
-            return None
-
-    @classmethod
-    def _extract_questions(cls, text: str) -> Union[List[str], None]:
-        content_match = re.search(r"```(.*?)```", text, re.DOTALL)
-        content = content_match.group(1) if content_match else None
-        if not content:
-            return None
-        return [q.strip() for q in content.split("\n") if q.strip()]
-
-    @classmethod
-    async def run(
-        cls,
-        chat_history: List[ChatAPIMessage],
-        response: str,
-    ) -> Optional[List[str]]:
-        """
-        Suggest the next questions that user might ask based on the chat history and the last response.
-        """
-        messages = [
-            *chat_history,
-            ChatAPIMessage(role="assistant", content=response),  # type: ignore
-        ]
-        return await cls.suggest_next_questions_all_messages(messages)

llama-index-server/llama_index/server/settings.py

@@ -1,47 +0,0 @@
-from pydantic import Field, validator
-from pydantic_settings import BaseSettings
-
-
-class ServerSettings(BaseSettings):
-    url: str = Field(
-        default="",
-        description="The deployment URL of the server, to be referenced by tools and file services",
-    )
-    api_prefix: str = Field(
-        default="/api",
-        description="The prefix for the API endpoints",
-    )
-
-    @property
-    def file_server_url_prefix(self) -> str:
-        return f"{self.url}{self.api_prefix}/files"
-
-    @property
-    def api_url(self) -> str:
-        return f"{self.url}{self.api_prefix}"
-
-    @validator("url")
-    def validate_url(cls, v: str) -> str:
-        if v.endswith("/"):
-            raise ValueError("URL must not end with a '/'")
-        return v
-
-    @validator("api_prefix")
-    def validate_api_prefix(cls, v: str) -> str:
-        if not v.startswith("/"):
-            raise ValueError("API prefix must start with a '/'")
-        return v
-
-    def set_url(self, v: str) -> None:
-        self.url = v
-        self.validate_url(v)  # type: ignore
-
-    def set_api_prefix(self, v: str) -> None:
-        self.api_prefix = v
-        self.validate_api_prefix(v)  # type: ignore
-
-    class Config:
-        env_file_encoding = "utf-8"
-
-
-server_settings = ServerSettings()

llama-index-server/llama_index/server/tools/document_generator.py

@@ -1,242 +0,0 @@
-import logging
-import os
-import re
-from enum import Enum
-from io import BytesIO
-
-from llama_index.core.tools.function_tool import FunctionTool
-
-OUTPUT_DIR = "output/tools"
-
-
-class DocumentType(Enum):
-    PDF = "pdf"
-    HTML = "html"
-
-
-COMMON_STYLES = """
-body {
-    font-family: Arial, sans-serif;
-    line-height: 1.3;
-    color: #333;
-}
-h1, h2, h3, h4, h5, h6 {
-    margin-top: 1em;
-    margin-bottom: 0.5em;
-}
-p {
-    margin-bottom: 0.7em;
-}
-code {
-    background-color: #f4f4f4;
-    padding: 2px 4px;
-    border-radius: 4px;
-}
-pre {
-    background-color: #f4f4f4;
-    padding: 10px;
-    border-radius: 4px;
-    overflow-x: auto;
-}
-table {
-    border-collapse: collapse;
-    width: 100%;
-    margin-bottom: 1em;
-}
-th, td {
-    border: 1px solid #ddd;
-    padding: 8px;
-    text-align: left;
-}
-th {
-    background-color: #f2f2f2;
-    font-weight: bold;
-}
-"""
-
-HTML_SPECIFIC_STYLES = """
-body {
-    max-width: 800px;
-    margin: 0 auto;
-    padding: 20px;
-}
-"""
-
-PDF_SPECIFIC_STYLES = """
-@page {
-    size: letter;
-    margin: 2cm;
-}
-body {
-    font-size: 11pt;
-}
-h1 { font-size: 18pt; }
-h2 { font-size: 16pt; }
-h3 { font-size: 14pt; }
-h4, h5, h6 { font-size: 12pt; }
-pre, code {
-    font-family: Courier, monospace;
-    font-size: 0.9em;
-}
-"""
-
-HTML_TEMPLATE = """
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <style>
-        {common_styles}
-        {specific_styles}
-    </style>
-</head>
-<body>
-    {content}
-</body>
-</html>
-"""
-
-
-class DocumentGenerator:
-    def __init__(self, file_server_url_prefix: str):
-        if not file_server_url_prefix:
-            raise ValueError("file_server_url_prefix is required")
-        self.file_server_url_prefix = file_server_url_prefix
-
-    @classmethod
-    def _generate_html_content(cls, original_content: str) -> str:
-        """
-        Generate HTML content from the original markdown content.
-        """
-        try:
-            import markdown  # type: ignore
-        except ImportError:
-            raise ImportError(
-                "Failed to import required modules. Please install markdown."
-            )
-
-        # Convert markdown to HTML with fenced code and table extensions
-        return markdown.markdown(original_content, extensions=["fenced_code", "tables"])
-
-    @classmethod
-    def _generate_pdf(cls, html_content: str) -> BytesIO:
-        """
-        Generate a PDF from the HTML content.
-        """
-        try:
-            from xhtml2pdf import pisa
-        except ImportError:
-            raise ImportError(
-                "Failed to import required modules. Please install xhtml2pdf."
-            )
-
-        pdf_html = HTML_TEMPLATE.format(
-            common_styles=COMMON_STYLES,
-            specific_styles=PDF_SPECIFIC_STYLES,
-            content=html_content,
-        )
-
-        buffer = BytesIO()
-        pdf = pisa.pisaDocument(
-            BytesIO(pdf_html.encode("UTF-8")), buffer, encoding="UTF-8"
-        )
-
-        if pdf.err:
-            logging.error(f"PDF generation failed: {pdf.err}")
-            raise ValueError("PDF generation failed")
-
-        buffer.seek(0)
-        return buffer
-
-    @classmethod
-    def _generate_html(cls, html_content: str) -> str:
-        """
-        Generate a complete HTML document with the given HTML content.
-        """
-        return HTML_TEMPLATE.format(
-            common_styles=COMMON_STYLES,
-            specific_styles=HTML_SPECIFIC_STYLES,
-            content=html_content,
-        )
-
-    def generate_document(
-        self, original_content: str, document_type: str, file_name: str
-    ) -> str:
-        """
-        To generate document as PDF or HTML file.
-        Parameters:
-            original_content: str (markdown style)
-            document_type: str (pdf or html) specify the type of the file format based on the use case
-            file_name: str (name of the document file) must be a valid file name, no extensions needed
-        Returns:
-            str (URL to the document file): A file URL ready to serve.
-        """
-        try:
-            doc_type = DocumentType(document_type.lower())
-        except ValueError:
-            raise ValueError(
-                f"Invalid document type: {document_type}. Must be 'pdf' or 'html'."
-            )
-        # Always generate html content first
-        html_content = self._generate_html_content(original_content)
-
-        # Based on the type of document, generate the corresponding file
-        if doc_type == DocumentType.PDF:
-            content = self._generate_pdf(html_content)
-            file_extension = "pdf"
-        elif doc_type == DocumentType.HTML:
-            content = BytesIO(self._generate_html(html_content).encode("utf-8"))
-            file_extension = "html"
-        else:
-            raise ValueError(f"Unexpected document type: {document_type}")
-
-        file_name = self._validate_file_name(file_name)
-        file_path = os.path.join(OUTPUT_DIR, f"{file_name}.{file_extension}")
-
-        self._write_to_file(content, file_path)
-
-        return (
-            f"{self.file_server_url_prefix}/{OUTPUT_DIR}/{file_name}.{file_extension}"
-        )
-
-    @staticmethod
-    def _write_to_file(content: BytesIO, file_path: str) -> None:
-        """
-        Write the content to a file.
-        """
-        try:
-            os.makedirs(os.path.dirname(file_path), exist_ok=True)
-            with open(file_path, "wb") as file:
-                file.write(content.getvalue())
-        except Exception:
-            raise
-
-    @staticmethod
-    def _validate_file_name(file_name: str) -> str:
-        """
-        Validate the file name.
-        """
-        # Don't allow directory traversal
-        if os.path.isabs(file_name):
-            raise ValueError("File name is not allowed.")
-        # Don't allow special characters
-        if re.match(r"^[a-zA-Z0-9_.-]+$", file_name):
-            return file_name
-        else:
-            raise ValueError("File name is not allowed to contain special characters.")
-
-    @classmethod
-    def _validate_packages(cls) -> None:
-        try:
-            import markdown  # noqa: F401
-            import xhtml2pdf  # noqa: F401
-        except ImportError:
-            raise ImportError(
-                "Failed to import required modules. Please install markdown and xhtml2pdf "
-                "using `pip install markdown xhtml2pdf`"
-            )
-
-    def to_tool(self) -> FunctionTool:
-        self._validate_packages()
-        return FunctionTool.from_defaults(self.generate_document)

llama-index-server/llama_index/server/tools/index/__init__.py

@@ -1,3 +0,0 @@
-from .query import get_query_engine_tool
-
-__all__ = ["get_query_engine_tool"]

llama-index-server/llama_index/server/tools/index/query.py

@@ -1,49 +0,0 @@
-import os
-from typing import Any, Optional
-
-from llama_index.core.base.base_query_engine import BaseQueryEngine
-from llama_index.core.tools.query_engine import QueryEngineTool
-from llama_index.core.indices.base import BaseIndex
-
-
-def create_query_engine(index: BaseIndex, **kwargs: Any) -> BaseQueryEngine:
-    """
-    Create a query engine for the given index.
-
-    Args:
-        index: The index to create a query engine for.
-        params (optional): Additional parameters for the query engine, e.g: similarity_top_k
-    """
-    top_k = int(os.getenv("TOP_K", 0))
-    if top_k != 0 and kwargs.get("filters") is None:
-        kwargs["similarity_top_k"] = top_k
-
-    return index.as_query_engine(**kwargs)
-
-
-def get_query_engine_tool(
-    index: BaseIndex,
-    name: Optional[str] = None,
-    description: Optional[str] = None,
-    **kwargs: Any,
-) -> QueryEngineTool:
-    """
-    Get a query engine tool for the given index.
-
-    Args:
-        index: The index to create a query engine for.
-        name (optional): The name of the tool.
-        description (optional): The description of the tool.
-    """
-    if name is None:
-        name = "query_index"
-    if description is None:
-        description = (
-            "Use this tool to retrieve information about the text corpus from an index."
-        )
-    query_engine = create_query_engine(index, **kwargs)
-    return QueryEngineTool.from_defaults(
-        query_engine=query_engine,
-        name=name,
-        description=description,
-    )

llama-index-server/llama_index/server/tools/index/utils.py

@@ -1,13 +0,0 @@
-from datetime import timedelta
-
-from cachetools import TTLCache, cached  # type: ignore
-
-from llama_index.core.storage import StorageContext
-
-
-@cached(
-    TTLCache(maxsize=10, ttl=timedelta(minutes=5).total_seconds()),
-    key=lambda *args, **kwargs: "global_storage_context",
-)
-def get_storage_context(persist_dir: str) -> StorageContext:
-    return StorageContext.from_defaults(persist_dir=persist_dir)

llama-index-server/llama_index/server/tools/interpreter.py

@@ -1,216 +0,0 @@
-import base64
-import logging
-import os
-import uuid
-from typing import Any, List, Optional
-
-from llama_index.core.tools import FunctionTool
-from llama_index.server.services.file import DocumentFile, FileService
-from pydantic import BaseModel
-
-logger = logging.getLogger("uvicorn")
-
-
-class InterpreterExtraResult(BaseModel):
-    type: str
-    content: Optional[str] = None
-    filename: Optional[str] = None
-    url: Optional[str] = None
-
-
-class E2BToolOutput(BaseModel):
-    is_error: bool
-    logs: "Logs"  # type: ignore # noqa: F821
-    error_message: Optional[str] = None
-    results: List[InterpreterExtraResult] = []
-    retry_count: int = 0
-
-
-class E2BCodeInterpreter:
-    output_dir = "output/tools"
-    uploaded_files_dir = "output/uploaded"
-    interpreter: Optional["Sandbox"] = None  # type: ignore # noqa: F821
-
-    def __init__(
-        self,
-        api_key: str,
-        output_dir: Optional[str] = None,
-        uploaded_files_dir: Optional[str] = None,
-    ):
-        """
-        Args:
-            api_key: The API key for the E2B Code Interpreter.
-            output_dir: The directory for the output files. Default is `output/tools`.
-            uploaded_files_dir: The directory for the files to be uploaded to the sandbox. Default is `output/uploaded`.
-        """
-        self._validate_package()
-        if not api_key:
-            raise ValueError(
-                "api_key is required to run code interpreter. Get it here: https://e2b.dev/docs/getting-started/api-key"
-            )
-        self.api_key = api_key
-        self.output_dir = output_dir or "output/tools"
-        self.uploaded_files_dir = uploaded_files_dir or "output/uploaded"
-
-    @classmethod
-    def _validate_package(cls) -> None:
-        try:
-            from e2b_code_interpreter import Sandbox  # noqa: F401
-            from e2b_code_interpreter.models import Logs  # noqa: F401
-        except ImportError:
-            raise ImportError(
-                "e2b_code_interpreter is not installed. Please install it using `pip install e2b-code-interpreter`."
-            )
-
-    def __del__(self) -> None:
-        """
-        Kill the interpreter when the tool is no longer in use.
-        """
-        if self.interpreter is not None:
-            self.interpreter.kill()
-
-    def _init_interpreter(self, sandbox_files: List[str] = []) -> None:
-        """
-        Lazily initialize the interpreter.
-        """
-        from e2b_code_interpreter import Sandbox
-
-        logger.info(f"Initializing interpreter with {len(sandbox_files)} files")
-        self.interpreter = Sandbox(api_key=self.api_key)
-        if len(sandbox_files) > 0:
-            for file_path in sandbox_files:
-                file_name = os.path.basename(file_path)
-                local_file_path = os.path.join(self.uploaded_files_dir, file_name)
-                with open(local_file_path, "rb") as f:
-                    content = f.read()
-                    if self.interpreter and self.interpreter.files:
-                        self.interpreter.files.write(file_path, content)
-            logger.info(f"Uploaded {len(sandbox_files)} files to sandbox")
-
-    def _save_to_disk(self, base64_data: str, ext: str) -> DocumentFile:
-        buffer = base64.b64decode(base64_data)
-
-        # Output from e2b doesn't have a name. Create a random name for it.
-        filename = f"e2b_file_{uuid.uuid4()}.{ext}"
-
-        return FileService.save_file(
-            buffer, file_name=filename, save_dir=self.output_dir
-        )
-
-    def _parse_result(self, result: Any) -> List[InterpreterExtraResult]:
-        """
-        The result could include multiple formats (e.g. png, svg, etc.) but encoded in base64
-        We save each result to disk and return saved file metadata (extension, filename, url).
-        """
-        if not result:
-            return []
-
-        output = []
-
-        try:
-            formats = result.formats()
-            results = [result[format] for format in formats]
-
-            for ext, data in zip(formats, results):
-                if ext in ["png", "svg", "jpeg", "pdf"]:
-                    document_file = self._save_to_disk(data, ext)
-                    output.append(
-                        InterpreterExtraResult(
-                            type=ext,
-                            filename=document_file.name,
-                            url=document_file.url,
-                        )
-                    )
-                else:
-                    # Try serialize data to string
-                    try:
-                        data = str(data)
-                    except Exception as e:
-                        data = f"Error when serializing data: {e}"
-                    output.append(
-                        InterpreterExtraResult(
-                            type=ext,
-                            content=data,
-                        )
-                    )
-        except Exception as error:
-            logger.exception(error, exc_info=True)
-            logger.error("Error when parsing output from E2b interpreter tool", error)
-
-        return output
-
-    def interpret(
-        self,
-        code: str,
-        sandbox_files: List[str] = [],
-        retry_count: int = 0,
-    ) -> E2BToolOutput:
-        """
-        Execute Python code in a Jupyter notebook cell. The tool will return the result, stdout, stderr, display_data, and error.
-        If the code needs to use a file, ALWAYS pass the file path in the sandbox_files argument.
-        You have a maximum of 3 retries to get the code to run successfully.
-
-        Parameters:
-            code (str): The Python code to be executed in a single cell.
-            sandbox_files (List[str]): List of local file paths to be used by the code. The tool will throw an error if a file is not found.
-            retry_count (int): Number of times the tool has been retried.
-        """
-        from e2b_code_interpreter.models import Logs
-
-        if retry_count > 2:
-            return E2BToolOutput(
-                is_error=True,
-                logs=Logs(
-                    stdout="",
-                    stderr="",
-                    display_data="",
-                    error="",
-                ),
-                error_message="Failed to execute the code after 3 retries. Explain the error to the user and suggest a fix.",
-                retry_count=retry_count,
-            )
-
-        if self.interpreter is None:
-            self._init_interpreter(sandbox_files)
-
-        if self.interpreter:
-            logger.info(
-                f"\n{'=' * 50}\n> Running following AI-generated code:\n{code}\n{'=' * 50}"
-            )
-            exec = self.interpreter.run_code(code)
-
-            if exec.error:
-                error_message = f"The code failed to execute successfully. Error: {exec.error}. Try to fix the code and run again."
-                logger.error(error_message)
-                # Calling the generated code caused an error. Kill the interpreter and return the error to the LLM so it can try to fix the error
-                try:
-                    self.interpreter.kill()  # type: ignore
-                except Exception:
-                    pass
-                finally:
-                    self.interpreter = None
-                output = E2BToolOutput(
-                    is_error=True,
-                    logs=exec.logs,
-                    results=[],
-                    error_message=error_message,
-                    retry_count=retry_count + 1,
-                )
-            else:
-                if len(exec.results) == 0:
-                    output = E2BToolOutput(is_error=False, logs=exec.logs, results=[])
-                else:
-                    results = self._parse_result(exec.results[0])
-                    output = E2BToolOutput(
-                        is_error=False,
-                        logs=exec.logs,
-                        results=results,
-                        retry_count=retry_count + 1,
-                    )
-            return output
-        else:
-            raise ValueError("Interpreter is not initialized.")
-
-    def to_tool(self) -> FunctionTool:
-        self._validate_package()
-        return FunctionTool.from_defaults(self.interpret)

llama-index-server/llama_index/server/utils/agent_tool.py

@@ -1,253 +0,0 @@
-import logging
-import uuid
-from abc import ABC, abstractmethod
-from typing import Any, AsyncGenerator, Optional
-
-from pydantic import BaseModel, ConfigDict
-
-from llama_index.core.base.llms.types import ChatMessage, ChatResponse
-from llama_index.core.llms.function_calling import FunctionCallingLLM
-from llama_index.core.tools import (
-    BaseTool,
-    FunctionTool,
-    ToolOutput,
-    ToolSelection,
-)
-from llama_index.core.workflow import Context
-from llama_index.server.api.models import AgentRunEvent, AgentRunEventType
-from llama_index.core.agent.workflow.workflow_events import ToolCall, ToolCallResult
-
-logger = logging.getLogger("uvicorn")
-
-
-class ToolCallOutput(BaseModel):
-    tool_call_id: str
-    tool_output: ToolOutput
-
-
-class ContextAwareTool(FunctionTool, ABC):
-    @abstractmethod
-    async def acall(self, ctx: Context, input: Any) -> ToolOutput:  # type: ignore
-        pass
-
-
-class ChatWithToolsResponse(BaseModel):
-    """
-    A tool call response from chat_with_tools.
-    """
-
-    tool_calls: Optional[list[ToolSelection]]
-    tool_call_message: Optional[ChatMessage]
-    generator: Optional[AsyncGenerator[ChatResponse | None, None]]
-
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
-    def is_calling_different_tools(self) -> bool:
-        tool_names = {tool_call.tool_name for tool_call in self.tool_calls or []}
-        return len(tool_names) > 1
-
-    def has_tool_calls(self) -> bool:
-        return self.tool_calls is not None and len(self.tool_calls) > 0
-
-    def tool_name(self) -> str:
-        if not self.has_tool_calls():
-            raise ValueError("No tool calls")
-        if self.is_calling_different_tools():
-            raise ValueError("Calling different tools")
-        return self.tool_calls[0].tool_name  # type: ignore
-
-    async def full_response(self) -> str:
-        assert self.generator is not None
-        full_response = ""
-        async for chunk in self.generator:
-            content = chunk.delta  # type: ignore
-            if content:
-                full_response += content
-        return full_response
-
-
-async def chat_with_tools(  # type: ignore
-    llm: FunctionCallingLLM,
-    tools: list[BaseTool],
-    chat_history: list[ChatMessage],
-) -> ChatWithToolsResponse:
-    """
-    Request LLM to call tools or not.
-    This function doesn't change the memory.
-    """
-    generator = _tool_call_generator(llm, tools, chat_history)
-    is_tool_call = await generator.__anext__()
-    if is_tool_call:
-        # Last chunk is the full response
-        # Wait for the last chunk
-        full_response = None
-        async for chunk in generator:
-            full_response = chunk
-        assert isinstance(full_response, ChatResponse)
-        return ChatWithToolsResponse(
-            tool_calls=llm.get_tool_calls_from_response(full_response),
-            tool_call_message=full_response.message,
-            generator=None,
-        )
-    else:
-        return ChatWithToolsResponse(
-            tool_calls=None,
-            tool_call_message=None,
-            generator=generator,  # type: ignore
-        )
-
-
-async def call_tools(
-    ctx: Context,
-    agent_name: str,
-    tools: list[BaseTool],
-    tool_calls: list[ToolSelection],
-    emit_agent_events: bool = True,
-) -> list[ToolCallOutput]:
-    """
-    Call tools and return the tool call responses.
-    """
-    if len(tool_calls) == 0:
-        return []
-    tools_by_name = {tool.metadata.get_name(): tool for tool in tools}
-    if len(tool_calls) == 1:
-        if emit_agent_events:
-            ctx.write_event_to_stream(
-                AgentRunEvent(
-                    name=agent_name,
-                    msg=f"{tool_calls[0].tool_name}: {tool_calls[0].tool_kwargs}",
-                )
-            )
-        return [
-            await call_tool(ctx, tools_by_name[tool_calls[0].tool_name], tool_calls[0])
-        ]
-    # Multiple tool calls, show progress
-    tool_call_outputs: list[ToolCallOutput] = []
-
-    progress_id = str(uuid.uuid4())
-    total_steps = len(tool_calls)
-    if emit_agent_events:
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name=agent_name,
-                msg=f"Making {total_steps} tool calls",
-            )
-        )
-    for i, tool_call in enumerate(tool_calls):
-        tool = tools_by_name.get(tool_call.tool_name)
-        if not tool:
-            tool_call_outputs.append(
-                ToolCallOutput(
-                    tool_call_id=tool_call.tool_id,
-                    tool_output=ToolOutput(
-                        is_error=True,
-                        content=f"Tool {tool_call.tool_name} does not exist",
-                        tool_name=tool_call.tool_name,
-                        raw_input=tool_call.tool_kwargs,
-                        raw_output={
-                            "error": f"Tool {tool_call.tool_name} does not exist",
-                        },
-                    ),
-                )
-            )
-            continue
-
-        tool_call_output = await call_tool(
-            ctx,
-            tool,
-            tool_call,
-        )
-        if emit_agent_events:
-            ctx.write_event_to_stream(
-                AgentRunEvent(
-                    name=agent_name,
-                    msg=f"{tool_call.tool_name}: {tool_call.tool_kwargs}",
-                    event_type=AgentRunEventType.PROGRESS,
-                    data={
-                        "id": progress_id,
-                        "total": total_steps,
-                        "current": i,
-                    },
-                )
-            )
-        tool_call_outputs.append(tool_call_output)
-    return tool_call_outputs
-
-
-async def call_tool(
-    ctx: Context,
-    tool: BaseTool,
-    tool_call: ToolSelection,
-) -> ToolCallOutput:
-    ctx.write_event_to_stream(
-        ToolCall(
-            tool_name=tool_call.tool_name,
-            tool_id=tool_call.tool_id,
-            tool_kwargs=tool_call.tool_kwargs,
-        )
-    )
-    try:
-        if isinstance(tool, ContextAwareTool):
-            if ctx is None:
-                raise ValueError("Context is required for context aware tool")
-            # inject context for calling an context aware tool
-            output = await tool.acall(ctx=ctx, **tool_call.tool_kwargs)
-        else:
-            output = await tool.acall(**tool_call.tool_kwargs)  # type: ignore
-    except Exception as e:
-        logger.error(f"Got error in tool {tool_call.tool_name}: {e!s}")
-        output = ToolOutput(
-            is_error=True,
-            content=f"Error: {e!s}",
-            tool_name=tool.metadata.get_name(),
-            raw_input=tool_call.tool_kwargs,
-            raw_output={
-                "error": str(e),
-            },
-        )
-    ctx.write_event_to_stream(
-        ToolCallResult(
-            tool_name=tool_call.tool_name,
-            tool_kwargs=tool_call.tool_kwargs,
-            tool_id=tool_call.tool_id,
-            tool_output=output,
-            return_direct=False,
-        )
-    )
-    return ToolCallOutput(
-        tool_call_id=tool_call.tool_id,
-        tool_output=output,
-    )
-
-
-async def _tool_call_generator(
-    llm: FunctionCallingLLM,
-    tools: list[BaseTool],
-    chat_history: list[ChatMessage],
-) -> AsyncGenerator[ChatResponse | bool, None]:
-    response_stream = await llm.astream_chat_with_tools(
-        tools,
-        chat_history=chat_history,
-        allow_parallel_tool_calls=False,
-    )
-
-    full_response = None
-    yielded_indicator = False
-    async for chunk in response_stream:
-        if "tool_calls" not in chunk.message.additional_kwargs:
-            # Yield a boolean to indicate whether the response is a tool call
-            if not yielded_indicator:
-                yield False
-                yielded_indicator = True
-
-            # if not a tool call, yield the chunks!
-            yield chunk  # type: ignore
-        elif not yielded_indicator:
-            # Yield the indicator for a tool call
-            yield True
-            yielded_indicator = True
-
-        full_response = chunk
-
-    if full_response:
-        yield full_response  # type: ignore

llama-index-server/pyproject.toml

@@ -1,65 +0,0 @@
-[build-system]
-build-backend = "poetry.core.masonry.api"
-requires = ["poetry-core"]
-
-[tool.codespell]
-check-filenames = true
-check-hidden = true
-# Feel free to un-skip examples, and experimental, you will just need to
-# work through many typos (--write-changes and --interactive will help)
-skip = "*.csv,*.html,*.json,*.jsonl,*.pdf,*.txt,*.ipynb"
-
-[tool.mypy]
-disallow_untyped_defs = true
-# Remove venv skip when integrated with pre-commit
-exclude = ["_static", "build", "examples", "notebooks", "venv"]
-ignore_missing_imports = true
-namespace_packages = true
-explicit_package_bases = true
-python_version = "3.10"
-
-[tool.poetry]
-authors = ["Your Name <you@example.com>"]
-description = "llama-index fastapi server"
-exclude = ["**/BUILD"]
-license = "MIT"
-name = "llama-index-server"
-packages = [{include = "llama_index/"}]
-readme = "README.md"
-version = "0.1.14"
-
-[tool.poetry.dependencies]
-python = ">=3.9,<4.0"
-fastapi = {extras = ["standard"], version = "^0.115.11"}
-cachetools = "^5.5.2"
-requests = "^2.32.3"
-pydantic-settings = "^2.8.1"
-llama-index-core = "^0.12.28"
-llama-index-readers-file = "^0.4.6"
-llama-index-indices-managed-llama-cloud = "0.6.3"
-
-[tool.poetry.group.dev.dependencies]
-black = {extras = ["jupyter"], version = "<=23.9.1,>=23.7.0"}
-codespell = {extras = ["toml"], version = ">=v2.2.6"}
-e2b-code-interpreter = "^1.1.1"
-ipython = "8.10.0"
-jupyter = "^1.0.0"
-markdown = "^3.7"
-mypy = "1.15.0"
-pre-commit = "3.2.0"
-pylint = "2.15.10"
-pytest = "^8.3.5"
-pytest-asyncio = "^0.25.3"
-pytest-mock = "3.11.1"
-ruff = "0.0.292"
-tree-sitter-languages = "^1.8.0"
-types-Deprecated = ">=0.1.0"
-types-PyYAML = "^6.0.12.12"
-types-protobuf = "^4.24.0.4"
-types-redis = "4.5.5.0"
-types-requests = "2.28.11.8"  # TODO: unpin when mypy>0.991
-types-setuptools = "67.1.0.0"
-xhtml2pdf = "^0.2.17"
-pytest-cov = "^6.0.0"
-llama-cloud = "^0.1.17"
-

llama-index-server/tests/api/test_chat_api.py

@@ -1,149 +0,0 @@
-import logging
-from unittest.mock import AsyncMock, MagicMock
-
-import pytest
-from fastapi import FastAPI
-from httpx import ASGITransport, AsyncClient
-
-from llama_index.core.workflow import StopEvent, Workflow
-from llama_index.core.workflow.handler import WorkflowHandler
-from llama_index.server.api.models import ChatAPIMessage, ChatRequest
-from llama_index.server.api.routers.chat import chat_router
-
-
-@pytest.fixture()
-def logger():
-    return logging.getLogger("test")
-
-
-@pytest.fixture()
-def chat_request():
-    """Create a simple chat request with one user message."""
-    return ChatRequest(
-        messages=[ChatAPIMessage(role="user", content="Hello, how are you?")]
-    )
-
-
-@pytest.fixture()
-def mock_workflow():
-    """Create a mock workflow that returns a simple response."""
-    workflow = MagicMock(spec=Workflow)
-    handler = AsyncMock(spec=WorkflowHandler)
-
-    # Setup the handler to stream a simple response event
-    async def mock_stream_events():
-        yield StopEvent(result="I'm doing well, thank you for asking!")
-
-    handler.stream_events.return_value = mock_stream_events()
-    workflow.run.return_value = handler
-
-    return workflow
-
-
-@pytest.fixture()
-def workflow_factory(mock_workflow):
-    """Create a factory function that returns our mock workflow."""
-
-    def factory(verbose=False):
-        return mock_workflow
-
-    return factory
-
-
-@pytest.mark.asyncio()
-async def test_chat_router(chat_request, workflow_factory, logger):
-    """Test that the chat router handles a request correctly."""
-    # Create a FastAPI app and mount our router
-    app = FastAPI()
-    router = chat_router(workflow_factory, logger)
-    app.include_router(router)
-
-    # Make a request to the chat endpoint
-    async with AsyncClient(
-        transport=ASGITransport(app=app), base_url="http://test"
-    ) as client:
-        response = await client.post("/chat", json=chat_request.model_dump())
-
-        # Check response status
-        assert response.status_code == 200
-
-        # For streaming responses we don't check the content-type header directly
-        # Instead, check that we get the expected content in the response body
-
-        # The response is a stream, so we need to collect the chunks
-        content = response.content.decode()
-
-        # Verify content structure follows expected format
-        assert "0:" in content  # Text prefix for VercelStreamResponse
-        # Verify if the response contains the expected message
-        assert "I'm doing well" in content
-
-        # Verify the mock workflow was called correctly
-        mock_workflow = workflow_factory()
-        mock_workflow.run.assert_called_once()
-
-        # Verify the workflow was called with the correct arguments
-        call_args = mock_workflow.run.call_args[1]
-        assert call_args["user_msg"] == "Hello, how are you?"
-        assert isinstance(call_args["chat_history"], list)
-        assert len(call_args["chat_history"]) == 0  # No history for first message
-
-
-@pytest.mark.asyncio()
-async def test_chat_with_agent_workflow(logger):
-    """Test that the chat router works with a workflow that mimics an agent workflow."""
-    # Create a simple workflow that mimics an agent workflow
-    mock_workflow = MagicMock(spec=Workflow)
-    handler = AsyncMock(spec=WorkflowHandler)
-
-    # Setup the handler to stream a simple response about weather
-    async def mock_stream_events():
-        yield StopEvent(
-            result="The weather in New York is sunny. I used the weather tool to get this information."
-        )
-
-    handler.stream_events.return_value = mock_stream_events()
-    mock_workflow.run.return_value = handler
-
-    # Create a factory function that returns our mock workflow
-    def workflow_factory(verbose=False):
-        return mock_workflow
-
-    # Create a FastAPI app and mount our router
-    app = FastAPI()
-    router = chat_router(workflow_factory, logger)
-    app.include_router(router)
-
-    # Create a chat request asking about weather
-    chat_request = ChatRequest(
-        messages=[
-            ChatAPIMessage(role="user", content="What's the weather in New York?")
-        ]
-    )
-
-    # Make a request to the chat endpoint
-    async with AsyncClient(
-        transport=ASGITransport(app=app), base_url="http://test"
-    ) as client:
-        response = await client.post("/chat", json=chat_request.model_dump())
-
-        # Check response status
-        assert response.status_code == 200
-
-        # The response is a stream, so we need to collect the chunks
-        content = response.content.decode()
-
-        # Verify content structure follows expected format
-        assert "0:" in content  # Text prefix for VercelStreamResponse
-
-        # Verify the response content contains expected keywords
-        assert "weather" in content and "New York" in content and "sunny" in content
-
-        # Verify the mock workflow was called correctly
-        mock_workflow.run.assert_called_once()
-
-        # Verify the workflow was called with the correct arguments
-        call_args = mock_workflow.run.call_args[1]
-        assert call_args["user_msg"] == "What's the weather in New York?"
-        assert isinstance(call_args["chat_history"], list)
-        assert len(call_args["chat_history"]) == 0  # No history for first message

llama-index-server/tests/api/test_event_stream.py

@@ -1,249 +0,0 @@
-import asyncio
-import logging
-from unittest.mock import AsyncMock, MagicMock
-
-import pytest
-
-from llama_index.core.agent.workflow.workflow_events import AgentStream
-from llama_index.core.workflow import StopEvent
-from llama_index.core.workflow.handler import WorkflowHandler
-from llama_index.server.api.models import ChatAPIMessage, ChatRequest
-from llama_index.server.api.routers.chat import _stream_content
-from llama_index.server.api.utils.vercel_stream import VercelStreamResponse
-
-
-@pytest.fixture()
-def logger():
-    return logging.getLogger("test")
-
-
-@pytest.fixture()
-def chat_request():
-    return ChatRequest(messages=[ChatAPIMessage(role="user", content="test message")])
-
-
-@pytest.fixture()
-def mock_workflow_handler():
-    handler = AsyncMock(spec=WorkflowHandler)
-    handler.accumulate_text = MagicMock()
-    return handler
-
-
-class TestEventStream:
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_agent_stream(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.return_value = (
-            self._mock_agent_stream_events()
-        )
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 3  # Empty start + 2 text chunks
-        assert result[0] == VercelStreamResponse.convert_text("")
-        assert result[1] == VercelStreamResponse.convert_text("Hello")
-        assert result[2] == VercelStreamResponse.convert_text(" World")
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_stop_event_string(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.return_value = (
-            self._mock_stop_event_string()
-        )
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 2  # Empty start + result string
-        assert result[0] == VercelStreamResponse.convert_text("")
-        assert result[1] == VercelStreamResponse.convert_text("Final answer")
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_stop_event_delta_objects(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.return_value = (
-            self._mock_stop_event_delta_objects()
-        )
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 3  # Empty start + 2 delta chunks
-        assert result[0] == VercelStreamResponse.convert_text("")
-        assert result[1] == VercelStreamResponse.convert_text("Delta 1")
-        assert result[2] == VercelStreamResponse.convert_text("Delta 2")
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_event_with_to_response(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.return_value = (
-            self._mock_event_with_to_response()
-        )
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 2  # Empty start + event with to_response
-        assert result[0] == VercelStreamResponse.convert_text("")
-        assert result[1] == VercelStreamResponse.convert_data({"event_type": "test"})
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_event_with_model_dump(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.return_value = (
-            self._mock_event_with_model_dump()
-        )
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 2  # Empty start + event with model_dump
-        assert result[0] == VercelStreamResponse.convert_text("")
-        assert result[1] == VercelStreamResponse.convert_data(None)
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_cancelled_error(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        mock_workflow_handler.stream_events.side_effect = asyncio.CancelledError()
-        logger.warning = MagicMock()
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 0
-        mock_workflow_handler.cancel_run.assert_called_once()
-        logger.warning.assert_called_once()
-
-    @pytest.mark.asyncio()
-    async def test_stream_content_with_exception(
-        self, mock_workflow_handler, chat_request, logger
-    ):
-        # Setup
-        error_message = "Test error"
-        mock_workflow_handler.stream_events.side_effect = Exception(error_message)
-        logger.error = MagicMock()
-
-        # Execute
-        result = [
-            chunk
-            async for chunk in _stream_content(
-                mock_workflow_handler, chat_request, logger
-            )
-        ]
-
-        # Assert
-        assert len(result) == 1
-        assert result[0] == VercelStreamResponse.convert_error(error_message)
-        mock_workflow_handler.cancel_run.assert_called_once()
-        logger.error.assert_called_once()
-
-    async def _mock_agent_stream_events(self):
-        yield AgentStream(
-            delta="Hello", response="", current_agent_name="", tool_calls=[], raw=""
-        )
-        yield AgentStream(
-            delta=" World", response="", current_agent_name="", tool_calls=[], raw=""
-        )
-
-    async def _mock_agent_stream_with_empty_deltas(self):
-        yield AgentStream(
-            delta="   ",  # Empty delta with spaces - should be filtered
-            response="",
-            current_agent_name="",
-            tool_calls=[],
-            raw="",
-        )
-        yield AgentStream(
-            delta="Valid delta",
-            response="",
-            current_agent_name="",
-            tool_calls=[],
-            raw="",
-        )
-        yield AgentStream(
-            delta="\n",  # Newline-only delta - should be filtered
-            response="",
-            current_agent_name="",
-            tool_calls=[],
-            raw="",
-        )
-
-    async def _mock_stop_event_string(self):
-        yield StopEvent(result="Final answer")
-
-    async def _mock_stop_event_delta_objects(self):
-        async def generator():
-            # Create proper objects with delta attribute that can be serialized
-            class ObjectWithDelta:
-                def __init__(self, delta_value) -> None:
-                    self.delta = delta_value
-
-            yield ObjectWithDelta("Delta 1")
-            yield ObjectWithDelta("Delta 2")
-
-        yield StopEvent(result=generator())
-
-    async def _mock_dict_event(self):
-        yield {"key": "value"}
-
-    async def _mock_event_with_to_response(self):
-        event = MagicMock()
-        event.to_response.return_value = {"event_type": "test"}
-        yield event
-
-    async def _mock_event_with_model_dump(self):
-        event = MagicMock()
-        event.model_dump.return_value = {"name": "test_event"}
-        # Override to_response to return None - this means convert_data(None) will be called
-        event.to_response = MagicMock(return_value=None)
-        # The model_dump value is ignored when to_response returns None
-        yield event

llama-index-server/tests/services/test_file_service.py

@@ -1,205 +0,0 @@
-import os
-import uuid
-from unittest.mock import mock_open, patch
-
-import pytest
-from llama_index.server.services.file import FileService, _sanitize_file_name
-
-
-class TestFileService:
-    def test_sanitize_file_name(self):
-        # Test with normal alphanumeric name
-        assert _sanitize_file_name("test123") == "test123"
-
-        # Test with spaces
-        assert _sanitize_file_name("test file") == "test_file"
-
-        # Test with special characters
-        assert _sanitize_file_name("test@file!name") == "test_file_name"
-
-        # Test with path-like characters
-        assert _sanitize_file_name("test/file/name") == "test_file_name"
-
-        # Test with dots (should be preserved)
-        assert _sanitize_file_name("test.file.name") == "test.file.name"
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open", new_callable=mock_open)
-    @patch("os.makedirs")
-    def test_save_file_string_content(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_getsize.return_value = 11  # Length of "Hello World"
-
-        # Execute
-        result = FileService.save_file(
-            content="Hello World", file_name="test.txt", save_dir="test_dir"
-        )
-
-        # Assert
-        expected_path = os.path.join("test_dir", f"test_{test_uuid}.txt")
-        mock_makedirs.assert_called_once_with(
-            os.path.dirname(expected_path), exist_ok=True
-        )
-        mock_file_open.assert_called_once_with(expected_path, "wb")
-        mock_file_open().write.assert_called_once_with(b"Hello World")
-
-        assert result.id == test_uuid
-        assert result.name == f"test_{test_uuid}.txt"
-        assert result.type == "txt"
-        assert result.size == 11
-        assert result.path == expected_path
-        assert result.url.endswith(expected_path.replace(os.path.sep, "/"))
-        assert result.refs is None
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open", new_callable=mock_open)
-    @patch("os.makedirs")
-    def test_save_file_bytes_content(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_getsize.return_value = 11  # Length of "Hello World"
-
-        # Execute
-        result = FileService.save_file(
-            content=b"Hello World", file_name="test.txt", save_dir="test_dir"
-        )
-
-        # Assert
-        expected_path = os.path.join("test_dir", f"test_{test_uuid}.txt")
-        mock_makedirs.assert_called_once_with(
-            os.path.dirname(expected_path), exist_ok=True
-        )
-        mock_file_open.assert_called_once_with(expected_path, "wb")
-        mock_file_open().write.assert_called_once_with(b"Hello World")
-        assert result.path == expected_path
-        assert result.type == "txt"
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open", new_callable=mock_open)
-    @patch("os.makedirs")
-    def test_save_file_with_special_characters(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_getsize.return_value = 11
-
-        # Execute
-        result = FileService.save_file(
-            content="Hello World", file_name="test@file!.txt", save_dir="test_dir"
-        )
-
-        # Assert
-        expected_path = os.path.join("test_dir", f"test_file__{test_uuid}.txt")
-        mock_makedirs.assert_called_once_with(
-            os.path.dirname(expected_path), exist_ok=True
-        )
-        mock_file_open.assert_called_once_with(expected_path, "wb")
-        assert result.path == expected_path
-        assert result.name == f"test_file__{test_uuid}.txt"
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open", new_callable=mock_open)
-    @patch("os.makedirs")
-    def test_save_file_default_directory(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_getsize.return_value = 11
-
-        # Execute
-        result = FileService.save_file(content="Hello World", file_name="test.txt")
-
-        # Assert
-        expected_path = os.path.join("output", "uploaded", f"test_{test_uuid}.txt")
-        mock_makedirs.assert_called_once_with(
-            os.path.dirname(expected_path), exist_ok=True
-        )
-        assert result.path == expected_path
-
-    @patch("uuid.uuid4")
-    @patch("os.getenv")
-    @patch("os.path.getsize")
-    @patch("builtins.open", new_callable=mock_open)
-    @patch("os.makedirs")
-    def test_save_file_custom_url_prefix(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_getenv, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_getsize.return_value = 11
-        mock_getenv.return_value = "/api/files"
-
-        # Execute
-        result = FileService.save_file(
-            content="Hello World", file_name="test.txt", save_dir="test_dir"
-        )
-
-        # Assert
-        expected_path = os.path.join("test_dir", f"test_{test_uuid}.txt")
-        mock_makedirs.assert_called_once_with(
-            os.path.dirname(expected_path), exist_ok=True
-        )
-        mock_file_open.assert_called_once_with(expected_path, "wb")
-        assert result.path == expected_path
-        # URL paths must use forward slashes, even on Windows
-        expected_url = f"/api/files/test_dir/test_{test_uuid}.txt"
-        assert result.url == expected_url
-
-    def test_save_file_no_extension(self):
-        # Test that saving a file without extension raises ValueError
-        with pytest.raises(ValueError, match="File is not supported!"):
-            FileService.save_file(
-                content="Hello World", file_name="test", save_dir="test_dir"
-            )
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open")
-    @patch("os.makedirs")
-    def test_save_file_permission_error(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_file_open.side_effect = PermissionError("Permission denied")
-
-        # Execute and Assert
-        with pytest.raises(PermissionError):
-            FileService.save_file(
-                content="Hello World", file_name="test.txt", save_dir="test_dir"
-            )
-
-    @patch("uuid.uuid4")
-    @patch("os.path.getsize")
-    @patch("builtins.open")
-    @patch("os.makedirs")
-    def test_save_file_io_error(
-        self, mock_makedirs, mock_file_open, mock_getsize, mock_uuid
-    ):
-        # Setup
-        test_uuid = "12345678-1234-5678-1234-567812345678"
-        mock_uuid.return_value = uuid.UUID(test_uuid)
-        mock_file_open.side_effect = OSError("IO Error")
-
-        # Execute and Assert
-        with pytest.raises(IOError):
-            FileService.save_file(
-                content="Hello World", file_name="test.txt", save_dir="test_dir"
-            )

llama-index-server/tests/test_llamaindex_server.py

@@ -1,298 +0,0 @@
-import json
-import os
-import shutil
-
-import pytest
-from httpx import ASGITransport, AsyncClient
-from llama_index.core.agent.workflow import AgentWorkflow
-from llama_index.core.llms import MockLLM
-from llama_index.server import LlamaIndexServer, UIConfig
-
-
-def fetch_weather(city: str) -> str:
-    """Fetch the weather for a given city."""
-    return f"The weather in {city} is sunny."
-
-
-def _agent_workflow() -> AgentWorkflow:
-    # Use MockLLM instead of default OpenAI
-    mock_llm = MockLLM()
-    return AgentWorkflow.from_tools_or_functions(
-        tools_or_functions=[fetch_weather],
-        verbose=True,
-        llm=mock_llm,
-    )
-
-
-@pytest.fixture()
-def server() -> LlamaIndexServer:
-    """Fixture to create a LlamaIndexServer instance."""
-    return LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        use_default_routers=True,
-        mount_ui=False,
-        env="dev",
-    )
-
-
-@pytest.mark.asyncio()
-async def test_server_has_chat_route(server: LlamaIndexServer) -> None:
-    """Test that the server has the chat API route."""
-    chat_route_exists = any("/api/chat" in str(route) for route in server.routes)
-    assert chat_route_exists, "Chat API route not found in server routes"
-
-
-@pytest.mark.asyncio()
-async def test_server_swagger_docs(server: LlamaIndexServer) -> None:
-    """Test that the server serves Swagger UI docs."""
-    async with AsyncClient(
-        transport=ASGITransport(app=server), base_url="http://test"
-    ) as ac:
-        response = await ac.get("/docs")
-        assert response.status_code == 200
-        assert "text/html" in response.headers["content-type"]
-        assert "Swagger UI" in response.text
-
-
-@pytest.mark.asyncio()
-async def test_ui_is_downloaded(server: LlamaIndexServer) -> None:
-    """
-    Test if the UI is downloaded and mounted correctly.
-    """
-    # Clean up any existing static directory first
-    if os.path.exists(".ui"):
-        shutil.rmtree(".ui")
-
-    # Create a new server with UI enabled
-    ui_config = UIConfig(
-        enabled=True,
-        app_title="Test UI",
-        starter_questions=["What's the weather like?"],
-    )
-    ui_server = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        use_default_routers=True,
-        env="dev",
-        ui_config=ui_config,
-    )
-
-    # Verify that static directory was created with index.html
-    assert os.path.exists("./.ui"), "Static directory was not created"
-    assert os.path.isdir("./.ui"), "Static path is not a directory"
-    assert os.path.exists("./.ui/index.html"), "index.html was not downloaded"
-
-    # Check if the config.js was created with correct content
-    config_path = os.path.join(".ui", "config.js")
-    assert os.path.exists(config_path), "config.js was not created"
-
-    with open(config_path, "r") as f:
-        config_content = f.read()
-        assert "window.LLAMAINDEX =" in config_content
-        config_json = json.loads(
-            config_content.replace("window.LLAMAINDEX = ", "").rstrip(";")
-        )
-        assert config_json["CHAT_API"] == "/api/chat"
-        assert config_json["STARTER_QUESTIONS"] == ["What's the weather like?"]
-        assert config_json["LLAMA_CLOUD_API"] is None
-        assert config_json["APP_TITLE"] == "Test UI"
-
-    # Check if the UI is mounted and accessible
-    async with AsyncClient(
-        transport=ASGITransport(app=ui_server), base_url="http://test"
-    ) as ac:
-        response = await ac.get("/")
-        assert response.status_code == 200
-        assert "text/html" in response.headers["content-type"]
-
-    # Clean up after test
-    shutil.rmtree("./.ui")
-
-
-@pytest.mark.asyncio()
-async def test_ui_is_accessible(server: LlamaIndexServer) -> None:
-    """
-    Test if the UI is accessible.
-    """
-    # Manually trigger UI mounting
-    server.mount_ui()
-
-    async with AsyncClient(
-        transport=ASGITransport(app=server), base_url="http://test"
-    ) as ac:
-        response = await ac.get("/")
-        assert response.status_code == 200
-        assert "text/html" in response.headers["content-type"]
-
-
-@pytest.mark.asyncio()
-async def test_ui_config_customization() -> None:
-    """
-    Test if UI configuration can be customized.
-    """
-    custom_config = UIConfig(
-        enabled=True,
-        app_title="Custom App",
-        starter_questions=["Question 1", "Question 2"],
-        ui_path=".custom_ui",
-    )
-
-    server = LlamaIndexServer(
-        workflow_factory=_agent_workflow, verbose=True, ui_config=custom_config
-    )
-
-    assert server.ui_config.app_title == "Custom App"
-    assert server.ui_config.starter_questions == ["Question 1", "Question 2"]
-    assert server.ui_config.ui_path == ".custom_ui"
-
-    # Clean up if directory was created
-    if os.path.exists(".custom_ui"):
-        shutil.rmtree(".custom_ui")
-
-
-@pytest.mark.asyncio()
-async def test_ui_config_from_dict() -> None:
-    """
-    Test if UI configuration can be initialized from a dictionary.
-    """
-    ui_config_dict = {
-        "enabled": True,
-        "app_title": "Dict Config App",
-        "starter_questions": ["Dict Q1", "Dict Q2"],
-        "ui_path": ".dict_ui",
-    }
-
-    server = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        ui_config=ui_config_dict,
-    )
-
-    # Verify the config was properly converted to UIConfig object
-    assert isinstance(server.ui_config, UIConfig)
-    assert server.ui_config.app_title == "Dict Config App"
-    assert server.ui_config.starter_questions == ["Dict Q1", "Dict Q2"]
-    assert server.ui_config.ui_path == ".dict_ui"
-
-    # Verify the config.js is created with correct content
-    server.mount_ui()
-    config_path = os.path.join(".dict_ui", "config.js")
-    assert os.path.exists(config_path), "config.js was not created"
-
-    with open(config_path, "r") as f:
-        config_content = f.read()
-        assert "window.LLAMAINDEX =" in config_content
-        config_json = json.loads(
-            config_content.replace("window.LLAMAINDEX = ", "").rstrip(";")
-        )
-        assert config_json["APP_TITLE"] == "Dict Config App"
-        assert config_json["STARTER_QUESTIONS"] == ["Dict Q1", "Dict Q2"]
-        assert config_json["CHAT_API"] == "/api/chat"
-        assert config_json["LLAMA_CLOUD_API"] is None
-
-    # Clean up
-    if os.path.exists(".dict_ui"):
-        shutil.rmtree(".dict_ui")
-
-
-async def test_component_dir_creation(server: LlamaIndexServer) -> None:
-    """
-    Test if the component directory is created when specified and doesn't exist.
-    """
-    import os
-    import shutil
-
-    test_component_dir = "./test_components"
-
-    # Clean up any existing directory
-    if os.path.exists(test_component_dir):
-        shutil.rmtree(test_component_dir)
-
-    # Create server with component directory
-    _ = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        ui_config={
-            "component_dir": test_component_dir,
-            "include_ui": True,
-        },
-    )
-
-    # Verify directory was created
-    assert os.path.exists(test_component_dir), "Component directory was not created"
-    assert os.path.isdir(test_component_dir), "Component path is not a directory"
-
-    # Clean up after test
-    shutil.rmtree(test_component_dir)
-
-
-@pytest.mark.asyncio()
-async def test_component_router_addition(server: LlamaIndexServer, tmp_path) -> None:
-    """
-    Test if the component router is added when component directory is specified.
-    """
-    test_component_dir = tmp_path / "test_components"
-
-    # Create server with component directory
-    component_server = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        ui_config={
-            "component_dir": str(test_component_dir),
-            "include_ui": True,
-        },
-    )
-
-    # Verify component route exists
-    component_route_exists = any(
-        route.path == "/api/components" for route in component_server.routes
-    )
-    assert component_route_exists, "Component API route not found in server routes"
-
-
-@pytest.mark.asyncio()
-async def test_ui_config_includes_components_api(
-    server: LlamaIndexServer, tmp_path
-) -> None:
-    """
-    Test if the UI config includes components API when component directory is set.
-    """
-    test_component_dir = tmp_path / "test_components"
-
-    # Create server with component directory
-    component_server = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        ui_config={
-            "component_dir": str(test_component_dir),
-            "include_ui": True,
-        },
-    )
-
-    # Check if components API is in UI config
-    ui_config = component_server.ui_config
-    assert "COMPONENTS_API" in ui_config.get_config_content(), (
-        "Components API not found in UI config"
-    )
-
-
-@pytest.mark.asyncio()
-async def test_component_router_requires_component_dir(
-    server: LlamaIndexServer,
-) -> None:
-    """
-    Test that adding components router without component_dir raises an error.
-    """
-    server_without_component_dir = LlamaIndexServer(
-        workflow_factory=_agent_workflow,
-        verbose=True,
-        ui_config={
-            "include_ui": True,
-        },
-    )
-
-    with pytest.raises(
-        ValueError, match="component_dir must be specified to add components router"
-    ):
-        server_without_component_dir.add_components_router()

llama-index-server/tests/tools/test_document_generator.py

@@ -1,89 +0,0 @@
-from io import BytesIO
-from unittest.mock import MagicMock, patch
-
-import pytest
-from llama_index.server.tools.document_generator import (
-    OUTPUT_DIR,
-    DocumentGenerator,
-)
-
-
-class TestDocumentGenerator:
-    def test_validate_file_name(self) -> None:
-        # Valid names
-        assert (
-            DocumentGenerator("/api/files")._validate_file_name("valid-name")
-            == "valid-name"
-        )
-
-        # Invalid names
-        with pytest.raises(ValueError):
-            DocumentGenerator("/api/files")._validate_file_name("/invalid/path")
-
-    @patch("os.makedirs")
-    @patch("builtins.open")
-    def test_write_to_file(self, mock_open, mock_makedirs):  # type: ignore
-        content = BytesIO(b"test")
-        DocumentGenerator("/api/files")._write_to_file(content, "path/file.txt")
-
-        mock_makedirs.assert_called_once()
-        mock_open.assert_called_once()
-        mock_open.return_value.__enter__.return_value.write.assert_called_once_with(
-            b"test"
-        )
-
-    @patch("markdown.markdown")
-    def test_html_generation(self, mock_markdown):  # type: ignore
-        mock_markdown.return_value = "<h1>Test</h1>"
-
-        # Test HTML content generation
-        assert (
-            DocumentGenerator("/api/files")._generate_html_content("# Test")
-            == "<h1>Test</h1>"
-        )
-
-        # Test full HTML generation
-        html = DocumentGenerator("/api/files")._generate_html("<h1>Test</h1>")
-        assert "<!DOCTYPE html>" in html
-        assert "<h1>Test</h1>" in html
-
-    @patch("xhtml2pdf.pisa.pisaDocument")
-    def test_pdf_generation(self, mock_pisa):  # type: ignore
-        # Success case
-        mock_pisa.return_value = MagicMock(err=None)
-        assert isinstance(
-            DocumentGenerator("/api/files")._generate_pdf("test"), BytesIO
-        )
-
-        # Error case
-        mock_pisa.return_value = MagicMock(err="Error")
-        with pytest.raises(ValueError):
-            DocumentGenerator("/api/files")._generate_pdf("test")
-
-    @patch.multiple(
-        DocumentGenerator,
-        _generate_html_content=MagicMock(return_value="<h1>Test</h1>"),
-        _generate_html=MagicMock(
-            return_value="<html><body><h1>Test</h1></body></html>"
-        ),
-        _generate_pdf=MagicMock(return_value=BytesIO(b"pdf")),
-        _write_to_file=MagicMock(),
-    )
-    def test_generate_document(self):  # type: ignore
-        # HTML generation
-        url = DocumentGenerator("/api/files").generate_document(
-            "# Test", "html", "test-doc"
-        )
-        assert url == f"/api/files/{OUTPUT_DIR}/test-doc.html"
-
-        # PDF generation
-        url = DocumentGenerator("/api/files").generate_document(
-            "# Test", "pdf", "test-doc"
-        )
-        assert url == f"/api/files/{OUTPUT_DIR}/test-doc.pdf"
-
-        # Invalid type
-        with pytest.raises(ValueError):
-            DocumentGenerator("/api/files").generate_document(
-                "# Test", "invalid", "test-doc"
-            )

llama-index-server/tests/tools/test_interpreter.py

@@ -1,65 +0,0 @@
-from unittest.mock import MagicMock
-
-import pytest
-from e2b_code_interpreter.models import Execution, Logs
-from llama_index.server.tools.interpreter import E2BCodeInterpreter
-
-
-class TestE2BCodeInterpreter:
-    @pytest.fixture()
-    def sandbox(self):  # type: ignore
-        """Create a mock Sandbox with no API key requirement."""
-        mock_sandbox = MagicMock()
-        mock_sandbox.files = MagicMock()
-        mock_sandbox.files.write = MagicMock()
-        mock_sandbox.run_code = MagicMock()
-        return mock_sandbox
-
-    @pytest.fixture()
-    def code_interpreter(self, sandbox):  # type: ignore
-        """Create E2BCodeInterpreter that uses the mock Sandbox."""
-        interpreter = E2BCodeInterpreter(api_key="dummy_key")
-        interpreter.interpreter = sandbox
-        return interpreter
-
-    def test_interpret_success(self, code_interpreter, sandbox) -> None:  # type: ignore
-        """Test successful code execution."""
-        # Mock execution result
-        mock_execution = Execution()
-        mock_execution.error = None
-        mock_execution.results = []
-        mock_execution.logs = Logs(
-            stdout="stdout", stderr="", display_data="", error=""
-        )
-        sandbox.run_code.return_value = mock_execution
-
-        # Run the code
-        result = code_interpreter.interpret("print('hello')")
-
-        # Verify
-        sandbox.run_code.assert_called_once_with("print('hello')")
-        assert result.is_error is False
-        assert result.logs == mock_execution.logs
-
-    def test_interpret_error(self, code_interpreter, sandbox) -> None:  # type: ignore
-        """Test error in code execution."""
-        # Mock execution result with error
-        mock_execution = Execution()
-        mock_execution.error = "Test error"
-        mock_execution.logs = Logs(
-            stdout="", stderr="error", display_data="", error="Test error"
-        )
-        sandbox.run_code.return_value = mock_execution
-
-        # Run the code
-        result = code_interpreter.interpret("bad code")
-
-        # Verify
-        assert result.is_error is True
-        assert "Error: Test error" in result.error_message
-        sandbox.kill.assert_called_once()
-
-    def test_to_tool(self, code_interpreter) -> None:  # type: ignore
-        """Test tool conversion."""
-        tool = code_interpreter.to_tool()
-        assert tool.fn == code_interpreter.interpret

package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-llama",
-  "version": "0.5.9",
+  "version": "0.2.19",
   "description": "Create LlamaIndex-powered apps with one command",
   "keywords": [
     "rag",
@@ -43,7 +43,7 @@
     "@types/cross-spawn": "6.0.0",
     "@types/fs-extra": "11.0.4",
     "@types/node": "^20.11.7",
-    "@types/prompts": "2.4.2",
+    "@types/prompts": "2.0.1",
     "@types/tar": "6.1.5",
     "@types/validate-npm-package-name": "3.0.0",
     "async-retry": "1.3.1",

pnpm-lock.yaml

@@ -24,8 +24,8 @@ importers:
         specifier: ^20.11.7
         version: 20.12.10
       '@types/prompts':
-        specifier: 2.4.2
-        version: 2.4.2
+        specifier: 2.0.1
+        version: 2.0.1
       '@types/tar':
         specifier: 6.1.5
         version: 6.1.5
@@ -298,8 +298,8 @@ packages:
   '@types/normalize-package-data@2.4.4':
     resolution: {integrity: sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==}
 
-  '@types/prompts@2.4.2':
-    resolution: {integrity: sha512-TwNx7qsjvRIUv/BCx583tqF5IINEVjCNqg9ofKHRlSoUHE62WBHrem4B1HGXcIrG511v29d1kJ9a/t2Esz7MIg==}
+  '@types/prompts@2.0.1':
+    resolution: {integrity: sha512-AhtMcmETelF8wFDV1ucbChKhLgsc+ytXZXkNz/nnTAMSDeqsjALknEFxi7ZtLgS/G8bV2rp90LhDW5SGACimIQ==}
 
   '@types/responselike@1.0.3':
     resolution: {integrity: sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw==}
@@ -2208,10 +2208,7 @@ snapshots:
 
   '@types/normalize-package-data@2.4.4': {}
 
-  '@types/prompts@2.4.2':
-    dependencies:
-      '@types/node': 20.12.10
-      kleur: 3.0.3
+  '@types/prompts@2.0.1': {}
 
   '@types/responselike@1.0.3':
     dependencies:

questions/datasources.ts

@@ -49,7 +49,7 @@ export const getDataSourceChoices = (
     );
   }
 
-  if (framework === "fastapi" && template !== "reflex") {
+  if (framework === "fastapi" && template !== "extractor") {
     choices.push({
       title: "Use website content (requires Chrome)",
       value: "web",

questions/index.ts

@@ -4,18 +4,15 @@ import { askProQuestions } from "./questions";
 import { askSimpleQuestions } from "./simple";
 import { QuestionArgs, QuestionResults } from "./types";
 
-export const isCI = ciInfo.isCI || process.env.PLAYWRIGHT_TEST === "1";
-
 export const askQuestions = async (
   args: QuestionArgs,
 ): Promise<QuestionResults> => {
-  if (isCI) {
+  if (ciInfo.isCI) {
     return await getCIQuestionResults(args);
   } else if (args.pro) {
     // TODO: refactor pro questions to return a result object
     await askProQuestions(args);
     return args as unknown as QuestionResults;
   }
-  const results = await askSimpleQuestions(args);
-  return results;
+  return await askSimpleQuestions(args);
 };

questions/questions.ts

@@ -1,8 +1,7 @@
-import { blue } from "picocolors";
+import { blue, green } from "picocolors";
 import prompts from "prompts";
-import { isCI } from ".";
 import { COMMUNITY_OWNER, COMMUNITY_REPO } from "../helpers/constant";
-import { EXAMPLE_FILE, EXAMPLE_GDPR } from "../helpers/datasources";
+import { EXAMPLE_FILE } from "../helpers/datasources";
 import { getAvailableLlamapackOptions } from "../helpers/llama-pack";
 import { askModelConfig } from "../helpers/providers";
 import { getProjectOptions } from "../helpers/repo";
@@ -33,7 +32,7 @@ export const askProQuestions = async (program: QuestionArgs) => {
             title: "Multi-agent app (using workflows)",
             value: "multiagent",
           },
-          { title: "Fullstack python template with Reflex", value: "reflex" },
+          { title: "Structured Extractor", value: "extractor" },
           {
             title: `Community template from ${styledRepo}`,
             value: "community",
@@ -89,35 +88,15 @@ export const askProQuestions = async (program: QuestionArgs) => {
       questionHandlers,
     );
     program.llamapack = llamapack;
-    if (!program.postInstallAction) {
-      program.postInstallAction = await askPostInstallAction(program);
-    }
+    program.postInstallAction = await askPostInstallAction(program);
     return; // early return - no further questions needed for llamapack projects
   }
 
-  if (program.template === "reflex") {
-    // Reflex template only supports FastAPI, empty data sources, and llamacloud
+  if (program.template === "extractor") {
+    // Extractor template only supports FastAPI, empty data sources, and llamacloud
     // So we just use example file for extractor template, this allows user to choose vector database later
     program.dataSources = [EXAMPLE_FILE];
     program.framework = "fastapi";
-    // Ask for which Reflex use case to use
-    const { useCase } = await prompts(
-      {
-        type: "select",
-        name: "useCase",
-        message: "Which use case would you like to build?",
-        choices: [
-          { title: "Structured Extractor", value: "extractor" },
-          {
-            title: "Contract review (using Workflow)",
-            value: "contract_review",
-          },
-        ],
-        initial: 0,
-      },
-      questionHandlers,
-    );
-    program.useCase = useCase;
   }
 
   if (!program.framework) {
@@ -141,17 +120,24 @@ export const askProQuestions = async (program: QuestionArgs) => {
   }
 
   if (
-    program.framework === "fastapi" &&
+    (program.framework === "express" || program.framework === "fastapi") &&
     (program.template === "streaming" || program.template === "multiagent")
   ) {
     // if a backend-only framework is selected, ask whether we should create a frontend
     if (program.frontend === undefined) {
       const styledNextJS = blue("NextJS");
+      const styledBackend = green(
+        program.framework === "express"
+          ? "Express "
+          : program.framework === "fastapi"
+            ? "FastAPI (Python) "
+            : "",
+      );
       const { frontend } = await prompts({
         onState: onPromptState,
         type: "toggle",
         name: "frontend",
-        message: `Would you like to generate a ${styledNextJS} frontend for your FastAPI backend?`,
+        message: `Would you like to generate a ${styledNextJS} frontend for your ${styledBackend}backend?`,
         initial: false,
         active: "Yes",
         inactive: "No",
@@ -189,52 +175,6 @@ export const askProQuestions = async (program: QuestionArgs) => {
     program.observability = observability;
   }
 
-  if (
-    (program.template === "reflex" || program.template === "multiagent") &&
-    !program.useCase
-  ) {
-    const choices =
-      program.template === "reflex"
-        ? [
-            { title: "Structured Extractor", value: "extractor" },
-            {
-              title: "Contract review (using Workflow)",
-              value: "contract_review",
-            },
-          ]
-        : [
-            {
-              title: "Financial report (generate a financial report)",
-              value: "financial_report",
-            },
-            {
-              title: "Form filling (fill missing value in a CSV file)",
-              value: "form_filling",
-            },
-            { title: "Blog writer (Write a blog post)", value: "blog" },
-          ];
-
-    const { useCase } = await prompts(
-      {
-        type: "select",
-        name: "useCase",
-        message: "Which use case would you like to use?",
-        choices,
-        initial: 0,
-      },
-      questionHandlers,
-    );
-    program.useCase = useCase;
-  }
-
-  // Configure framework and data sources for Reflex template
-  if (program.template === "reflex") {
-    program.framework = "fastapi";
-
-    program.dataSources =
-      program.useCase === "extractor" ? [EXAMPLE_FILE] : [EXAMPLE_GDPR];
-  }
-
   if (!program.modelConfig) {
     const modelConfig = await askModelConfig({
       openAiKey: program.openAiKey,
@@ -258,8 +198,8 @@ export const askProQuestions = async (program: QuestionArgs) => {
     program.vectorDb = vectorDb;
   }
 
-  if (program.vectorDb === "llamacloud" && program.dataSources.length === 0) {
-    // When using a LlamaCloud index and no data sources are provided, just copy an example file
+  if (program.vectorDb === "llamacloud") {
+    // When using a LlamaCloud index, don't ask for data sources just copy an example file
     program.dataSources = [EXAMPLE_FILE];
   }
 
@@ -390,8 +330,11 @@ export const askProQuestions = async (program: QuestionArgs) => {
     // default to use LlamaParse if using LlamaCloud
     program.useLlamaParse = true;
   } else {
-    // Reflex template doesn't support LlamaParse right now (cannot use asyncio loop in Reflex)
-    if (program.useLlamaParse === undefined && program.template !== "reflex") {
+    // Extractor template doesn't support LlamaParse and LlamaCloud right now (cannot use asyncio loop in Reflex)
+    if (
+      program.useLlamaParse === undefined &&
+      program.template !== "extractor"
+    ) {
       // if already set useLlamaParse, don't ask again
       if (program.dataSources.some((ds) => ds.type === "file")) {
         const { useLlamaParse } = await prompts(
@@ -413,7 +356,7 @@ export const askProQuestions = async (program: QuestionArgs) => {
 
   // Ask for LlamaCloud API key when using a LlamaCloud index or LlamaParse
   if (isUsingLlamaCloud || program.useLlamaParse) {
-    if (!program.llamaCloudKey && !isCI) {
+    if (!program.llamaCloudKey) {
       // if already set, don't ask again
       // Ask for LlamaCloud API key
       const { llamaCloudKey } = await prompts(
@@ -453,7 +396,5 @@ export const askProQuestions = async (program: QuestionArgs) => {
     program.tools = tools;
   }
 
-  if (!program.postInstallAction) {
-    program.postInstallAction = await askPostInstallAction(program);
-  }
+  program.postInstallAction = await askPostInstallAction(program);
 };

questions/simple.ts

@@ -1,18 +1,18 @@
 import prompts from "prompts";
-import { EXAMPLE_10K_SEC_FILES, EXAMPLE_FILE } from "../helpers/datasources";
+import { EXAMPLE_FILE } from "../helpers/datasources";
 import { askModelConfig } from "../helpers/providers";
 import { getTools } from "../helpers/tools";
 import { ModelConfig, TemplateFramework } from "../helpers/types";
 import { PureQuestionArgs, QuestionResults } from "./types";
 import { askPostInstallAction, questionHandlers } from "./utils";
-
-type AppType = "agentic_rag" | "financial_report" | "deep_research";
+type AppType = "rag" | "code_artifact" | "multiagent" | "extractor";
 
 type SimpleAnswers = {
   appType: AppType;
   language: TemplateFramework;
   useLlamaCloud: boolean;
   llamaCloudKey?: string;
+  modelConfig: ModelConfig;
 };
 
 export const askSimpleQuestions = async (
@@ -22,38 +22,20 @@ export const askSimpleQuestions = async (
     {
       type: "select",
       name: "appType",
-      message: "What use case do you want to build?",
+      message: "What app do you want to build?",
       choices: [
-        {
-          title: "Agentic RAG",
-          value: "agentic_rag",
-          description:
-            "Chatbot that answers questions based on provided documents.",
-        },
-        {
-          title: "Financial Report",
-          value: "financial_report",
-          description:
-            "Agent that analyzes data and generates visualizations by using a code interpreter.",
-        },
-        {
-          title: "Deep Research",
-          value: "deep_research",
-          description:
-            "Researches and analyzes provided documents from multiple perspectives, generating a comprehensive report with citations to support key findings and insights.",
-        },
+        { title: "Agentic RAG", value: "rag" },
+        { title: "Code Artifact Agent", value: "code_artifact" },
+        { title: "Multi-Agent Report Gen", value: "multiagent" },
+        { title: "Structured extraction", value: "extractor" },
       ],
     },
     questionHandlers,
   );
 
   let language: TemplateFramework = "fastapi";
-  let llamaCloudKey = args.llamaCloudKey;
-
-  let useLlamaCloud = false;
-
-  if (appType !== "extractor" && appType !== "contract_review") {
-    const { language: newLanguage } = await prompts(
+  if (appType !== "extractor") {
+    const res = await prompts(
       {
         type: "select",
         name: "language",
@@ -65,10 +47,10 @@ export const askSimpleQuestions = async (
       },
       questionHandlers,
     );
-    language = newLanguage;
+    language = res.language;
   }
 
-  const { useLlamaCloud: newUseLlamaCloud } = await prompts(
+  const { useLlamaCloud } = await prompts(
     {
       type: "toggle",
       name: "useLlamaCloud",
@@ -80,8 +62,8 @@ export const askSimpleQuestions = async (
     },
     questionHandlers,
   );
-  useLlamaCloud = newUseLlamaCloud;
 
+  let llamaCloudKey = args.llamaCloudKey;
   if (useLlamaCloud && !llamaCloudKey) {
     // Ask for LlamaCloud API key, if not set
     const { llamaCloudKey: newLlamaCloudKey } = await prompts(
@@ -96,71 +78,71 @@ export const askSimpleQuestions = async (
     llamaCloudKey = newLlamaCloudKey || process.env.LLAMA_CLOUD_API_KEY;
   }
 
-  const results = await convertAnswers(args, {
+  const modelConfig = await askModelConfig({
+    openAiKey: args.openAiKey,
+    askModels: args.askModels ?? false,
+    framework: language,
+  });
+
+  const results = convertAnswers({
     appType,
     language,
     useLlamaCloud,
     llamaCloudKey,
+    modelConfig,
   });
 
   results.postInstallAction = await askPostInstallAction(results);
   return results;
 };
 
-const convertAnswers = async (
-  args: PureQuestionArgs,
-  answers: SimpleAnswers,
-): Promise<QuestionResults> => {
-  const MODEL_GPT4o: ModelConfig = {
-    provider: "openai",
-    apiKey: args.openAiKey,
-    model: "gpt-4o",
-    embeddingModel: "text-embedding-3-large",
-    dimensions: 1536,
-    isConfigured(): boolean {
-      return !!args.openAiKey;
-    },
-  };
+const convertAnswers = (answers: SimpleAnswers): QuestionResults => {
   const lookup: Record<
     AppType,
-    Pick<QuestionResults, "template" | "tools" | "dataSources" | "useCase"> & {
-      modelConfig?: ModelConfig;
-    }
+    Pick<QuestionResults, "template" | "tools" | "frontend" | "dataSources">
   > = {
-    agentic_rag: {
-      template: "llamaindexserver",
+    rag: {
+      template: "streaming",
+      tools: getTools(["duckduckgo"]),
+      frontend: true,
       dataSources: [EXAMPLE_FILE],
     },
-    financial_report: {
-      template: "llamaindexserver",
-      dataSources: EXAMPLE_10K_SEC_FILES,
-      tools: getTools(["interpreter", "document_generator"]),
-      modelConfig: MODEL_GPT4o,
+    code_artifact: {
+      template: "streaming",
+      tools: getTools(["artifact"]),
+      frontend: true,
+      dataSources: [],
     },
-    deep_research: {
-      template: "llamaindexserver",
-      dataSources: EXAMPLE_10K_SEC_FILES,
+    multiagent: {
+      template: "multiagent",
+      tools: getTools([
+        "document_generator",
+        "wikipedia.WikipediaToolSpec",
+        "duckduckgo",
+        "img_gen",
+      ]),
+      frontend: true,
+      dataSources: [EXAMPLE_FILE],
+    },
+    extractor: {
+      template: "extractor",
       tools: [],
-      modelConfig: MODEL_GPT4o,
+      frontend: false,
+      dataSources: [EXAMPLE_FILE],
     },
   };
-
   const results = lookup[answers.appType];
   return {
     framework: answers.language,
-    useCase: answers.appType,
     ui: "shadcn",
     llamaCloudKey: answers.llamaCloudKey,
     useLlamaParse: answers.useLlamaCloud,
+    llamapack: "",
+    postInstallAction: "none",
     vectorDb: answers.useLlamaCloud ? "llamacloud" : "none",
+    modelConfig: answers.modelConfig,
+    observability: "none",
     ...results,
-    modelConfig:
-      results.modelConfig ??
-      (await askModelConfig({
-        openAiKey: args.openAiKey,
-        askModels: args.askModels ?? false,
-        framework: answers.language,
-      })),
-    frontend: true,
+    frontend: answers.language === "nextjs" ? false : results.frontend,
   };
 };

questions/types.ts

@@ -2,7 +2,7 @@ import { InstallAppArgs } from "../create-app";
 
 export type QuestionResults = Omit<
   InstallAppArgs,
-  "appPath" | "packageManager"
+  "appPath" | "packageManager" | "externalPort"
 >;
 
 export type PureQuestionArgs = {

templates/.gitignore

@@ -1,5 +1,3 @@
 __pycache__
+poetry.lock
 storage
-.env
-output
-.ui/

templates/README-fullstack.md

@@ -0,0 +1,18 @@
+This is a [LlamaIndex](https://www.llamaindex.ai/) project bootstrapped with [`create-llama`](https://github.com/run-llama/LlamaIndexTS/tree/main/packages/create-llama).
+
+## Getting Started
+
+First, startup the backend as described in the [backend README](./backend/README.md).
+
+Second, run the development server of the frontend as described in the [frontend README](./frontend/README.md).
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+## Learn More
+
+To learn more about LlamaIndex, take a look at the following resources:
+
+- [LlamaIndex Documentation](https://docs.llamaindex.ai) - learn about LlamaIndex (Python features).
+- [LlamaIndexTS Documentation](https://ts.llamaindex.ai) - learn about LlamaIndex (Typescript features).
+
+You can check out [the LlamaIndexTS GitHub repository](https://github.com/run-llama/LlamaIndexTS) - your feedback and contributions are welcome!

templates/components/agents/python/blog/app/workflows/__init__.py

@@ -1,3 +0,0 @@
-from .blog import create_workflow
-
-__all__ = ["create_workflow"]

templates/components/agents/python/deep_research/README-template.md

@@ -1,47 +0,0 @@
-This is a [LlamaIndex](https://www.llamaindex.ai/) multi-agents project using [Workflows](https://docs.llamaindex.ai/en/stable/understanding/workflows/).
-
-## Getting Started
-
-First, setup the environment with poetry:
-
-> **_Note:_** This step is not needed if you are using the dev-container.
-
-```shell
-poetry install
-```
-
-Then check the parameters that have been pre-configured in the `.env` file in this directory. (E.g. you might need to configure an `OPENAI_API_KEY` if you're using OpenAI as model provider).
-Second, generate the embeddings of the documents in the `./data` directory:
-
-```shell
-poetry run generate
-```
-
-Third, run the development server:
-
-```shell
-poetry run dev
-```
-
-## Use Case: Deep Research over own documents
-
-The workflow performs deep research by retrieving and analyzing documents from the [data](./data) directory from multiple perspectives. The project includes a sample PDF about AI investment in 2024 to help you get started. You can also add your own documents by placing them in the data directory and running the generate script again to index them.
-
-After starting the server, go to [http://localhost:8000](http://localhost:8000) and send a message to the agent to write a blog post.
-E.g: "AI investment in 2024"
-
-To update the workflow, you can edit the [deep_research.py](./app/workflows/deep_research.py) file.
-
-By default, the workflow retrieves 10 results from your documents. To customize the amount of information covered in the answer, you can adjust the `TOP_K` environment variable in the `.env` file. A higher value will retrieve more results from your documents, potentially providing more comprehensive answers.
-
-## Deployments
-
-For production deployments, check the [DEPLOY.md](DEPLOY.md) file.
-
-## Learn More
-
-To learn more about LlamaIndex, take a look at the following resources:
-
-- [LlamaIndex Documentation](https://docs.llamaindex.ai) - learn about LlamaIndex.
-- [Workflows Introduction](https://docs.llamaindex.ai/en/stable/understanding/workflows/) - learn about LlamaIndex workflows.
-  You can check out [the LlamaIndex GitHub repository](https://github.com/run-llama/llama_index) - your feedback and contributions are welcome!

templates/components/agents/python/deep_research/app/workflows/__init__.py

@@ -1,3 +0,0 @@
-from .deep_research import create_workflow
-
-__all__ = ["create_workflow"]

templates/components/agents/python/deep_research/app/workflows/agents.py

@@ -1,183 +0,0 @@
-from typing import List, Literal, Optional
-
-from llama_index.core.base.llms.types import (
-    CompletionResponse,
-    CompletionResponseAsyncGen,
-)
-from llama_index.core.memory.simple_composable_memory import SimpleComposableMemory
-from llama_index.core.prompts import PromptTemplate
-from llama_index.core.schema import MetadataMode, Node, NodeWithScore
-from llama_index.core.settings import Settings
-from pydantic import BaseModel, Field
-
-
-class AnalysisDecision(BaseModel):
-    decision: Literal["research", "write", "cancel"] = Field(
-        description="Whether to continue research, write a report, or cancel the research after several retries"
-    )
-    research_questions: Optional[List[str]] = Field(
-        description="""
-        If the decision is to research, provide a list of questions to research that related to the user request.
-        Maximum 3 questions. Set to null or empty if writing a report or cancel the research.
-        """,
-        default_factory=list,
-    )
-    cancel_reason: Optional[str] = Field(
-        description="The reason for cancellation if the decision is to cancel research.",
-        default=None,
-    )
-
-
-async def plan_research(
-    memory: SimpleComposableMemory,
-    context_nodes: List[Node],
-    user_request: str,
-    total_questions: int,
-) -> AnalysisDecision:
-    analyze_prompt = """
-      You are a professor who is guiding a researcher to research a specific request/problem.
-      Your task is to decide on a research plan for the researcher.
-
-      The possible actions are:
-      + Provide a list of questions for the researcher to investigate, with the purpose of clarifying the request.
-      + Write a report if the researcher has already gathered enough research on the topic and can resolve the initial request.
-      + Cancel the research if most of the answers from researchers indicate there is insufficient information to research the request. Do not attempt more than 3 research iterations or too many questions.
-
-      The workflow should be:
-      + Always begin by providing some initial questions for the researcher to investigate.
-      + Analyze the provided answers against the initial topic/request. If the answers are insufficient to resolve the initial request, provide additional questions for the researcher to investigate.
-      + If the answers are sufficient to resolve the initial request, instruct the researcher to write a report.
-
-      Here are the context: 
-      <Collected information>
-      {context_str}
-      </Collected information>
-
-      <Conversation context>
-      {conversation_context}
-      </Conversation context>
-
-      {enhanced_prompt}
-
-      Now, provide your decision in the required format for this user request:
-      <User request>
-      {user_request}
-      </User request>
-      """
-    # Manually craft the prompt to avoid LLM hallucination
-    enhanced_prompt = ""
-    if total_questions == 0:
-        # Avoid writing a report without any research context
-        enhanced_prompt = """
-        
-        The student has no questions to research. Let start by asking some questions.
-        """
-    elif total_questions > 6:
-        # Avoid asking too many questions (when the data is not ready for writing a report)
-        enhanced_prompt = f"""
-
-        The student has researched {total_questions} questions. Should cancel the research if the context is not enough to write a report.
-        """
-
-    conversation_context = "\n".join(
-        [f"{message.role}: {message.content}" for message in memory.get_all()]
-    )
-    context_str = "\n".join(
-        [node.get_content(metadata_mode=MetadataMode.LLM) for node in context_nodes]
-    )
-    res = await Settings.llm.astructured_predict(
-        output_cls=AnalysisDecision,
-        prompt=PromptTemplate(template=analyze_prompt),
-        user_request=user_request,
-        context_str=context_str,
-        conversation_context=conversation_context,
-        enhanced_prompt=enhanced_prompt,
-    )
-    return res
-
-
-async def research(
-    question: str,
-    context_nodes: List[NodeWithScore],
-) -> str:
-    prompt = """
-    You are a researcher who is in the process of answering the question.
-    The purpose is to answer the question based on the collected information, without using prior knowledge or making up any new information.
-    Always add citations to the sentence/point/paragraph using the id of the provided content.
-    The citation should follow this format: [citation:id]() where id is the id of the content.
-    
-    E.g:
-    If we have a context like this:
-    <Citation id='abc-xyz'>
-    Baby llama is called cria
-    </Citation id='abc-xyz'>
-
-    And your answer uses the content, then the citation should be:
-    - Baby llama is called cria [citation:abc-xyz]()
-
-    Here is the provided context for the question:
-    <Collected information>
-    {context_str}
-    </Collected information>`
-
-    No prior knowledge, just use the provided context to answer the question: {question}
-    """
-    context_str = "\n".join(
-        [_get_text_node_content_for_citation(node) for node in context_nodes]
-    )
-    res = await Settings.llm.acomplete(
-        prompt=prompt.format(question=question, context_str=context_str),
-    )
-    return res.text
-
-
-async def write_report(
-    memory: SimpleComposableMemory,
-    user_request: str,
-    stream: bool = False,
-) -> CompletionResponse | CompletionResponseAsyncGen:
-    report_prompt = """
-    You are a researcher writing a report based on a user request and the research context.
-    You have researched various perspectives related to the user request.
-    The report should provide a comprehensive outline covering all important points from the researched perspectives.
-    Create a well-structured outline for the research report that covers all the answers.
-
-    # IMPORTANT when writing in markdown format:
-    + Use tables or figures where appropriate to enhance presentation.
-    + Preserve all citation syntax (the `[citation:id]()` parts in the provided context). Keep these citations in the final report - no separate reference section is needed.
-    + Do not add links, a table of contents, or a references section to the report.
-
-    <User request>
-    {user_request}
-    </User request>
-
-    <Research context>
-    {research_context}
-    </Research context>
-
-    Now, write a report addressing the user request based on the research provided following the format and guidelines above.
-    """
-    research_context = "\n".join(
-        [f"{message.role}: {message.content}" for message in memory.get_all()]
-    )
-
-    llm_complete_func = (
-        Settings.llm.astream_complete if stream else Settings.llm.acomplete
-    )
-
-    res = await llm_complete_func(
-        prompt=report_prompt.format(
-            user_request=user_request,
-            research_context=research_context,
-        ),
-    )
-    return res
-
-
-def _get_text_node_content_for_citation(node: NodeWithScore) -> str:
-    """
-    Construct node content for LLM with citation flag.
-    """
-    node_id = node.node.node_id
-    content = f"<Citation id='{node_id}'>\n{node.get_content(metadata_mode=MetadataMode.LLM)}</Citation id='{node_id}'>"
-    return content

templates/components/agents/python/deep_research/app/workflows/deep_research.py

@@ -1,328 +0,0 @@
-import logging
-import os
-import uuid
-from typing import Any, Dict, List, Optional
-
-from llama_index.core.indices.base import BaseIndex
-from llama_index.core.memory import ChatMemoryBuffer
-from llama_index.core.memory.simple_composable_memory import SimpleComposableMemory
-from llama_index.core.schema import Node
-from llama_index.core.types import ChatMessage, MessageRole
-from llama_index.core.workflow import (
-    Context,
-    StartEvent,
-    StopEvent,
-    Workflow,
-    step,
-)
-
-from app.engine.index import IndexConfig, get_index
-from app.workflows.agents import plan_research, research, write_report
-from app.workflows.events import SourceNodesEvent
-from app.workflows.models import (
-    CollectAnswersEvent,
-    DataEvent,
-    PlanResearchEvent,
-    ReportEvent,
-    ResearchEvent,
-)
-
-logger = logging.getLogger("uvicorn")
-logger.setLevel(logging.INFO)
-
-
-def create_workflow(
-    params: Optional[Dict[str, Any]] = None,
-    **kwargs,
-) -> Workflow:
-    index_config = IndexConfig(**params)
-    index = get_index(index_config)
-    if index is None:
-        raise ValueError(
-            "Index is not found. Try run generation script to create the index first."
-        )
-
-    return DeepResearchWorkflow(
-        index=index,
-        timeout=120.0,
-    )
-
-
-class DeepResearchWorkflow(Workflow):
-    """
-    A workflow to research and analyze documents from multiple perspectives and write a comprehensive report.
-
-    Requirements:
-    - An indexed documents containing the knowledge base related to the topic
-
-    Steps:
-    1. Retrieve information from the knowledge base
-    2. Analyze the retrieved information and provide questions for answering
-    3. Answer the questions
-    4. Write the report based on the research results
-    """
-
-    memory: SimpleComposableMemory
-    context_nodes: List[Node]
-    index: BaseIndex
-    user_request: str
-    stream: bool = True
-
-    def __init__(
-        self,
-        index: BaseIndex,
-        **kwargs,
-    ):
-        super().__init__(**kwargs)
-        self.index = index
-        self.context_nodes = []
-        self.memory = SimpleComposableMemory.from_defaults(
-            primary_memory=ChatMemoryBuffer.from_defaults(),
-        )
-
-    @step
-    async def retrieve(self, ctx: Context, ev: StartEvent) -> PlanResearchEvent:
-        """
-        Initiate the workflow: memory, tools, agent
-        """
-        self.stream = ev.get("stream", True)
-        self.user_request = ev.get("user_msg")
-        chat_history = ev.get("chat_history")
-        if chat_history is not None:
-            self.memory.put_messages(chat_history)
-
-        await ctx.set("total_questions", 0)
-
-        # Add user message to memory
-        self.memory.put_messages(
-            messages=[
-                ChatMessage(
-                    role=MessageRole.USER,
-                    content=self.user_request,
-                )
-            ]
-        )
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "retrieve",
-                    "state": "inprogress",
-                },
-            )
-        )
-        retriever = self.index.as_retriever(
-            similarity_top_k=int(os.getenv("TOP_K", 10)),
-        )
-        nodes = retriever.retrieve(self.user_request)
-        self.context_nodes.extend(nodes)
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "retrieve",
-                    "state": "done",
-                },
-            )
-        )
-        # Send source nodes to the stream
-        # Use SourceNodesEvent to display source nodes in the UI.
-        ctx.write_event_to_stream(
-            SourceNodesEvent(
-                nodes=nodes,
-            )
-        )
-        return PlanResearchEvent()
-
-    @step
-    async def analyze(
-        self, ctx: Context, ev: PlanResearchEvent
-    ) -> ResearchEvent | ReportEvent | StopEvent:
-        """
-        Analyze the retrieved information
-        """
-        logger.info("Analyzing the retrieved information")
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "analyze",
-                    "state": "inprogress",
-                },
-            )
-        )
-        total_questions = await ctx.get("total_questions")
-        res = await plan_research(
-            memory=self.memory,
-            context_nodes=self.context_nodes,
-            user_request=self.user_request,
-            total_questions=total_questions,
-        )
-        if res.decision == "cancel":
-            ctx.write_event_to_stream(
-                DataEvent(
-                    type="deep_research_event",
-                    data={
-                        "event": "analyze",
-                        "state": "done",
-                    },
-                )
-            )
-            return StopEvent(
-                result=res.cancel_reason,
-            )
-        elif res.decision == "write":
-            # Writing a report without any research context is not allowed.
-            # It's a LLM hallucination.
-            if total_questions == 0:
-                ctx.write_event_to_stream(
-                    DataEvent(
-                        type="deep_research_event",
-                        data={
-                            "event": "analyze",
-                            "state": "done",
-                        },
-                    )
-                )
-                return StopEvent(
-                    result="Sorry, I have a problem when analyzing the retrieved information. Please try again.",
-                )
-
-            self.memory.put(
-                message=ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content="No more idea to analyze. We should report the answers.",
-                )
-            )
-            ctx.send_event(ReportEvent())
-        else:
-            total_questions += len(res.research_questions)
-            await ctx.set("total_questions", total_questions)  # For tracking
-            await ctx.set(
-                "waiting_questions", len(res.research_questions)
-            )  # For waiting questions to be answered
-            self.memory.put(
-                message=ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content="We need to find answers to the following questions:\n"
-                    + "\n".join(res.research_questions),
-                )
-            )
-            for question in res.research_questions:
-                question_id = str(uuid.uuid4())
-                ctx.write_event_to_stream(
-                    DataEvent(
-                        type="deep_research_event",
-                        data={
-                            "event": "answer",
-                            "state": "pending",
-                            "id": question_id,
-                            "question": question,
-                            "answer": None,
-                        },
-                    )
-                )
-                ctx.send_event(
-                    ResearchEvent(
-                        question_id=question_id,
-                        question=question,
-                        context_nodes=self.context_nodes,
-                    )
-                )
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "analyze",
-                    "state": "done",
-                },
-            )
-        )
-        return None
-
-    @step(num_workers=2)
-    async def answer(self, ctx: Context, ev: ResearchEvent) -> CollectAnswersEvent:
-        """
-        Answer the question
-        """
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "answer",
-                    "state": "inprogress",
-                    "id": ev.question_id,
-                    "question": ev.question,
-                },
-            )
-        )
-        try:
-            answer = await research(
-                context_nodes=ev.context_nodes,
-                question=ev.question,
-            )
-        except Exception as e:
-            logger.error(f"Error answering question {ev.question}: {e}")
-            answer = f"Got error when answering the question: {ev.question}"
-        ctx.write_event_to_stream(
-            DataEvent(
-                type="deep_research_event",
-                data={
-                    "event": "answer",
-                    "state": "done",
-                    "id": ev.question_id,
-                    "question": ev.question,
-                    "answer": answer,
-                },
-            )
-        )
-
-        return CollectAnswersEvent(
-            question_id=ev.question_id,
-            question=ev.question,
-            answer=answer,
-        )
-
-    @step
-    async def collect_answers(
-        self, ctx: Context, ev: CollectAnswersEvent
-    ) -> PlanResearchEvent:
-        """
-        Collect answers to all questions
-        """
-        num_questions = await ctx.get("waiting_questions")
-        results = ctx.collect_events(
-            ev,
-            expected=[CollectAnswersEvent] * num_questions,
-        )
-        if results is None:
-            return None
-        for result in results:
-            self.memory.put(
-                message=ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content=f"<Question>{result.question}</Question>\n<Answer>{result.answer}</Answer>",
-                )
-            )
-        await ctx.set("waiting_questions", 0)
-        self.memory.put(
-            message=ChatMessage(
-                role=MessageRole.ASSISTANT,
-                content="Researched all the questions. Now, i need to analyze if it's ready to write a report or need to research more.",
-            )
-        )
-        return PlanResearchEvent()
-
-    @step
-    async def report(self, ctx: Context, ev: ReportEvent) -> StopEvent:
-        """
-        Report the answers
-        """
-        res = await write_report(
-            memory=self.memory,
-            user_request=self.user_request,
-            stream=self.stream,
-        )
-        return StopEvent(
-            result=res,
-        )

templates/components/agents/python/deep_research/app/workflows/models.py

@@ -1,43 +0,0 @@
-from typing import List, Literal, Optional
-
-from llama_index.core.schema import NodeWithScore
-from llama_index.core.workflow import Event
-from pydantic import BaseModel
-
-
-# Workflow events
-class PlanResearchEvent(Event):
-    pass
-
-
-class ResearchEvent(Event):
-    question_id: str
-    question: str
-    context_nodes: List[NodeWithScore]
-
-
-class CollectAnswersEvent(Event):
-    question_id: str
-    question: str
-    answer: str
-
-
-class ReportEvent(Event):
-    pass
-
-
-# Events that are streamed to the frontend and rendered there
-class DeepResearchEventData(BaseModel):
-    event: Literal["retrieve", "analyze", "answer"]
-    state: Literal["pending", "inprogress", "done", "error"]
-    id: Optional[str] = None
-    question: Optional[str] = None
-    answer: Optional[str] = None
-
-
-class DataEvent(Event):
-    type: Literal["deep_research_event"]
-    data: DeepResearchEventData
-
-    def to_response(self):
-        return self.model_dump()

templates/components/agents/python/financial_report/README-template.md

@@ -1,57 +0,0 @@
-This is a [LlamaIndex](https://www.llamaindex.ai/) multi-agents project using [Workflows](https://docs.llamaindex.ai/en/stable/understanding/workflows/).
-
-## Getting Started
-
-First, setup the environment with poetry:
-
-> **_Note:_** This step is not needed if you are using the dev-container.
-
-```shell
-poetry install
-```
-
-Then check the parameters that have been pre-configured in the `.env` file in this directory. (E.g. you might need to configure an `OPENAI_API_KEY` if you're using OpenAI as model provider and `E2B_API_KEY` for the [E2B's code interpreter tool](https://e2b.dev/docs)).
-
-Second, generate the embeddings of the documents in the `./data` directory:
-
-```shell
-poetry run generate
-```
-
-Third, run the development server:
-
-```shell
-poetry run dev
-```
-
-The example provides one streaming API endpoint `/api/chat`.
-You can test the endpoint with the following curl request:
-
-```
-curl --location 'localhost:8000/api/chat' \
---header 'Content-Type: application/json' \
---data '{ "messages": [{ "role": "user", "content": "Create a report comparing the finances of Apple and Tesla" }] }'
-```
-
-You can start editing the API by modifying `app/api/routers/chat.py` or `app/workflows/financial_report.py`. The API auto-updates as you save the files.
-
-Open [http://localhost:8000](http://localhost:8000) with your browser to start the app.
-
-To start the app optimized for **production**, run:
-
-```
-poetry run prod
-```
-
-## Deployments
-
-For production deployments, check the [DEPLOY.md](DEPLOY.md) file.
-
-## Learn More
-
-To learn more about LlamaIndex, take a look at the following resources:
-
-- [LlamaIndex Documentation](https://docs.llamaindex.ai) - learn about LlamaIndex.
-- [Workflows Introduction](https://docs.llamaindex.ai/en/stable/understanding/workflows/) - learn about LlamaIndex workflows.
-
-You can check out [the LlamaIndex GitHub repository](https://github.com/run-llama/llama_index) - your feedback and contributions are welcome!

templates/components/agents/python/financial_report/app/workflows/__init__.py

@@ -1,3 +0,0 @@
-from .financial_report import create_workflow
-
-__all__ = ["create_workflow"]

templates/components/agents/python/financial_report/app/workflows/financial_report.py

@@ -1,300 +0,0 @@
-from typing import Any, Dict, List, Optional
-
-from llama_index.core import Settings
-from llama_index.core.base.llms.types import ChatMessage, MessageRole
-from llama_index.core.llms.function_calling import FunctionCallingLLM
-from llama_index.core.memory import ChatMemoryBuffer
-from llama_index.core.tools import FunctionTool, QueryEngineTool, ToolSelection
-from llama_index.core.workflow import (
-    Context,
-    Event,
-    StartEvent,
-    StopEvent,
-    Workflow,
-    step,
-)
-
-from app.engine.index import IndexConfig, get_index
-from app.engine.tools import ToolFactory
-from app.engine.tools.query_engine import get_query_engine_tool
-from app.workflows.events import AgentRunEvent
-from app.workflows.tools import (
-    call_tools,
-    chat_with_tools,
-)
-
-
-def create_workflow(
-    params: Optional[Dict[str, Any]] = None,
-    **kwargs,
-) -> Workflow:
-    # Create query engine tool
-    index_config = IndexConfig(**params)
-    index = get_index(index_config)
-    if index is None:
-        raise ValueError(
-            "Index is not found. Try run generation script to create the index first."
-        )
-    query_engine_tool = get_query_engine_tool(index=index)
-
-    configured_tools: Dict[str, FunctionTool] = ToolFactory.from_env(map_result=True)  # type: ignore
-    code_interpreter_tool = configured_tools.get("interpret")
-    document_generator_tool = configured_tools.get("generate_document")
-
-    return FinancialReportWorkflow(
-        query_engine_tool=query_engine_tool,
-        code_interpreter_tool=code_interpreter_tool,
-        document_generator_tool=document_generator_tool,
-    )
-
-
-class InputEvent(Event):
-    input: List[ChatMessage]
-    response: bool = False
-
-
-class ResearchEvent(Event):
-    input: list[ToolSelection]
-
-
-class AnalyzeEvent(Event):
-    input: list[ToolSelection] | ChatMessage
-
-
-class ReportEvent(Event):
-    input: list[ToolSelection]
-
-
-class FinancialReportWorkflow(Workflow):
-    """
-    A workflow to generate a financial report using indexed documents.
-
-    Requirements:
-    - Indexed documents containing financial data and a query engine tool to search them
-    - A code interpreter tool to analyze data and generate reports
-    - A document generator tool to create report files
-
-    Steps:
-    1. LLM Input: The LLM determines the next step based on function calling.
-       For example, if the model requests the query engine tool, it returns a ResearchEvent;
-       if it requests document generation, it returns a ReportEvent.
-    2. Research: Uses the query engine to find relevant chunks from indexed documents.
-       After gathering information, it requests analysis (step 3).
-    3. Analyze: Uses a custom prompt to analyze research results and can call the code
-       interpreter tool for visualization or calculation. Returns results to the LLM.
-    4. Report: Uses the document generator tool to create a report. Returns results to the LLM.
-    """
-
-    _default_system_prompt = """
-    You are a financial analyst who are given a set of tools to help you.
-    It's good to using appropriate tools for the user request and always use the information from the tools, don't make up anything yourself.
-    For the query engine tool, you should break down the user request into a list of queries and call the tool with the queries.
-    """
-    stream: bool = True
-
-    def __init__(
-        self,
-        query_engine_tool: QueryEngineTool,
-        code_interpreter_tool: FunctionTool,
-        document_generator_tool: FunctionTool,
-        llm: Optional[FunctionCallingLLM] = None,
-        timeout: int = 360,
-        system_prompt: Optional[str] = None,
-    ):
-        super().__init__(timeout=timeout)
-        self.system_prompt = system_prompt or self._default_system_prompt
-        self.query_engine_tool = query_engine_tool
-        self.code_interpreter_tool = code_interpreter_tool
-        self.document_generator_tool = document_generator_tool
-        assert query_engine_tool is not None, (
-            "Query engine tool is not found. Try run generation script or upload a document file first."
-        )
-        assert code_interpreter_tool is not None, "Code interpreter tool is required"
-        assert document_generator_tool is not None, (
-            "Document generator tool is required"
-        )
-        self.tools = [
-            self.query_engine_tool,
-            self.code_interpreter_tool,
-            self.document_generator_tool,
-        ]
-        self.llm: FunctionCallingLLM = llm or Settings.llm
-        assert isinstance(self.llm, FunctionCallingLLM)
-        self.memory = ChatMemoryBuffer.from_defaults(llm=self.llm)
-
-    @step()
-    async def prepare_chat_history(self, ctx: Context, ev: StartEvent) -> InputEvent:
-        self.stream = ev.get("stream", True)
-        user_msg = ev.get("user_msg")
-        chat_history = ev.get("chat_history")
-
-        if chat_history is not None:
-            self.memory.put_messages(chat_history)
-
-        # Add user message to memory
-        self.memory.put(ChatMessage(role=MessageRole.USER, content=user_msg))
-
-        if self.system_prompt:
-            system_msg = ChatMessage(
-                role=MessageRole.SYSTEM, content=self.system_prompt
-            )
-            self.memory.put(system_msg)
-
-        return InputEvent(input=self.memory.get())
-
-    @step()
-    async def handle_llm_input(  # type: ignore
-        self,
-        ctx: Context,
-        ev: InputEvent,
-    ) -> ResearchEvent | AnalyzeEvent | ReportEvent | StopEvent:
-        """
-        Handle an LLM input and decide the next step.
-        """
-        # Always use the latest chat history from the input
-        chat_history: list[ChatMessage] = ev.input
-
-        # Get tool calls
-        response = await chat_with_tools(
-            self.llm,
-            self.tools,  # type: ignore
-            chat_history,
-        )
-        if not response.has_tool_calls():
-            if self.stream:
-                return StopEvent(result=response.generator)
-            else:
-                return StopEvent(result=await response.full_response())
-        # calling different tools at the same time is not supported at the moment
-        # add an error message to tell the AI to process step by step
-        if response.is_calling_different_tools():
-            self.memory.put(
-                ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content="Cannot call different tools at the same time. Try calling one tool at a time.",
-                )
-            )
-            return InputEvent(input=self.memory.get())
-        self.memory.put(response.tool_call_message)
-        match response.tool_name():
-            case self.code_interpreter_tool.metadata.name:
-                return AnalyzeEvent(input=response.tool_calls)
-            case self.document_generator_tool.metadata.name:
-                return ReportEvent(input=response.tool_calls)
-            case self.query_engine_tool.metadata.name:
-                return ResearchEvent(input=response.tool_calls)
-            case _:
-                raise ValueError(f"Unknown tool: {response.tool_name()}")
-
-    @step()
-    async def research(self, ctx: Context, ev: ResearchEvent) -> AnalyzeEvent:
-        """
-        Do a research to gather information for the user's request.
-        A researcher should have these tools: query engine, search engine, etc.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Researcher",
-                msg="Starting research",
-            )
-        )
-        tool_calls = ev.input
-
-        tool_messages = await call_tools(
-            ctx=ctx,
-            agent_name="Researcher",
-            tools=[self.query_engine_tool],
-            tool_calls=tool_calls,
-        )
-        self.memory.put_messages(tool_messages)
-        return AnalyzeEvent(
-            input=ChatMessage(
-                role=MessageRole.ASSISTANT,
-                content="I've finished the research. Please analyze the result.",
-            ),
-        )
-
-    @step()
-    async def analyze(self, ctx: Context, ev: AnalyzeEvent) -> InputEvent:
-        """
-        Analyze the research result.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Analyst",
-                msg="Starting analysis",
-            )
-        )
-        event_requested_by_workflow_llm = isinstance(ev.input, list)
-        # Requested by the workflow LLM Input step, it's a tool call
-        if event_requested_by_workflow_llm:
-            # Set the tool calls
-            tool_calls = ev.input
-        else:
-            # Otherwise, it's triggered by the research step
-            # Use a custom prompt and independent memory for the analyst agent
-            analysis_prompt = """
-            You are a financial analyst, you are given a research result and a set of tools to help you.
-            Always use the given information, don't make up anything yourself. If there is not enough information, you can asking for more information.
-            If you have enough numerical information, it's good to include some charts/visualizations to the report so you can use the code interpreter tool to generate a report.
-            """
-            # This is handled by analyst agent
-            # Clone the shared memory to avoid conflicting with the workflow.
-            chat_history = self.memory.get()
-            chat_history.append(
-                ChatMessage(role=MessageRole.SYSTEM, content=analysis_prompt)
-            )
-            chat_history.append(ev.input)  # type: ignore
-            # Check if the analyst agent needs to call tools
-            response = await chat_with_tools(
-                self.llm,
-                [self.code_interpreter_tool],
-                chat_history,
-            )
-            if not response.has_tool_calls():
-                # If no tool call, fallback analyst message to the workflow
-                analyst_msg = ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content=await response.full_response(),
-                )
-                self.memory.put(analyst_msg)
-                return InputEvent(input=self.memory.get())
-            else:
-                # Set the tool calls and the tool call message to the memory
-                tool_calls = response.tool_calls
-                self.memory.put(response.tool_call_message)
-
-        # Call tools
-        tool_messages = await call_tools(
-            ctx=ctx,
-            agent_name="Analyst",
-            tools=[self.code_interpreter_tool],
-            tool_calls=tool_calls,  # type: ignore
-        )
-        self.memory.put_messages(tool_messages)
-
-        # Fallback to the input with the latest chat history
-        return InputEvent(input=self.memory.get())
-
-    @step()
-    async def report(self, ctx: Context, ev: ReportEvent) -> InputEvent:
-        """
-        Generate a report based on the analysis result.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Reporter",
-                msg="Starting report generation",
-            )
-        )
-        tool_calls = ev.input
-        tool_messages = await call_tools(
-            ctx=ctx,
-            agent_name="Reporter",
-            tools=[self.document_generator_tool],
-            tool_calls=tool_calls,
-        )
-        self.memory.put_messages(tool_messages)
-
-        # After the tool calls, fallback to the input with the latest chat history
-        return InputEvent(input=self.memory.get())

templates/components/agents/python/form_filling/README-template.md

@@ -1,63 +0,0 @@
-This is a [LlamaIndex](https://www.llamaindex.ai/) multi-agents project using [Workflows](https://docs.llamaindex.ai/en/stable/understanding/workflows/).
-
-## Getting Started
-
-First, setup the environment with poetry:
-
-> **_Note:_** This step is not needed if you are using the dev-container.
-
-```shell
-poetry install
-```
-
-Then check the parameters that have been pre-configured in the `.env` file in this directory.
-Make sure you have the `OPENAI_API_KEY` set.
-
-Second, run the development server:
-
-```shell
-poetry run dev
-```
-
-## Use Case: Filling Financial CSV Template
-
-To reproduce the use case, start the [frontend](../frontend/README.md) and follow these steps in the frontend:
-
-1. Upload the Apple and Tesla financial reports from the [data](./data) directory. Just send an empty message.
-2. Upload the CSV file [sec_10k_template.csv](./sec_10k_template.csv) and send the message "Fill the missing cells in the CSV file".
-
-The agent will fill the missing cells by retrieving the information from the uploaded financial reports and return a new CSV file with the filled cells.
-
-### API endpoints
-
-The example provides one streaming API endpoint `/api/chat`.
-You can test the endpoint with the following curl request:
-
-```
-curl --location 'localhost:8000/api/chat' \
---header 'Content-Type: application/json' \
---data '{ "messages": [{ "role": "user", "content": "What can you do?" }] }'
-```
-
-You can start editing the API by modifying `app/api/routers/chat.py` or `app/workflows/form_filling.py`. The API auto-updates as you save the files.
-
-Open [http://localhost:8000](http://localhost:8000) with your browser to start the app.
-
-To start the app optimized for **production**, run:
-
-```
-poetry run prod
-```
-
-## Deployments
-
-For production deployments, check the [DEPLOY.md](DEPLOY.md) file.
-
-## Learn More
-
-To learn more about LlamaIndex, take a look at the following resources:
-
-- [LlamaIndex Documentation](https://docs.llamaindex.ai) - learn about LlamaIndex.
-- [Workflows Introduction](https://docs.llamaindex.ai/en/stable/understanding/workflows/) - learn about LlamaIndex workflows.
-
-You can check out [the LlamaIndex GitHub repository](https://github.com/run-llama/llama_index) - your feedback and contributions are welcome!

templates/components/agents/python/form_filling/app/workflows/__init__.py

@@ -1,3 +0,0 @@
-from .form_filling import create_workflow
-
-__all__ = ["create_workflow"]

templates/components/agents/python/form_filling/app/workflows/form_filling.py

@@ -1,236 +0,0 @@
-from typing import Any, Dict, List, Optional
-
-from llama_index.core import Settings
-from llama_index.core.base.llms.types import ChatMessage, MessageRole
-from llama_index.core.llms.function_calling import FunctionCallingLLM
-from llama_index.core.memory import ChatMemoryBuffer
-from llama_index.core.tools import FunctionTool, QueryEngineTool, ToolSelection
-from llama_index.core.workflow import (
-    Context,
-    Event,
-    StartEvent,
-    StopEvent,
-    Workflow,
-    step,
-)
-
-from app.engine.index import IndexConfig, get_index
-from app.engine.tools import ToolFactory
-from app.engine.tools.query_engine import get_query_engine_tool
-from app.workflows.events import AgentRunEvent
-from app.workflows.tools import (
-    call_tools,
-    chat_with_tools,
-)
-
-
-def create_workflow(
-    params: Optional[Dict[str, Any]] = None,
-    **kwargs,
-) -> Workflow:
-    # Create query engine tool
-    index_config = IndexConfig(**params)
-    index = get_index(index_config)
-    if index is None:
-        query_engine_tool = None
-    else:
-        query_engine_tool = get_query_engine_tool(index=index)
-
-    configured_tools = ToolFactory.from_env(map_result=True)
-    extractor_tool = configured_tools.get("extract_questions")  # type: ignore
-    filling_tool = configured_tools.get("fill_form")  # type: ignore
-
-    workflow = FormFillingWorkflow(
-        query_engine_tool=query_engine_tool,
-        extractor_tool=extractor_tool,  # type: ignore
-        filling_tool=filling_tool,  # type: ignore
-    )
-
-    return workflow
-
-
-class InputEvent(Event):
-    input: List[ChatMessage]
-    response: bool = False
-
-
-class ExtractMissingCellsEvent(Event):
-    tool_calls: list[ToolSelection]
-
-
-class FindAnswersEvent(Event):
-    tool_calls: list[ToolSelection]
-
-
-class FillEvent(Event):
-    tool_calls: list[ToolSelection]
-
-
-class FormFillingWorkflow(Workflow):
-    """
-    A predefined workflow for filling missing cells in a CSV file.
-    Required tools:
-    - query_engine: A query engine to query for the answers to the questions.
-    - extract_question: Extract missing cells in a CSV file and generate questions to fill them.
-    - answer_question: Query for the answers to the questions.
-
-    Flow:
-    1. Extract missing cells in a CSV file and generate questions to fill them.
-    2. Query for the answers to the questions.
-    3. Fill the missing cells with the answers.
-    """
-
-    _default_system_prompt = """
-    You are a helpful assistant who helps fill missing cells in a CSV file.
-    Only extract missing cells from CSV files.
-    Only use provided data - never make up any information yourself. Fill N/A if an answer is not found.
-    If there is no query engine tool or the gathered information has many N/A values indicating the questions don't match the data, respond with a warning and ask the user to upload a different file or connect to a knowledge base.
-    """
-    stream: bool = True
-
-    def __init__(
-        self,
-        query_engine_tool: Optional[QueryEngineTool],
-        extractor_tool: FunctionTool,
-        filling_tool: FunctionTool,
-        llm: Optional[FunctionCallingLLM] = None,
-        timeout: int = 360,
-        system_prompt: Optional[str] = None,
-    ):
-        super().__init__(timeout=timeout)
-        self.system_prompt = system_prompt or self._default_system_prompt
-        self.query_engine_tool = query_engine_tool
-        self.extractor_tool = extractor_tool
-        self.filling_tool = filling_tool
-        if self.extractor_tool is None or self.filling_tool is None:
-            raise ValueError("Extractor and filling tools are required.")
-        self.tools = [self.extractor_tool, self.filling_tool]
-        if self.query_engine_tool is not None:
-            self.tools.append(self.query_engine_tool)  # type: ignore
-        self.llm: FunctionCallingLLM = llm or Settings.llm
-        if not isinstance(self.llm, FunctionCallingLLM):
-            raise ValueError("FormFillingWorkflow only supports FunctionCallingLLM.")
-        self.memory = ChatMemoryBuffer.from_defaults(llm=self.llm)
-
-    @step()
-    async def start(self, ctx: Context, ev: StartEvent) -> InputEvent:
-        self.stream = ev.get("stream", True)
-        user_msg = ev.get("user_msg", "")
-        chat_history = ev.get("chat_history", [])
-
-        if chat_history:
-            self.memory.put_messages(chat_history)
-
-        self.memory.put(ChatMessage(role=MessageRole.USER, content=user_msg))
-
-        if self.system_prompt:
-            system_msg = ChatMessage(
-                role=MessageRole.SYSTEM, content=self.system_prompt
-            )
-            self.memory.put(system_msg)
-
-        return InputEvent(input=self.memory.get())
-
-    @step()
-    async def handle_llm_input(  # type: ignore
-        self,
-        ctx: Context,
-        ev: InputEvent,
-    ) -> ExtractMissingCellsEvent | FillEvent | StopEvent:
-        """
-        Handle an LLM input and decide the next step.
-        """
-        chat_history: list[ChatMessage] = ev.input
-        response = await chat_with_tools(
-            self.llm,
-            self.tools,
-            chat_history,
-        )
-        if not response.has_tool_calls():
-            if self.stream:
-                return StopEvent(result=response.generator)
-            else:
-                return StopEvent(result=await response.full_response())
-        # calling different tools at the same time is not supported at the moment
-        # add an error message to tell the AI to process step by step
-        if response.is_calling_different_tools():
-            self.memory.put(
-                ChatMessage(
-                    role=MessageRole.ASSISTANT,
-                    content="Cannot call different tools at the same time. Try calling one tool at a time.",
-                )
-            )
-            return InputEvent(input=self.memory.get())
-        self.memory.put(response.tool_call_message)
-        match response.tool_name():
-            case self.extractor_tool.metadata.name:
-                return ExtractMissingCellsEvent(tool_calls=response.tool_calls)
-            case self.query_engine_tool.metadata.name:
-                return FindAnswersEvent(tool_calls=response.tool_calls)
-            case self.filling_tool.metadata.name:
-                return FillEvent(tool_calls=response.tool_calls)
-            case _:
-                raise ValueError(f"Unknown tool: {response.tool_name()}")
-
-    @step()
-    async def extract_missing_cells(
-        self, ctx: Context, ev: ExtractMissingCellsEvent
-    ) -> InputEvent | FindAnswersEvent:
-        """
-        Extract missing cells in a CSV file and generate questions to fill them.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Extractor",
-                msg="Extracting missing cells",
-            )
-        )
-        # Call the extract questions tool
-        tool_messages = await call_tools(
-            agent_name="Extractor",
-            tools=[self.extractor_tool],
-            ctx=ctx,
-            tool_calls=ev.tool_calls,
-        )
-        self.memory.put_messages(tool_messages)
-        return InputEvent(input=self.memory.get())
-
-    @step()
-    async def find_answers(self, ctx: Context, ev: FindAnswersEvent) -> InputEvent:
-        """
-        Call answer questions tool to query for the answers to the questions.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Researcher",
-                msg="Finding answers for missing cells",
-            )
-        )
-        tool_messages = await call_tools(
-            ctx=ctx,
-            agent_name="Researcher",
-            tools=[self.query_engine_tool],
-            tool_calls=ev.tool_calls,
-        )
-        self.memory.put_messages(tool_messages)
-        return InputEvent(input=self.memory.get())
-
-    @step()
-    async def fill_cells(self, ctx: Context, ev: FillEvent) -> InputEvent:
-        """
-        Call fill cells tool to fill the missing cells with the answers.
-        """
-        ctx.write_event_to_stream(
-            AgentRunEvent(
-                name="Processor",
-                msg="Filling missing cells",
-            )
-        )
-        tool_messages = await call_tools(
-            agent_name="Processor",
-            tools=[self.filling_tool],
-            ctx=ctx,
-            tool_calls=ev.tool_calls,
-        )
-        self.memory.put_messages(tool_messages)
-        return InputEvent(input=self.memory.get())