@sap-ux/fiori-docs-embeddings
Fiori documentation indexed as embeddings, which is what makes it searchable by something other than a person scrolling it.
Facts
Where it sits
Who is behind it
In the atlas: maintains 137, wrote 14@SAPmaintainerAndis RedmansContributes to this
In the atlas: contributes to 13@815areAisling NooneContributes to this
In the atlas: contributes to 8@aislingnooneAlina GovoruhinaContributes to this
In the atlas: contributes to 9@AlinaGovoruhinaArtemis CoderContributes to this
In the atlas: contributes to 9@Artemis-Coder17avasilev-sapContributes to this
In the atlas: contributes to 9@avasilev-sapbroksyContributes to this
In the atlas: contributes to 11@broksyChristoph GollmickContributes to this
In the atlas: contributes to 11, wrote 1@cfg74Cian MorrinContributes to this
In the atlas: contributes to 15@cianmSAPCiaraContributes to this
In the atlas: contributes to 8@ciaradaly2021colindoherty1Contributes to this
In the atlas: contributes to 8@colindoherty185 contributors
What it declares
Every artifact
- Type
- Package
- Origin
- By SAP
As a package
- Where it runs
- does not say
- Distributed through
- npm
Connections
Finding answers in written documentation, and writing what is missing
Download
Install
npm add @sap-ux/fiori-docs-embeddingsDerived from the package name. No recipe recorded; the README has the configuration.
README
quoted from SAP/open-ux-tools under Apache-2.0, read@sap-ux/fiori-docs-embeddings
A Node.js package that indexes SAP Fiori related documentation from multiple sources and generates vector embeddings for semantic search capabilities.
What it does
This module- Crawls documentation from GitHub repositories (see Configuration for a list of default sources) Example sources:
https://github.com/SAP-docs/btp-fiori-tools (Fiori Tools documentation)
https://github.com/SAP-docs/sapui5/tree/main/docs/06_SAP_Fiori_Elements (UI5 Fiori Elements documentation)
https://github.com/SAP-samples/fiori-tools-samples (Sample applications)
https://github.com/SAP-samples/fiori-elements-feature-showcase (Feature examples)
https://ui5.sap.com/test-resources/sap/fe/macros/designtime/apiref/api.json (Design Time API Reference)
https://ui5.sap.com/test-resources/sap/fe/core/fpmExplorer/index.html#/overview/introduction (SAP Fiori Development Portal)
https://github.com/SAP/open-ux-tools/blob/main/packages/create/README.md (Fiori Tools create documentation)
https://www.npmjs.com/package/@sap/ux-ui5-tooling (@sap/ux-ui5-tooling documentation)
https://github.com/sap-tutorials/Tutorials/blob/master/tutorials/fiori-tools-mockserver-opa-testing/fiori-tools-mockserver-opa-testing.md (OPA mock server testing guide)
- Parses markdown, JSON, TypeScript, and other file types
- Generates AI-powered vector embeddings using transformers
- Stores embeddings in a flat binary vector store (
embeddings.bin+records.jsonl) - Provides tools for semantic and keyword search across documentation
Installation
npm install @sap-ux/fiori-docs-embeddings
Usage
Basic Usage
import { getDataPath, getEmbeddingsPath } from '@sap-ux/fiori-docs-embeddings';
// Get paths to data directories
const docsPath = getDataPath();
const embeddingsPath = getEmbeddingsPath();
Building Documentation Index
# Set GitHub token to avoid rate limits
export GITHUB_TOKEN=your_github_token
# Build documentation index (all sources)
npm run update-docs
# Build a single source by ID
npm run update-docs-script -- --source=fiori-tools-opa-guide
# Shortcut script for the OPA testing guide
npm run update-docs-opa-guide
# Generate embeddings
npm run update-embeddings
# Or do both
npm run update-all
Available Scripts
update-docs- Crawl and index documentation from all configured sourcesupdate-docs-script -- --source=<id>- Crawl a single source by IDupdate-docs-opa-guide- Fetch only the OPA mock server testing guideupdate-embeddings- Generate vector embeddings from indexed documentsupdate-all- Run both documentation indexing and embedding generation
Configuration
The module indexes documentation from these sources by default:
| Source ID | Description |
|---|---|
btp-fiori-tools | SAP-docs/btp-fiori-tools — Fiori Tools documentation |
sapui5 | SAP-docs/sapui5 — UI5 Fiori Elements documentation |
fiori-samples | SAP-samples/fiori-tools-samples — Sample applications |
fiori-showcase | SAP-samples/fiori-elements-feature-showcase — Feature examples |
tools-suite | ux-engineering/tools-suite — Internal Fiori Tools commands (requires GITHUB_TOKEN) |
fiori-tools-opa-guide | sap-tutorials/Tutorials — OPA mock server testing guide |
Environment Variables
GITHUB_TOKEN- GitHub personal access token (recommended to avoid rate limits)
Data Structure
Generated data is organized as:
data/
├── docs/ # Parsed documentation files
├── embeddings/ # Flat binary vector store (embeddings.bin, records.jsonl, metadata.json)
└── search/ # Search indexes
Features
- Multi-source indexing - Supports GitHub repositories and JSON APIs
- File type support - Markdown, JSON, TypeScript, JavaScript, XML, YAML, and more
- Vector embeddings - Uses
@huggingface/transformerswith theXenova/all-MiniLM-L6-v2model (q8 quantized) - Local storage - All data stored locally as a flat binary vector store (no native database dependency)
- Caching - Intelligent caching to avoid unnecessary API calls
- Chunking - Smart document chunking for optimal embedding generation
Development
# Install dependencies
npm install
# Run tests
npm test
# Check types
npm run build-compiler
# Clean generated files
npm run clean
License
Apache-2.0
History
Fixes 1
Notes
Patch Changes
Release Date
2026-10-05
Bug Fixes
- Replace opa5_docu.md and fiori-tools-opa-guide.md with OPA5 skill reference files as embeddings source [3c76112]
Fixes 1
Notes
Released: 2026-06-11T15:27:53Z
Patch Changes
- 4124656: Add OPA mock server testing guide as github-raw doc source and --source CLI flag for single-source builds
Features 1
Notes
Released: 2026-06-05T11:08:04Z
Minor Changes
- 9f33150: Replace @xenova/transformers with @huggingface/transformers 4.2.0.
Fixes 1
Notes
Released: 2026-06-03T14:58:37Z
Patch Changes
- 21a3de7: FIX: TypeScript type errors in test files (ESM migration follow-up)
Breaking 1
Notes
Released: 2026-05-30T20:54:07Z
Major Changes
-
32609a7: # Migration to ECMAScript Modules (ESM)
Packages in the SAP Open UX Tools monorepo have been migrated from CommonJS (CJS) to ECMAScript Modules (ESM) with NodeNext module resolution.
'@sap-ux/backend-proxy-middleware-cf' is experimental and will remain at major version 0. '@sap-ux/generator-odata-downloader' is a top level yeoman generator and will remain as CJS until validation as ESM is done.
What Changed
- Module System: Most packages now use native ESM (
"type": "module"in package.json) - TypeScript Configuration: Updated to
module: "NodeNext"andmoduleResolution: "NodeNext" - Import Statements: All relative imports now include explicit
.jsextensions (per ESM spec) - Build Output: Generated JavaScript files are now ESM modules
- Node.js Requirement: Minimum Node.js version remains >=22.x
Jest Configuration (for Testing)
If your project tests code that imports these packages, update your Jest configuration:
export default { extensionsToTreatAsEsm: ['.ts'], transform: { '^.+\\.ts$': ['ts-jest', { useESM: true }] } };And run Jest with:
NODE_OPTIONS='--experimental-vm-modules' jest - Module System: Most packages now use native ESM (
-
Fixes 1
Notes
Released: 2026-05-21T05:46:16Z
Patch Changes
- 12137f6: update doc for fiori extension
Features 1
Notes
Released: 2026-05-15T08:12:20Z
Minor Changes
- 72695e5: chore: drop Node 20 support as it is no longer maintained
Fixes 1
Notes
Released: 2026-05-14T12:51:22Z
Patch Changes
- 59537d3: chore: override sharp to >=0.33.5 to fix CI build on darwin-arm64
Fixes 1
Notes
Released: 2026-05-14T11:45:51Z
Patch Changes
- 50a8ba5: chore: fresh release after workflow updates
Fixes 1
Notes
Released: 2026-05-11T09:58:34Z
Patch Changes
- a5c05a8: Add additional guidance on the adding of extension in fiori
Fixes 1
Notes
Released: 2026-05-04T15:49:13Z
Patch Changes
- e4a2488: feat - docs - how to add extensions to odata v4 fiori elements
Fixes 1
Notes
Released: 2026-02-27T15:42:39Z
Patch Changes
-
ca2566b: Update fast-xml-parser
Issue: #37278
-
Fixes 1
Notes
Released: 2026-02-10T21:03:43Z
Patch Changes
- 3795bb2: Add Node.js engine requirement (>=20.x)
Fixes 1
Notes
Released: 2026-02-03T15:42:23Z
Patch Changes
- c3a1e07: fix: add documentation sources
Fixes 1
Notes
Released: 2026-01-30T16:18:20Z
Patch Changes
- 4eac0a7: Improve chunk creation to ensure code samples are not modified.
Fixes 1
Notes
Released: 2026-01-28T10:59:00Z
Patch Changes
- a686522: feat: add Fiori Tools commands and update total document count
Fixes 1
Notes
Released: 2026-01-23T17:12:38Z
Patch Changes
- c99758e: chore - Update embeddings docs from original sources for mcp server
Fixes 1
Notes
Released: 2026-01-12T09:10:27Z
Patch Changes
- d667a5e: fix: add repository field to package.json
Fixes 1
Notes
Released: 2025-12-15T10:50:50Z
Patch Changes
- 4ecfbe2: Chore - upgrade eslint devDependenies, convert to flat config and fix lint issues.
Fixes 1
Notes
Released: 2025-12-01T17:31:14Z
Patch Changes
- 7cb3db2: feat: enhance downloaded readme content for better chunking
Fixes 1
Notes
Released: 2025-11-13T12:25:56Z
Patch Changes
- 10eb73e: fix: use existing version of ux-ui5-tooling-README.md in case of download errors
Fixes 1
Notes
Released: 2025-11-11T19:29:27Z
Patch Changes
- a990ed6: feat: add @sap-ux/create/README.md as resource
Fixes 1
Notes
Released: 2025-11-05T06:53:42Z
Patch Changes
- cfe9c13: Add deep link to package and changelog to README.md
Features 1
Notes
Released: 2025-10-20T15:41:39Z
Minor Changes
- 27585ad: Pre-process document sources with LLM and to clean-up an optimize for RAG code generation.
Features 1
Notes
Released: 2025-10-15T11:11:41Z
Minor Changes
- e75b594: Add Fiori Development portal documentation to embeddings
Features 1
Notes
Released: 2025-10-09T12:00:16Z
Minor Changes
- b5b6c9c: Add FPM Development portal documentation to embeddings
Features 1
Notes
Released: 2025-10-06T11:26:22Z
Minor Changes
- b179405: Refactor doc search to return human readable results. Simplify search and doc indexing
Fixes 1
Notes
Released: 2025-09-18T23:50:28Z
Patch Changes
- 306561e: Fix publishing of embeddings package
Fixes 1
Notes
Released: 2025-09-17T14:22:31Z
Patch Changes
- a7b6272: Add doc_search tool to Fiori MCP server using data from embeddings module.
Others providing
Compare all 15 on the Documentation page →- abap2UI5 Playgroundabap2UI5 PlaygroundABAP in the editor on the left and the abap2UI5 app it builds on the right, both inside one browser tab: the framework is transpiled to JavaScript at build time and the class in the editor is compiled when Run is pressed.community org, abapIn-browser ABAP editor beside the abap2UI5 app it buildsfrom ABAP
- @cap-js/mcp-server@cap-js/mcp-serverSAP's MCP server for CAP development, run as cds-mcp: search_model searches the project's compiled CDS model, search_docs searches the CAP documentation indexed as embeddings on the developer's own machine.sap official, capMCP server for CAP development: model and docs searchfrom CAP
- mcp-sap-docsmcp-sap-docsAn MCP server over seventeen cloned SAP documentation repositories — ABAP keyword docs, capire, OpenUI5, Cloud SDK, BTP — searched with BM25 and prebuilt embeddings fused by reciprocal rank fusion.independent, capMCP server searching seventeen SAP documentation repositoriesfrom CAP
- sap-api-hub-mcpsap-api-hub-mcpA read-only MCP server over the SAP Business Accelerator Hub catalogue: categories, search, metadata, resources, specs and packages, reached as the caller's own SAP user.independent, btpRead-only MCP server over the SAP Business Accelerator Hubfrom BTP/BAIP
- sap-note-search-mcpsap-note-search-mcpAn MCP server over SAP Notes and Knowledge Base articles: search finds a note, fetch returns it whole, and a scripted browser does the S-user login the content sits behind.independent, btpMCP server searching and fetching SAP Notes and KBAsfrom BTP/BAIP
- sap-roadmap-mcpsap-roadmap-mcpAn MCP server over SAP Road Map Explorer, so an agent can read what SAP has announced as planned rather than inferring it from a release that has shipped.independent, btpMCP server over SAP Road Map Explorerfrom BTP/BAIP
- ui5-lib-diffui5-lib-diffA hosted app that lists what changed between two SAPUI5 or OpenUI5 versions from the UI5 API's change records, and publishes the same data as static JSON files at fixed paths for tools and agents.independent, ui5Hosted app listing changes between SAPUI5 or OpenUI5 versionsfrom UI5
- abap-docabap-docA Node.js command that reads an ABAP package and its sub-packages over ADT and writes one PDF documenting every object in it, with an LLM writing the prose.independent, abapNode.js command writing PDF documentation for an ABAP packagefrom ABAP
- sap-ai-docs-mcpsap-ai-docs-mcpAn MCP server with semantic search, category filtering and whole-page retrieval over SAP AI Core's documentation, from the SAP-docs/sap-artificial-intelligence repository.independent, btpMCP server with semantic search over SAP AI Core documentationfrom BTP/BAIP
- sap-btp-docs-mcpsap-btp-docs-mcpAn MCP server for semantic search over the SAP BTP documentation repository, filtered by area such as development, administration, integration or security, with full document retrieval.independent, btpMCP server with semantic search over SAP BTP documentationfrom BTP/BAIP
- Clean-Core.ioClean-Core.ioA free hosted workspace that reads one piece of custom ABAP, redraws its business process as BPMN with a line anchor on every element, grades the SAP objects it uses Level A–D and ends in a keep, rebuild, move-to-standard or retire decision.independent, abapHosted workspace redrawing custom ABAP as BPMN and grading itfrom ABAP
- abapdocs-code-scannerabapdocs-code-scannerReads the abapDoc comments of a class or interface's public methods and type definitions and returns their text at runtime.independent, abapReads the abapDoc comments of a class or interface's public methods and type definitions and returns their text at runtime.from ABAP
- @ui5/webcomponents-mcp-server@ui5/webcomponents-mcp-serverFour tools that answer an agent's questions about UI5 Web Components from the framework's own documentation — component API, integration guides, and the docs themselves.sap official, ui5MCP server answering questions on UI5 Web Componentsfrom UI5
- vscode-ui5-api-referencevscode-ui5-api-referenceVS Code extension that shows the SAPUI5 and OpenUI5 API reference in a side bar view, with inherited members, member filters and a favourites list, for one framework version at a time.independent, ui5VS Code side bar view of the SAPUI5 and OpenUI5 API referencefrom UI5
Details
Sources
Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.
Compatibility and provenance
Contributors
Show 61 more
History in the atlas
- Typed cds-plugin by placement, which defaults every candidate to that. It is not one.
- Fiori documentation indexed as embeddings, which is what makes it searchable by something other than a person scrolling it.
- First seen.
For your agent
- Ref
artifact:sap-ux-fiori-docs-embeddings- JSON
- /artifacts/sap-ux-fiori-docs-embeddings.json
- MCP
- Connecting an agent