Metadata-Version: 2.4
Name: agi-app-uav-relay-queue
Version: 2026.5.22
Summary: AGILAB UAV relay queue simulation demo with routing, delay, and resilience artifacts
Author: Jean-Pierre Morard
Maintainer: Jean-Pierre Morard
License-Expression: BSD-3-Clause
Project-URL: Documentation, https://thalesgroup.github.io/agilab
Project-URL: Source, https://github.com/ThalesGroup/agilab/tree/main/src/agilab/lib/agi-app-uav-relay-queue
Project-URL: Issues, https://github.com/ThalesGroup/agilab/issues
Project-URL: Homepage, https://github.com/ThalesGroup/agilab
Project-URL: Repository, https://github.com/ThalesGroup/agilab
Project-URL: Discussions, https://github.com/ThalesGroup/agilab/discussions
Project-URL: Changelog, https://github.com/ThalesGroup/agilab/releases
Keywords: agilab,apps,reproducibility,workflow-orchestration
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agi-core<2027.0,>=2026.05.13
Dynamic: license-file

# agi-app-uav-relay-queue

[![PyPI version](https://img.shields.io/pypi/v/agi-app-uav-relay-queue.svg?cacheSeconds=300)](https://pypi.org/project/agi-app-uav-relay-queue/)
[![Python versions](https://img.shields.io/pypi/pyversions/agi-app-uav-relay-queue.svg)](https://pypi.org/project/agi-app-uav-relay-queue/)
[![License: BSD 3-Clause](https://img.shields.io/pypi/l/agi-app-uav-relay-queue)](https://opensource.org/licenses/BSD-3-Clause)

`agi-app-uav-relay-queue` publishes the `uav_relay_queue_project` AGILAB app as
a self-contained PyPI payload. It demonstrates queue-aware relay selection with
analysis-ready routing artifacts.

## Purpose

Use this package to run a compact UAV relay scenario: one source, one sink, and
two relay choices with different delay and queue trade-offs. The run makes
relay choice, drops, packet delay, and queue depth visible in AGILAB.

## Installed Project

The distribution name is `agi-app-uav-relay-queue`; the AGILAB project name is
`uav_relay_queue_project`. The package exposes both `uav_relay_queue` and
`uav_relay_queue_project` through the `agilab.apps` entry point group, so
`AgiEnv(app="uav_relay_queue_project")` works without a monorepo checkout.

## Install

```bash
pip install agi-app-uav-relay-queue
```

Most users get this package through `agi-apps`, `agilab[ui]`, or
`agilab[examples]`; direct installation is useful when validating one app
package in isolation.

## Run In AGILAB

Select `uav_relay_queue_project`, open `ORCHESTRATE`, then run `INSTALL` and
`EXECUTE`. Inspect `view_relay_resilience`, `view_scenario_cockpit`, or
`view_maps_network` from `ANALYSIS`.

## Expected Inputs

The packaged project includes a small synthetic relay scenario. It does not
require a live network simulator, private telemetry, cluster, or cloud service
for the default proof.

## Expected Outputs

The run writes queue time series, packet events, relay routing summaries, node
positions, topology files, trajectory CSVs, reducer summaries, and hashed
baseline/candidate evidence bundles.

## Change One Thing

Adjust relay capacity or queue size, then rerun the app. The queue-resilience
view should show how delay, drops, and selected relay changed.

## Scope

This is a lightweight public demo. It does not implement a full external UAV
network simulator, production routing control traffic, or operational radio
modeling.
