Metadata-Version: 2.4
Name: maestro-api
Version: 0.1.0
Summary: Maestro backend API for the Headlamp plugin.
Author-email: Alexander Burmatov <thatman@altlinux.org>, Alexey Kostarev <kaf@altlinux.org>, Vladislav Tsarev <tyaplyapych@altlinux.org>
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: Flask<4.0,>=3.0
Requires-Dist: Flask-Cors<5.0,>=4.0
Requires-Dist: PyYAML<7.0,>=6.0

# Maestro API

Backend API for the Maestro Headlamp plugin.

## Requirements

- Python 3.11+
- System binaries: `talosctl`, `nmap`

## Setup

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .
```

Alternative (system + venv bootstrap):

```bash
./scripts/install.sh
```

## Run

```bash
maestro-api
```

or:

```bash
./scripts/start.sh
```

## Configuration

Environment variables:

- `MAESTRO_API_HOST` (default: `127.0.0.1`)
- `MAESTRO_API_PORT` (default: `5000`)
- `MAESTRO_API_DEBUG` (default: `false`)
- `MAESTRO_CORS_ORIGINS` (default: `*`)
- `MAESTRO_TALOS_COMMAND_TIMEOUT_SECONDS` (default: `30.0`)
- `MAESTRO_NMAP_COMMAND_TIMEOUT_SECONDS` (default: `120.0`)
- `MAESTRO_PORT_CHECK_TIMEOUT_SECONDS` (default: `3.0`)

Example file: `env.example`
