nanoclaw

Installer for the cmdop CLI — one binary that runs an AI agent inside a container you own.

pip install nanoclaw
nanoclaw

That's it. nanoclaw detects your platform, downloads the cmdop binary, verifies it against the published checksums, installs it, and hands over.

Containers make agents reproducible, and they make them awkward: the agent has to be reachable from outside the container without opening the container to the world.

cmdop is a single static-ish executable with no runtime dependencies, which makes it a well-behaved thing to put in an image. This package installs it from within one, or from a plain shell.

How does CMDOP compare? CMDOP Skills vs OpenClaw: two approaches to AI agent skills →

Small enough to belong in an image

No dependency tree to resolve at build time and no service to link — the install is a download, a checksum verification, and a file in ~/.local/bin. That keeps layers small and rebuilds fast.

The same binary serves its own console, so the container needs no sidecar to be usable.

What is cmdop

One executable that is the agent, the relay, the local server and the web console at once. There is no gateway, backend, database server or broker to stand up — you add one binary to a machine you already own.

• run an AI agent on your own machine, with your own tools
• reach it from anywhere: terminal, files, remote execution
• connect machines into a fleet
• works with Claude Code and other agent engines under the hood

Full documentation: docs.cmdop.com

Usage

nanoclaw                    # install cmdop (if needed), then run it
nanoclaw --install-only     # install, don't hand over
nanoclaw --prefix ~/bin     # choose the install directory
nanoclaw --force            # reinstall even if already present
nanoclaw --quiet            # print only the installed path
nanoclaw -- --help          # everything after `--` goes to cmdop

Default install directory is ~/.local/bin (%LOCALAPPDATA%\cmdop\bin on Windows). No sudo, no system directories.

What it does, precisely

1. Detects your OS and architecture.
2. Fetches SHA256SUMS from install.cmdop.com.
3. Downloads the matching binary to a temporary file.
4. Verifies the SHA-256 against the published checksum. On mismatch it aborts and installs nothing.
5. Moves the verified binary into the install directory and marks it executable.
6. Runs it.

Supported: macOS (Apple Silicon, Intel), Linux (x64, arm64), Windows (x64).

What it does not do

• No side effects at install time. pip install nanoclaw only unpacks files. Nothing is downloaded or executed until you run nanoclaw.
• No network access on import. import nanoclaw touches nothing.
• No telemetry. The package sends no analytics, ever.
• No dependencies. Standard library only, so there is nothing to conflict with what you already have installed.

Python API

The installer is importable if you would rather script it:

import nanoclaw

target = nanoclaw.detect()
print(target.label, target.asset)

result = nanoclaw.install()
print(result.path, result.sha256)

nanoclaw.install() raises nanoclaw.InstallError with a user-facing message on any failure, and nanoclaw.UnsupportedPlatform when there is no published binary for the current machine.

Links

• Website — https://cmdop.com
• Documentation — https://docs.cmdop.com
• Downloads — https://cmdop.com/download

License

MIT