---
id: genie-libs-clean
version: "26.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# genie.libs.clean — Genie Library for device clean support

License: permissive · Maintenance: active · Downloads: 268.8K/mo

## What it is and what it does

Genie Clean is a sub-component of the Genie test automation framework that handles device recovery and state setup. It provides reusable implementations to bring devices into a known, testable state before running test cases. The package is part of Cisco's pyATS ecosystem, which emphasizes data-driven, reusable testing patterns suitable for rapid development cycles.

The package works as a library within the Genie framework, which itself is built on the modular pyATS architecture. It depends on the core genie package plus standard Python build tools (setuptools and wheel). The implementation is designed for Linux and Mac environments running Python 3.4 or later, with a focus on enabling teams to scale from simple linear test cases to complex asynchronous test suites.

Use it for:

- Reset network devices to a baseline configuration before running test suites
- Automate device bring-up procedures as part of test fixture setup
- Implement reusable device recovery logic across multiple test scenarios
- Integrate device state management into Genie-based test automation workflows

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Genie Clean provides device recovery and state management implementations for the Genie test automation framework, enabling test setups to bring devices to a known testable state.

Yes, if you are building test automation on the Genie and pyATS framework. The package is actively maintained, carries no known vulnerabilities, has low install friction, and is licensed permissively. Install it only if you need device cleanup and state recovery as part of a Genie-based test harness; it is not a standalone tool.

## Install

pip install genie-libs-clean
uv add genie-libs-clean
poetry add genie-libs-clean

## Installing genie.libs.clean

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a release within the past week. Depends on setuptools, wheel, and genie.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install genie-libs-clean

import genie.libs.clean
# Use clean implementations to manage device state in test setup

Requires Python 3.4+ on Linux or Mac; Windows is not supported.

Verify before relying:

- Specific device types and platforms supported by the clean implementations
- API stability and backward compatibility guarantees across major versions
- Integration requirements with the broader pyATS ecosystem beyond the core genie dependency

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 268.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

device cleanup test automation, genie clean component, pyats device state recovery, test device setup harness, cisco genie testing, device bring-up automation, test fixture device reset, test-automation, device-management, cisco-pyats

[View on SkillFed](https://skillfed.io/packages/genie-libs-clean) · [View on PyPI](https://pypi.org/project/genie-libs-clean/)