Metadata-Version: 2.4
Name: nanoclaw
Version: 2026.3.11
Summary: NanoClaw — containerized agent deployment plugin for CMDOP with WhatsApp integration
Project-URL: Homepage, https://cmdop.com
Project-URL: Documentation, https://cmdop.com/docs/sdk/python/
Project-URL: Repository, https://github.com/commandoperator/cmdop-sdk-python
Project-URL: Bug Tracker, https://github.com/commandoperator/cmdop-sdk-python/issues
License: MIT
Keywords: agent,cmdop,container,deploy,nanoclaw,whatsapp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: cmdop
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# NanoClaw — Docker Container Management & Remote Agent Deployment for Python

[![PyPI](https://img.shields.io/pypi/v/nanoclaw.svg)](https://pypi.org/project/nanoclaw/) [![Python](https://img.shields.io/pypi/pyversions/nanoclaw.svg)](https://pypi.org/project/nanoclaw/) [![license](https://img.shields.io/pypi/l/nanoclaw.svg)](https://github.com/commandoperator/cmdop-sdk-python/blob/main/LICENSE)

![nanoclaw](https://raw.githubusercontent.com/markolofsen/assets/main/libs/promo_nanoclaw.webp)

NanoClaw delivers robust Docker management Python developers need for remote container deployment. Unlike Dockerode, Portainer, or even the Docker SDK, NanoClaw directly integrates containerized AI agent deployment using a lightweight Docker SDK Node. Build, manage, and scale your container deployments with Python.

## Features

- Orchestrate Docker container deployment across diverse remote environments.
- Automate container lifecycle management using Python scripts.
- Extend existing applications with containerized AI agent capabilities.
- Integrate with existing Docker infrastructure via Python.
- Manage Docker images and volumes with ease.
- Monitor container health and resource utilization.

## Use Cases

- Deploy and manage Docker containers on remote machines
- Stream container logs and monitor running services
- Automate container lifecycle with AI agents

## Installation

```bash
pip install nanoclaw
```

## Quick Start

```python
from nanoclaw import NanoClaw

client = NanoClaw.remote(api_key="cmdop_live_xxx")

client.deploy("nginx:latest", port=8080, name="web")

for c in client.containers():
    print(c.get("Names"), c.get("Status"))

print(client.logs("web", tail=100))
```

## CLI

No SDK needed? Connect via standalone binary:

```bash
curl -fsSL cmdop.com/install-cli.sh | bash
cmdok ssh
```

![cmdok ssh](https://raw.githubusercontent.com/commandoperator/cmdop-sdk-js/main/assets/cmdok_ssh.gif)

## Links

- [CMDOP Homepage](https://cmdop.com)
- [Documentation](https://cmdop.com/docs/sdk/python/)
- [nanoclaw on PyPI](https://pypi.org/project/nanoclaw/)
- [GitHub](https://github.com/commandoperator/cmdop-sdk-python)
