pykaos

What it is and what it does

PyKAOS is a lightweight Python library that abstracts file and command operations for agents, allowing the same code to run either locally or remotely over SSH without modification. It builds on asyncssh and aiofiles to provide asynchronous, non-blocking I/O for both local and remote system interactions.

The library is designed for scenarios where an agent or application needs to interact with operating systems in a uniform way, whether executing commands, reading files, or managing directories. By switching execution context (local vs. remote SSH), developers can test locally and deploy remotely without rewriting logic. It targets Python 3.12+ and is maintained actively.

Use it for:

• Build agent systems that execute commands uniformly across local dev and remote production servers
• Implement cross-machine file synchronization or backup tasks with a single codebase
• Test local file operations during development, then run the same code against remote systems
• Automate server provisioning or configuration tasks that mix local and remote shell commands

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

PyKAOS provides an abstraction layer for agents to perform file operations and execute commands, with seamless switching between local and remote execution over SSH.

Yes, with caution on license clarity. The package has low install friction, active maintenance, no known vulnerabilities, and fills a real need for agent-based local/remote abstraction. However, the missing license metadata is a blocker for production use—verify the actual license terms before committing to a dependency. If you need this abstraction pattern and can clarify the license, it's a reasonable choice.

Install

pykaos on PyPI

pip install pykaos

uv add pykaos

poetry add pykaos

Installing pykaos

Before you install

Low install friction with a pure-Python wheel distribution. Maintenance status is active with a recent release cycle (134 days since last release). Requires Python 3.12 or later.

License in practice

License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before use in proprietary or copyleft-sensitive contexts.

Quickstart

pip install pykaos

import pykaos
# Use pykaos to execute commands or file operations locally or over SSH

Requires Python 3.12 or later. Runtime dependencies asyncssh and aiofiles must be available.

Verify before relying

• Actual license identifier and terms—metadata shows no SPDX or raw license field
• Documentation and API surface—no docs URL provided in project metadata
• Specific use-case examples and agent integration patterns
• Performance characteristics and concurrency limits for remote operations

Package facts

Evidence: pykaos-0.9.0-py3-none-any.whl

Tags

More Networking packages