Metadata-Version: 2.4
Name: huginn-framework
Version: 0.2.0
Summary: A Python-native, async-first test automation framework for network infrastructure, servers, and applications.
Author-email: Christopher Hart <christopherjhart95@gmail.com>, Andrea Testino <aitestino@gmail.com>
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: aiohttp<4.0.0,>=3.10.5
Requires-Dist: jinja2<4.0.0,>=3.1.0
Requires-Dist: markdown<4.0.0,>=3.4.0
Requires-Dist: pyyaml<7.0.0,>=6.0.2
Requires-Dist: ruamel-yaml<1.0.0,>=0.17.32
Requires-Dist: scrapli-netconf[asyncssh]>=2025.1.30
Requires-Dist: scrapli[asyncssh]>=2025.1.30
Requires-Dist: typer<1.0.0,>=0.9.0
Description-Content-Type: text/markdown

# Huginn

[![CI](https://github.com/ChartinoLabs/Huginn/actions/workflows/ci.yml/badge.svg)](https://github.com/ChartinoLabs/Huginn/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/huginn-framework?logo=pypi&logoColor=white)](https://pypi.org/project/huginn-framework/)
[![Python](https://img.shields.io/badge/python-%3E%3D3.11-blue?logo=python&logoColor=white)](https://www.python.org)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)

A Python-native, async-first test automation framework for network infrastructure, servers, and applications.

## Overview

Huginn is designed for skilled test engineers who need to validate infrastructure state at scale. Named after one of Odin's ravens who flies across the world gathering information, Huginn dispatches tests to observe your infrastructure, gather state, and report findings. The framework maintains a minimal core with optional plugins, handles test orchestration and connection management, and supports dual execution modes: learning current state from live infrastructure and testing against previously-learned parameters.

## Installation

```bash
pip install huginn-framework
```

Or using [uv](https://docs.astral.sh/uv/):

```bash
uv add huginn-framework
```

Requires Python 3.11 or later. See the [documentation](https://chartinolabs.github.io/Huginn/) for a full quickstart guide.

## License

Licensed under the Apache License 2.0.
