Skip to main content

Ants Worker

Join the colony. Share your compute.

pip install ants-worker
ants-worker join

That's it. You're now part of the swarm.

Commands

ants-worker join           # Register and start working
ants-worker join -t wild   # Run as wild kangaroo (default: tame)
ants-worker status         # Check connection and worker ID
ants-worker leave          # Unregister (delete ~/.ants/config.json)
ants-worker info           # System/GPU info
ants-worker benchmark      # Test performance

Hardware Acceleration

AMD Ryzen AI (NPU)

# Auto-detects Ryzen AI and optimizes
ants-worker join

# Check detected hardware
ants-worker info --detailed

# Force specific backend
ants-worker join -b amd_npu
ants-worker join -b amd_rocm
ants-worker join -b parallel_cpu --workers 16

NVIDIA GPU

pip install ants-worker[cuda]
ants-worker join

High Performance Binary

# Linux with NVIDIA GPU
git clone https://github.com/JeanLucPons/Kangaroo.git
cd Kangaroo && make gpu=1 && cd ..
export KANGAROO_BIN=$(pwd)/Kangaroo/kangaroo

ants-worker join

Run in Background

Screen/tmux

screen -S ants
ants-worker join
# Ctrl+A, D to detach

Systemd (Linux)

sudo tee /etc/systemd/system/ants-worker.service << 'EOF'
[Unit]
Description=Ants Worker
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/ants-worker join
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable --now ants-worker

FAQ

Is this safe? Yes. You get a unique token that can only submit work results.

Resources? Minimal bandwidth (~KB/min). CPU/GPU usage configurable. Stop with Ctrl+C.

Where's my config? ~/.ants/config.json - contains your token and worker ID.

Tame vs Wild? Both needed. Run one of each for maximum contribution:

ants-worker join -t tame &
ants-worker join -t wild &

Development

git clone https://github.com/ants-at-work/worker
cd worker
pip install -e ".[dev]"
pytest

Metadata

Release files for ants-worker 0.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ants-worker 0.2.4
File Size Uploaded Provenance Actions
ants_worker-0.2.4.tar.gz 41.3 kB Without provenance Details for ants_worker-0.2.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ants-worker 0.2.4
File Interpreter ABI Platform Actions
ants_worker-0.2.4-py3-none-any.whl Python 3 none any Details for ants_worker-0.2.4-py3-none-any.whl

Total release size: 91.4 kB

Release files / ants_worker-0.2.4.tar.gz

Download URL ants_worker-0.2.4.tar.gz
Size 41.3 kB
Tags Source
SHA-256 checksum
How to use checksums
556814df837918b8cbf9cb8c84dbb632a008a3e603659cfcf9b2481c4586fdd3
BLAKE2b-256 checksum
How to use checksums
46a6994a3cab91b978187d07064a1e4427d7baade069c521848f671cacfae176
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Release files / ants_worker-0.2.4-py3-none-any.whl

Download URL ants_worker-0.2.4-py3-none-any.whl
Size 50.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f8588c4e5144542bc47742bd287e862d8dd30772ff27707a81a65c2ed8b5fdd5
BLAKE2b-256 checksum
How to use checksums
5a0712e2c65940b6806cc4a919afaa29494e073c17de0859d608793ca5439b6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Security for ants-worker 0.2.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page