mkdocs.yml

site_name: Roboflow Inference
site_url: https://inference.roboflow.com/
site_author: Roboflow
site_description: Scalable, on-device computer vision deployment.
repo_name: roboflow/inference
repo_url: https://github.com/roboflow/inference
edit_uri: https://github.com/roboflow/inference/tree/main/docs
copyright: Roboflow 2026. All rights reserved.

exclude_docs: |
  node_modules/

extra:
  analytics:
    provider: google
    property: G-T0CED2YY8K
  generator: false
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/roboflow
    - icon: fontawesome/brands/youtube
      link: https://www.youtube.com/roboflow
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/roboflow-ai/mycompany/
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/roboflow
  version:
    default: 1.0

extra_css:
  - styles/cookbooks.css
  - styles.css

nav:
  - Start:
      - Overview: start/overview.md
      - Understand:
          - Architecture: understand/architecture.md
          - Features: understand/features.md
          - Vocabulary: understand/vocabulary.md
          - Alternatives: understand/alternatives.md
      - Cloud Hosting:
          - "Cloud Hosting": managed/index.md
          - "Serverless API »": "https://docs.roboflow.com/deploy/serverless-hosted-api-v2"
          - "Dedicated Deployments »": "https://docs.roboflow.com/deploy/dedicated-deployments"
          # - "Bring Your Own Cloud": "install/cloud/index.md"
      - Self Hosting:
          - "Self Hosting": install/index.md
          - Minimum Requirements: install/minimum-requirements.md
          - Install on Linux: install/linux.md
          - Install on Windows: install/windows.md
          - Install on Mac: install/mac.md
          - Install on Jetson: install/jetson.md
          - Install on Raspberry Pi: install/raspberry-pi.md
          - Bring Your Own Cloud:
              - install/cloud/index.md
              - AWS: install/cloud/aws.md
              - Azure: install/cloud/azure.md
              - GCP: install/cloud/gcp.md
          - Other Devices: install/other.md
      # - Inputs:
      #     - inputs/index.md
      #     - Images: inputs/images.md
      #     - Webcam: inputs/webcam.md
      #     - IP Camera (RTSP):
      #         - inputs/rtsp/index.md
      #         - Reolink: inputs/rtsp/reolink.md
      #         - UniFi: inputs/rtsp/unifi.md
      #     - Recorded Video: inputs/video.md
      #     - Industrial:
      #         - inputs/industrial/index.md
      #         - Basler: inputs/industrial/basler.md
      #         - Lucid: inputs/industrial/lucid.md
      #         - FLIR: inputs/industrial/flir.md

      - Tutorials:
          - Hello World: guides/hello-world.md
          - Compare Models: guides/compare-models.md
          - Detect Small Objects: guides/detect-small-objects.md
          # - Count Things in Video: guides/count-things.md

      - More Resources: resources.md

  - Models:
      # - models.md # Was once the landing page for inference
      - Run a Model: quickstart/run_a_model.md
      - 'Fine-Tuned Models':
          - quickstart/explore_models.md
          - RF-DETR: fine-tuned/rfdetr.md
          - YOLO26: fine-tuned/yolo26.md
          - YOLOv11: fine-tuned/yolov11.md
          - YOLOv10: fine-tuned/yolov10.md
          - YOLOv9: fine-tuned/yolov9.md
          - YOLOv8: fine-tuned/yolov8.md
          - YOLOv7: fine-tuned/yolov7.md
          - YOLOv5: fine-tuned/yolov5.md
          - YOLO-NAS: fine-tuned/yolonas.md
      - 'Pre-Trained Models': quickstart/aliases.md
      - 'Universe Models': quickstart/load_from_universe.md
      - 'Foundation Models':
          - foundation/about.md
          - CLIP (Classification, Embeddings): foundation/clip.md
          - DocTR (OCR): foundation/doctr.md
          - Depth Estimation (Depth Anything V2 Small): foundation/depth_estimation.md
          - Florence-2: foundation/florence2.md
          - TrOCR (OCR): foundation/trocr.md
          - Grounding DINO (Object Detection): foundation/grounding_dino.md
          - L2CS-Net (Gaze Detection): foundation/gaze.md
          - Moondream2: foundation/moondream2.md
          - PaliGemma: foundation/paligemma.md
          - Perception Encoder: foundation/perception_encoder.md
          - Segment Anything (Segmentation): foundation/sam.md
          - Segment Anything 2 (Segmentation): foundation/sam2.md
          - Segment Anything 3 (Segmentation): foundation/sam3.md
          - SmolVLM2: foundation/smolvlm.md
          - YOLO-World (Object Detection): foundation/yolo_world.md
          - OwlV2 (Object Detection): foundation/owlv2.md
      - Deploy a Model:
          - How Do I Run Inference?: quickstart/inference_101.md
          - What Devices Can I Use?: quickstart/devices.md
          - Retrieve Your API Key: quickstart/configure_api_key.md
          - Model Licenses: https://roboflow.com/licensing
  - Workflows:
      - About Workflows: workflows/about.md
      - User Guide:
        - Ecosystem: workflows/understanding.md
        - Create And Run: workflows/create_and_run.md
        - Blocks Overview: workflows/blocks_connections.md
        - Running Workflows: workflows/modes_of_running.md
        - Dynamic Python Blocks: workflows/custom_python_code_blocks.md
        - Video Processing: workflows/video_processing/overview.md
      - Examples: workflows/gallery/
      - Block Gallery: workflows/blocks/
      - Batch Processing:
          - User Guide: workflows/batch_processing/about.md
          - Integration: workflows/batch_processing/integration.md
          - Debugging: workflows/batch_processing/known_issues.md
          - API Reference: workflows/batch_processing/api_reference.md
      - Developer Guide:
        - Workflows Definitions: workflows/definitions.md
        - Workflow Execution: workflows/workflow_execution.md
        - Kinds: workflows/kinds/
        - Compiler: workflows/workflows_compiler.md
        - Execution Engine: workflows/workflows_execution_engine.md
        - Block Creation: workflows/create_workflow_block.md
        - Block Bundling: workflows/blocks_bundling.md
        - Data Representations: workflows/internal_data_types.md
        - Versioning: workflows/versioning.md
        - Testing: workflows/testing.md
        - Schema API: workflows/schema_api.md
        - Changelog: workflows/execution_engine_changelog.md
      - Benchmarks: workflows/benchmarks.md
  - Reference:
      - Inference SDK:
          - About: inference_helpers/inference_sdk.md
          - Configuration: inference_helpers/inference_sdk/configuration.md
          - Core Models: inference_helpers/inference_sdk/core_models.md
          - Model Management: inference_helpers/inference_sdk/model_management.md
          - Workflows: inference_helpers/inference_sdk/workflows.md
          - Reference: reference/inference_sdk/
      - Inference CLI:
          - About: inference_helpers/inference_cli.md
          - Control The Server: inference_helpers/cli_commands/server.md
          - Run Workflows: inference_helpers/cli_commands/workflows.md
          - Benchmark Inference: inference_helpers/cli_commands/benchmark.md
          - Make Predictions: inference_helpers/cli_commands/infer.md
          - Deploy To Cloud: inference_helpers/cli_commands/cloud.md
          - Reference: reference/inference_cli/
      - Inference Server:
          - About: quickstart/docker.md
          - Docker Configuration Options: quickstart/docker_configuration_options.md
          - Environmental variables: server_configuration/environmental_variables.md
          - Security of input formats: server_configuration/accepted_input_formats.md
          - Service telemetry: server_configuration/service_telemetry.md
          - Install "bare metal" Inference GPU on Windows: quickstart/inference_gpu_windows.md
          - Enterprise Features:
              - Parallel HTTP API: enterprise/parallel_processing.md
              - Stream Management API: enterprise/stream_management_api.md
          - OpenAPI Spec: api.md
      - Inference Python Package:
        - About: using_inference/about.md
        - InferencePipeline: using_inference/inference_pipeline.md
        - Model Weights Download: using_inference/offline_weights_download.md
        - Benchmarks: using_inference/benchmarks.md
        - Reference: reference/inference/
      - Contribute »: https://github.com/roboflow/inference/blob/main/CONTRIBUTING.md
      - Changelog »: https://github.com/roboflow/inference/releases

theme:
  name: 'material'
  logo: roboflow-logomark-color.svg
  favicon: favicon.png
  custom_dir: theme
  font:
    text: Inter
    code: ui-monospace
  features:
    - announce.dismiss
    - content.action.edit
    - content.code.copy
    - content.tabs.link
    - navigation.footer
    - navigation.indexes
    - navigation.instant
    - navigation.instant.prefetch
    - navigation.instant.preview
    - navigation.instant.progress
    - navigation.prune
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - navigation.tracking
    - optimize
    - search.share
    - search.suggest
    - toc.follow
  icon:
    repo: fontawesome/brands/github
  palette:
    - scheme: default
      primary: 'custom'

plugins:
  - mkdocstrings:
      handlers:
        python:
          paths: [.]
          options:
            show_root_heading: true
            show_bases: true
            group_by_category: true
            show_category_heading: true
            docstring_style: google
            show_symbol_type_heading: true
            separate_signature: true
  - search
  - mkdocs-jupyter
  - social
  - ezlinks
  - gen-files:
      scripts:
        - docs/scripts/gen_ref_pages.py
  - literate-nav:
      nav_file: SUMMARY.md
      implicit_index: False
  - macros:
      include_dir: docs/include
      module_name: docs/scripts/macros


markdown_extensions:
  - meta
  - admonition
  - attr_list
  - md_in_html
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.snippets:
      base_path: docs
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - toc:
      permalink: true


extra_javascript:
  - "https://cdnjs.cloudflare.com/ajax/libs/dompurify/3.0.8/purify.min.js"
  - 'javascript/init_kapa_widget.js'
  - 'javascript/cookbooks.js'
  - 'javascript/workflows.js'
  - 'https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js'
  - 'https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js'
  - 'https://unpkg.com/@rive-app/canvas'
  - 'https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js'
  - 'assets/home.js'
  - 'js/segment.js'

hooks:
  - theme/build.py