{
  "id": "mavsdk-python-examples-mission-py",
  "name": "MAVSDK-Python gRPC examples: Mission upload and execution",
  "summary": "Construct, upload and start a mission with progress monitoring. Inspect exact upstream setup and terms before use.",
  "framework": "mavsdk-python",
  "kind": "official_example",
  "source_registry": "official-robot-workflows-v1",
  "capabilities": [
    "mission-control",
    "mission-upload"
  ],
  "robot_types": [
    "aerial"
  ],
  "robot_scope": "Protocol/example discovery classification only; exact model revision, firmware, payload, feature and runtime environment compatibility remain unknown.",
  "source": {
    "repository": "https://github.com/mavlink/MAVSDK-Python",
    "commit": "8fa280f1d7473524a32d061e60b7bb346ff65264",
    "tag": "main",
    "path": "examples/mission.py",
    "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/examples/mission.py",
    "raw_url": "https://raw.githubusercontent.com/mavlink/MAVSDK-Python/8fa280f1d7473524a32d061e60b7bb346ff65264/examples/mission.py",
    "sha256": "891197dce4f5fd64f1c5028f2f8d9d1f132c0b034b5321c59498b5baebb0beee",
    "bytes": 3626,
    "authors": [
      "MAVSDK Development Team",
      "Jonas Vautherin",
      "Julian Oes"
    ]
  },
  "license": {
    "spdx": "BSD-3-Clause",
    "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/LICENSE.txt",
    "sha256": "2e373f427edf94ffd33fdda4d055989605257c6880026496b06d04890394bd12",
    "scope": "Selected first-party Python example source under the MAVSDK Development Team BSD-3-Clause notice. Retain copyright, conditions and disclaimers. This source identity does not establish terms for separately obtained server binaries, autopilot firmware, hardware, payloads, maps, dependencies or services.",
    "bytes": 1494
  },
  "access": {
    "mode": "source_reference",
    "hub_prepare": false,
    "instructions": "Fetch the pinned repository, verify this source checksum, and use upstream installation and invocation. This record does not install or execute code.",
    "setup_url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/README.md",
    "setup_evidence": [
      {
        "path": "README.md",
        "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/README.md",
        "sha256": "91b743b172ca9ae1fdf09137a66e106b76962a75034807f244e2c344d85efae8",
        "bytes": 7585,
        "purpose": "Wrapper/import rename and setup"
      },
      {
        "path": "setup.py",
        "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/setup.py",
        "sha256": "5aed957f828c4a0769b08b45dc43a187487196a2035a5425641b6de61c5d7f56",
        "bytes": 10879,
        "purpose": "Maintainer, Python and binary build declarations"
      },
      {
        "path": "requirements.txt",
        "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/requirements.txt",
        "sha256": "157550c310aedd7a24e36e99e9b94167bd7daad5ca8afcbbd8b233b8c215d587",
        "bytes": 32,
        "purpose": "Declared dependencies"
      },
      {
        "path": "MAVSDK_SERVER_VERSION",
        "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/MAVSDK_SERVER_VERSION",
        "sha256": "d14fb8c93c85dcffcb1e04b4268226d056a2f56841bfe33578d316955d337116",
        "bytes": 7,
        "purpose": "Separate server binary version"
      }
    ]
  },
  "requirements": {
    "python": "Python >=3.7 as declared by pinned README/setup.py; support of separately declared dependencies remains unverified.",
    "packages": [
      "mavsdk-grpc (import mavsdk_grpc)",
      "protobuf>=6.32.1",
      "grpcio>=1.64.1"
    ],
    "display": "Configured MAVLink autopilot connection and working mavsdk_server required. Server version v4.0.5 is a binary declaration, not an autopilot firmware or Python distribution version. Airframe, firmware, payload and executable environment combinations remain unknown.",
    "execution_domain": "hardware-or-upstream-simulation",
    "source_imports": [
      "asyncio",
      "logging",
      "mavsdk_grpc",
      "mavsdk_grpc.mission"
    ],
    "notes": "Per-file package floors are declarations, not a tested combined runtime environment.",
    "declared_requirements": {
      "python": {
        "value": ">=3.7",
        "source": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/setup.py"
      },
      "dependency_file": {
        "path": "requirements.txt",
        "sha256": "157550c310aedd7a24e36e99e9b94167bd7daad5ca8afcbbd8b233b8c215d587",
        "bytes": 32,
        "url": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/requirements.txt",
        "literal_lines": [
          "protobuf>=6.32.1",
          "grpcio>=1.64.1"
        ]
      },
      "firmware": "unknown",
      "external_assets": "Server binaries/autopilot firmware/payloads for MAVSDK; robot firmware/features, camera data, maps/missions for Spot. Separate upstream terms and access requirements remain applicable.",
      "server_binary_version": {
        "value": "v4.0.5",
        "source": "https://github.com/mavlink/MAVSDK-Python/blob/8fa280f1d7473524a32d061e60b7bb346ff65264/MAVSDK_SERVER_VERSION",
        "meaning": "Server binary only, not Python distribution or autopilot firmware."
      },
      "vehicle_model": "unknown",
      "install_side_effects": "Upstream build downloads server binary; connect() can launch it. Neither performed."
    }
  },
  "invocation": {
    "entrypoint": "python examples/mission.py",
    "notes": "Use the pinned gRPC-wrapper setup: current sources import mavsdk_grpc, not the unrelated native mavsdk v4 binding. Upstream build may download mavsdk_server and connect() may launch it. Review selected connection addresses and motion/mission values. No installation, server, simulator or vehicle was run or contacted."
  },
  "popularity": {
    "metric": "github_stars",
    "repository_stars": 455,
    "checked_at": "2026-10-18",
    "meaning": "Dated repository interest, not robot-skill usage, compatibility or runtime success."
  },
  "evidence": {
    "level": "source_reviewed",
    "runtime_verification": "not_run",
    "checked_at": "2026-10-18",
    "inspection": "Verified exact source, applicable license and author/setup document bytes at a full Git commit; parsed the Python AST and reviewed this guarded operational entrypoint and its explicit license notices. No upstream code, installation, robot command, dataset, mesh or checkpoint was executed or loaded.",
    "entrypoint_kind": "python_main",
    "inspection_method": "automated_static",
    "limitations": [
      "Hard-coded connection/motion/mission data may query or change an autopilot when run upstream; this reference was never run."
    ]
  },
  "artifact": {
    "kind": "workflow",
    "format": "python",
    "workflow_role": "mission-control"
  }
}