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

# genie.libs.filetransferutils — Genie libs FileTransferUtils: Genie FileTransferUtils Libraries

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

## What it is and what it does

genie.libs.filetransferutils is a sub-component of Genie, Cisco's test automation framework built on pyATS. It provides utility functions to transfer files to and from servers, abstracting away the details of different transfer protocols (FTP, TFTP, SSH) so test automation code can move files between test hosts and network devices without reimplementing protocol logic. The package is designed to integrate with Genie's broader test harness and object-oriented automation model.

It ships as a pure Python wheel with low installation friction and depends on protocol-specific libraries (pyftpdlib for FTP server support, tftpy for TFTP, asyncssh for SSH) plus unicon for device connectivity. The package is actively maintained and carries no known security vulnerabilities. It targets developers writing test automation for network infrastructure, where moving configuration files, firmware images, or logs between test systems and devices is a common task.

Use it for:

- Transfer configuration files to network devices via TFTP or FTP during test setup phases
- Retrieve log files or diagnostic data from devices over SSH after test execution
- Automate firmware or image uploads to switches, routers, or other network hardware
- Move test data files between test orchestration servers and remote test agents
- Integrate file transfer operations into larger pyATS test suites without external tooling

## Worth the install?

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

Provides utility functions for transferring files to and from servers as part of the Genie test automation framework, supporting protocols like FTP, TFTP, and SSH.

Yes, if you are building test automation on Genie/pyATS for network infrastructure. It provides a clean abstraction over file transfer protocols (FTP, TFTP, SSH) that would otherwise require separate protocol libraries and boilerplate. Active maintenance, permissive licensing, low install friction, and zero known vulnerabilities support adoption. Not relevant outside the Genie/pyATS ecosystem.

## Install

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

## Installing genie.libs.filetransferutils

Before you install: Low friction installation as a pure Python wheel. Actively maintained with a release within the past week. Depends on four runtime packages (unicon, pyftpdlib, tftpy, asyncssh) that handle protocol support and SSH connectivity.

License in practice: Licensed under Apache 2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install genie.libs.filetransferutils

from genie.libs.filetransferutils import FileTransferUtils
# Use FileTransferUtils methods to transfer files via FTP, TFTP, or SSH

Requires Python 3.5 or later; Linux or macOS only (Windows not supported per documentation).

Verify before relying:

- Exact API surface and available file transfer methods beyond the protocol names mentioned
- Whether this package is typically installed standalone or as part of the broader genie framework

## Package facts

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

## Tags

file transfer automation testing, ftp tftp ssh file transfer, genie file transfer utilities, network device file transfer, test automation file operations, pyats file transfer library, server file transfer utils, network-automation, test-framework, file-transfer

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