docs-kit 0.1.1__tar.gz

docs_kit-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v

docs_kit-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,79 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  smoke-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install package
+        run: pip install -e ".[sse]" build twine "hatchling<1.27"
+
+      - name: Run smoke test
+        run: |
+          python -m docs_kit --help
+          TMP_DIR="$(mktemp -d)"
+          python -m docs_kit init --dir "$TMP_DIR"
+          test -f "$TMP_DIR/docs-kit.yaml"
+          python -m docs_kit doctor --config "$TMP_DIR/docs-kit.yaml"
+
+      - name: Build artifacts
+        run: python -m build --no-isolation
+
+      - name: Check artifacts
+        run: python -m twine check dist/*
+
+  build:
+    needs: smoke-test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build twine "hatchling<1.27"
+
+      - name: Build
+        run: python -m build --no-isolation
+
+      - name: Check artifacts
+        run: python -m twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

docs_kit-0.1.1/.gitignore

@@ -0,0 +1,15 @@
+.claude/
+__pycache__/
+*.pyc
+.pytest_cache/
+.qdrant/
+.venv/
+dist/
+build/
+coverage/
+.DS_Store
+.worktrees/
+.docs-kit/
+downloaded-docs/
+/release-patch-pypi.sh
+docs/

docs_kit-0.1.1/AGENTS.md

@@ -0,0 +1,64 @@
+# docs-kit — Agent Instructions
+
+## Scope
+
+This document applies to AI agents working on the **docs-kit** codebase: a **PyPI** package (and optional **npx** wrapper) that **fetches GitBook documentation**, **stores and embeds it locally** (markdown on disk + Qdrant), and **exposes retrieval via an MCP server** for **Claude Code**, **Claude Desktop**, **Cursor**, and other MCP-aware tools.
+
+---
+
+## What the product does
+
+1. **Fetch** — `GitBookFetcher` uses `/llms-full.txt` or `/llms.txt` on a public GitBook base URL.
+2. **Local storage** — `docs-kit fetch` writes `.md` files; `docs-kit ingest` chunks, embeds with FastEmbed, and upserts into local Qdrant.
+3. **MCP** — `docs-kit serve` runs tools: `search_docs`, `list_sources`, `get_collection_info`, `get_full_document`.
+4. **Install** — `docs-kit install` merges an `mcpServers.docs-kit` entry into agent settings for `claude-code`, `claude-desktop`, or `cursor`.
+
+The **npx** package under `npx-wrapper/` only ensures Python 3.11+ and installs/runs the **`docs-kit`** Python module; behavior lives in Python.
+
+---
+
+## Security (Non-Negotiable)
+
+- **MUST NOT** read, access, or reference `.env`, `.env.local`, `.env.*`, or any secret/credentials files.
+- **MUST NOT** recommend reading environment files. If config is needed, ask the user for non-sensitive details.
+- **MUST** treat `.env` files as if they do not exist.
+
+---
+
+## Verification After Changes
+
+From the repository root:
+
+```bash
+pytest tests/ -v
+```
+
+- **MUST NOT** claim work is complete without a successful test run when behavior or dependencies changed.
+
+---
+
+## Git Commit Workflow
+
+When the user asks to commit, stage, or write a commit message:
+
+1. **MUST** analyze staged/unstaged changes via `git status` and `git diff` in the relevant git root.
+2. **MUST** write a commit message following Conventional Commits:
+   - `feat:` — new feature
+   - `fix:` — bug fix
+   - `chore:` — maintenance, deps, config
+   - `docs:` — documentation only
+   - `style:` — formatting, no logic change
+   - `refactor:` — code restructure
+   - `test:` — tests only
+   - `perf:` — performance
+3. **SHOULD** keep subject line under 50 chars, imperative mood; use bullet points in body.
+4. **SHOULD** suggest splitting into atomic commits if changes span unrelated concerns.
+
+---
+
+## Project Context (Brief)
+
+- **Package name:** `docs-kit` (import `docs_kit`, CLI `docs-kit`).
+- **Main types:** `DocsKitConfig`, `DocsKitAgent` (`docs_kit/agent.py`); MCP in `docs_kit/mcp/server.py`.
+- **CLI:** `docs_kit/cli/commands.py` — `init`, `fetch`, `ingest`, `serve`, `install`, `query`, `inspect`, `doctor`.
+- **Docs:** [README.md](README.md) for user-facing quickstart and command table.

docs_kit-0.1.1/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-16
+
+### Added
+
+- `DocsKitAgent` high-level Python API: `ingest()`, `query()`
+- CLI: `docs-kit init`, `fetch`, `ingest`, `serve`, `install`, `query`, `inspect`, `doctor`
+- GitBook fetch via `/llms-full.txt` / `/llms.txt` and linked pages
+- Local embeddings with FastEmbed (dense + sparse/BM25)
+- Vector store: Qdrant (local path or remote URL)
+- Document parsers: `.txt`, `.md`
+- `DocsKitConfig` with YAML and environment variable support
+- MCP server tools: `search_docs`, `list_sources`, `get_collection_info`, `get_full_document`
+- `docs-kit.yaml` annotated example config
+- GitHub Actions CI (Python 3.11, 3.12) and publish pipeline (TestPyPI → PyPI)

docs_kit-0.1.1/CLAUDE.md

@@ -0,0 +1,85 @@
+# docs-kit — Project Memory
+
+## Project Overview
+
+**docs-kit** is a distributable toolkit (PyPI **`docs-kit`**, optional **npm/npx** wrapper) that:
+
+1. **Pulls** documentation from public **GitBook** sites via AI-oriented endpoints (`/llms-full.txt` or `/llms.txt` and linked pages).
+2. **Stores** content locally — either as downloaded `.md` files (`docs-kit fetch`) or in a **local Qdrant** vector store after embedding (`docs-kit ingest`).
+3. **Ingests** with **local embeddings** (FastEmbed by default; no API keys required for embeddings).
+4. **Serves** an **MCP (Model Context Protocol) server** so **Claude Code**, **Claude Desktop**, **Cursor**, and other MCP-capable agents can query the knowledge base (`search_docs`, `list_sources`, `get_collection_info`, `get_full_document`).
+5. **Installs** MCP wiring via `docs-kit install claude-code | claude-desktop | cursor`.
+
+**Pitch:** Point at any public GitBook docs, embed locally, expose them to your coding agents through MCP.
+
+**Target:** Developers who want product/docs RAG in the agent loop without shipping docs to a remote embedding API.
+
+---
+
+## Distribution
+
+| Channel | What it is |
+|---------|------------|
+| **PyPI** | Canonical install: `pip install docs-kit`. CLI entry: `docs-kit`. |
+| **npm/npx** | `npx-wrapper/` — thin Node shim that ensures Python 3.11+ and `pip install docs-kit`, then runs `python -m docs_kit …`. |
+
+---
+
+## Repo Structure
+
+| Path | Purpose |
+|------|---------|
+| `docs_kit/` | Python package: `DocsKitAgent`, GitBook fetcher, parsers, FastEmbed, Qdrant store, MCP server, Click CLI |
+| `docs_kit/cli/` | CLI (`docs-kit init`, `fetch`, `ingest`, `serve`, `install`, `query`, `inspect`, `doctor`) |
+| `docs_kit/mcp/` | FastMCP server (`stdio` default; `sse` with optional deps) |
+| `docs_kit/connectors/fetchers/gitbook.py` | GitBook `llms-full.txt` / `llms.txt` fetch |
+| `npx-wrapper/` | npm package wrapping the Python CLI |
+| `tests/` | pytest suite |
+| `data/sample_docs/` | Sample markdown for local ingest tests |
+
+---
+
+## Tech Stack
+
+- **Python** ≥ 3.11, **Click**, **Pydantic** / **pydantic-settings**, **httpx**, **PyYAML**
+- **Embeddings:** FastEmbed (local)
+- **Vector store:** Qdrant (local path, e.g. `.docs-kit/qdrant` in config)
+- **MCP:** `mcp` + FastMCP; optional **uvicorn** / **starlette** for SSE (`docs-kit[sse]`)
+
+---
+
+## Security & Privacy
+
+- **NEVER** touch `.env`, `.env.local`, `.env.*`, or other secret/credentials files. Treat them as if they do not exist.
+- **NEVER** read, access, reference, or recommend reading environment or secret files.
+- **ALWAYS** work on `.env.example` when documenting or adding environment variables — use placeholder values only.
+- If config is needed, ask the user for non-sensitive details.
+
+---
+
+## Build & Verification
+
+From the project root (where `pyproject.toml` lives):
+
+```bash
+pytest tests/ -v
+```
+
+After substantive changes, run the full test suite before claiming completion.
+
+---
+
+## Git Commits
+
+- **MUST** write descriptive commit messages using [Conventional Commits](https://www.conventionalcommits.org/): `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `perf`.
+- **SHOULD** keep subject line under 50 characters, imperative mood; use bullet points in body for context.
+
+---
+
+## Key Paths & Commands
+
+- **Config:** `docs-kit.yaml` (from `docs-kit init`) — embedding model, Qdrant `local_path`, MCP transport/port.
+- **Fetch only:** `docs-kit fetch <gitbook-url> --output docs-kit-docs`
+- **Ingest URL or path:** `docs-kit ingest https://example.gitbook.io/docs` or `docs-kit ingest ./path/to/markdown`
+- **MCP:** `docs-kit serve` (stdio); SSE requires `docs-kit[sse]` and config/flags for `sse`.
+- **Agent setup:** `docs-kit install claude-code` (optional `--project` for project-level Claude Code).

docs_kit-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,67 @@
+# Contributing to docs-kit
+
+Thank you for contributing! This guide covers project layout and common extension points.
+
+## Project structure
+
+```text
+docs_kit/
+  agent.py              # DocsKitAgent; parser registry (_PARSERS); component wiring
+  core/
+    config.py           # DocsKitConfig (pydantic-settings)
+    models.py           # Document, Chunk, RetrievedChunk
+    chunking.py         # Text/markdown chunking
+  connectors/
+    fetchers/           # GitBook and other doc sources (base + gitbook)
+    embeddings/         # Embedding backends (FastEmbed)
+    parsers/            # Document loaders (text, markdown)
+    vector_stores/      # Qdrant store
+  cli/
+    commands.py         # Click commands
+    __main__.py         # CLI entry point
+  mcp/                  # MCP server (tools, stdio/SSE)
+tests/                  # pytest tests (mirror docs_kit/ where useful)
+npx-wrapper/            # optional npm/npx shim to the Python CLI
+```
+
+## Adding a new document parser
+
+1. Implement a loader subclassing `BaseLoader` in `docs_kit/connectors/parsers/`.
+2. Register the file extension in `_PARSERS` in `docs_kit/agent.py` (dotted import path to the class).
+
+## Adding a new embedding provider
+
+1. Implement the dense (and if needed sparse) API following `docs_kit/connectors/embeddings/base.py`.
+2. Extend the `embedding.provider` branch in `DocsKitAgent._init_components()` in `docs_kit/agent.py`.
+3. Extend `DocsKitConfig` / YAML schema in `docs_kit/core/config.py` if new settings are required.
+4. Add optional dependencies in `pyproject.toml` if the provider needs extra packages.
+
+## Adding a new vector store
+
+1. Implement `BaseVectorStore` in `docs_kit/connectors/vector_stores/`.
+2. Extend the `vector_store.provider` branch in `DocsKitAgent._init_components()` and add config fields as needed.
+
+## Adding a new doc source (fetcher)
+
+1. Subclass `BaseFetcher` in `docs_kit/connectors/fetchers/`.
+2. Wire the new source into the CLI `fetch` / `ingest` paths in `docs_kit/cli/commands.py` (and any agent helpers) following the GitBook pattern.
+
+## Running tests
+
+**On macOS (to avoid arm64/x86_64 Rosetta issues):**
+
+```bash
+arch -arm64 .venv/bin/python -m pytest tests/ -v
+```
+
+**On Linux / CI:**
+
+```bash
+pytest tests/ -v
+```
+
+## Submitting a PR
+
+- Branch name: `feat/<topic>` or `fix/<description>`
+- Run the full test suite before opening the PR
+- New connectors or fetchers should include tests where practical

docs_kit-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Docs Kit Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs_kit-0.1.1/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.3
+Name: docs-kit
+Version: 0.1.1
+Summary: Fetch docs, embed locally, expose via MCP for AI agents.
+License: MIT License
+        
+        Copyright (c) 2026 Docs Kit Limited
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: fastembed>=0.6.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic-settings>=2.2.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: qdrant-client>=1.10.0
+Requires-Dist: tomli-w>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: starlette>=0.36.0; extra == 'dev'
+Requires-Dist: uvicorn>=0.27.0; extra == 'dev'
+Provides-Extra: sse
+Requires-Dist: starlette>=0.36.0; extra == 'sse'
+Requires-Dist: uvicorn>=0.27.0; extra == 'sse'
+Description-Content-Type: text/markdown
+
+# docs-kit
+
+[![PyPI version](https://img.shields.io/pypi/v/docs-kit)](https://pypi.org/project/docs-kit/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/pypi/pyversions/docs-kit)](https://pypi.org/project/docs-kit/)
+[![CI](https://github.com/docs-kit/docs-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/docs-kit/docs-kit/actions/workflows/ci.yml)
+
+Fetch docs from GitBook, Mintlify, or local files, embed them locally, and expose retrieval to AI tools over MCP.
+
+No API keys are required for the default local embedding path.
+
+## What it does
+
+- Fetches public docs from GitBook and Mintlify sites via `llms-full.txt` / `llms.txt` (with sitemap.xml fallback for Mintlify)
+- Ingests local `.md` and `.txt` files
+- Stores vectors in local Qdrant by default
+- Serves an MCP server over `stdio` or SSE
+- Exposes MCP tools to ingest, remove, and list sources at runtime
+- Installs MCP config for supported AI clients
+
+## Install
+
+```bash
+pip install docs-kit
+```
+
+Or with `npx`:
+
+```bash
+npx docs-kit ingest https://docs.example.com
+```
+
+## Quickstart
+
+```bash
+# 1. Create a config file
+docs-kit init
+
+# 2. Ingest docs (GitBook or Mintlify — auto-detected)
+docs-kit ingest https://docs.elevenlabs.io
+
+# 3. Check the collection
+docs-kit inspect
+
+# 4. Install into your client
+docs-kit install claude-code
+```
+
+## Commands
+
+### `docs-kit init`
+
+Create `docs-kit.yaml`.
+
+```bash
+docs-kit init
+docs-kit init --dir ./sandbox
+```
+
+### `docs-kit ingest <path-or-url>`
+
+Ingest a local file, directory, or documentation URL into the vector store. Supports GitBook and Mintlify sites out of the box — auto-detected by default.
+
+```bash
+docs-kit ingest ./docs
+docs-kit ingest https://docs.example.com
+docs-kit ingest https://docs.mintlify-site.com --provider mintlify
+docs-kit ingest https://docs.gitbook-site.com --provider gitbook
+docs-kit ingest ./docs --recreate
+```
+
+`--provider` accepts `auto` (default), `gitbook`, or `mintlify`. In `auto` mode, the fetcher tries `/llms-full.txt` → `/llms.txt` → `/sitemap.xml` in order.
+
+### `docs-kit fetch <url>`
+
+Download GitBook docs as Markdown without ingesting them.
+
+```bash
+docs-kit fetch https://docs.example.com
+docs-kit fetch https://docs.example.com --output ./downloaded-docs
+```
+
+### `docs-kit serve`
+
+Run the MCP server. `stdio` is the default. Use SSE for HTTP clients.
+
+```bash
+docs-kit serve
+docs-kit serve --transport sse --port 3001
+docs-kit serve --config ./docs-kit.yaml
+```
+
+### `docs-kit install <agent>`
+
+Install docs-kit into a supported client config.
+
+```bash
+docs-kit install claude-code
+docs-kit install codex
+docs-kit install claude-code --project
+docs-kit install cursor --config ./docs-kit.yaml
+```
+
+### `docs-kit query <text>`
+
+Run retrieval directly from the CLI.
+
+```bash
+docs-kit query "How do I authenticate?"
+docs-kit query "getting started" --limit 3
+```
+
+### `docs-kit inspect`
+
+Show collection and embedding configuration details.
+
+```bash
+docs-kit inspect
+docs-kit inspect --config ./docs-kit.yaml
+```
+
+### `docs-kit doctor`
+
+Check environment variables, config presence, and Qdrant connectivity.
+
+```bash
+docs-kit doctor
+docs-kit doctor --config ./docs-kit.yaml
+```
+
+### `docs-kit list`
+
+List ingested sources with their ingestion timestamps.
+
+```bash
+docs-kit list
+docs-kit list --config ./docs-kit.yaml
+```
+
+### `docs-kit remove <source>`
+
+Remove an ingested source by URL or file path.
+
+```bash
+docs-kit remove https://docs.example.com/page
+docs-kit remove ./docs/getting-started.md
+```
+
+## MCP Tools
+
+When connected to an MCP client, docs-kit exposes:
+
+| Tool | Description |
+|------|-------------|
+| `search_docs(query, limit=5)` | Hybrid dense + BM25 retrieval |
+| `list_sources()` | List all ingested source URLs/paths |
+| `list_ingested_sources()` | List sources with ingestion timestamps |
+| `get_collection_info()` | Collection stats (exists, point count) |
+| `get_full_document(source)` | Retrieve full stored document by source |
+| `ingest_urls(urls, provider="auto")` | Ingest comma-separated URLs at runtime |
+| `remove_source(source)` | Remove a source and all its chunks |
+
+## Install Targets
+
+Local config install is supported for:
+
+- `claude-code`
+- `claude-desktop`
+- `cursor`
+- `codex`
+
+Codex aliases:
+
+- `codex-app`
+
+ChatGPT aliases are accepted for guidance only:
+
+- `chatgpt`
+- `chatgpt-desktop`
+
+`chatgpt` and `chatgpt-desktop` do not currently use a local stdio config written by this command. The installer prints guidance for the current OpenAI flow, which uses remote MCP apps/connectors in ChatGPT settings.
+
+## Configuration
+
+`docs-kit.yaml` created by `docs-kit init`:
+
+```yaml
+embedding:
+  provider: fastembed
+  model: BAAI/bge-small-en-v1.5
+
+vector_store:
+  provider: qdrant
+  local_path: .docs-kit/qdrant
+  collection_name: knowledge_base
+
+ingestion:
+  chunk_size: 800
+  chunk_overlap: 120
+  bm25_model: Qdrant/bm25
+
+mcp:
+  transport: stdio
+  host: localhost
+  port: 3001
+```
+
+## Supported Sources
+
+| Source | Strategy |
+|--------|----------|
+| GitBook sites | `/llms-full.txt` → `/llms.txt` |
+| Mintlify sites | `/llms-full.txt` → `/llms.txt` → `/sitemap.xml` |
+| Local `.md` files | Direct file read |
+| Local `.txt` files | Direct file read |
+
+Both GitBook and Mintlify support the [`llms.txt` standard](https://llmstxt.org), so in most cases the same auto strategy works for both. The Mintlify fetcher adds a `/sitemap.xml` fallback for sites where `llms.txt` is disabled.
+
+## Requirements
+
+- Python 3.11+
+- Disk space for the local embedding model download
+- Local Qdrant storage under `.docs-kit/` by default