Pidgen worker
pidgen-worker runs Pidgen work on a machine you control. It connects
out to Pidgen Cloud, claims the Account's tickets that this machine can run, drives
the coding agents installed here (Claude Code, Codex, Pi) inside isolated workspaces, and
reports progress and results back. It opens no inbound port.
Pidgen has three parts, each with its own name:
| Part | What it is | Installed as | Command |
|---|---|---|---|
| Pidgen CLI | The command-line controller; installs and runs the worker for you | npm package pidgen |
pidgen |
| Pidgen worker | This package: the process that runs work on your machine | PyPI distribution pidgen-worker |
pidgen-worker |
| Pidgen Cloud | Where Accounts, Projects and tickets live | hosted |
Requirements
- Linux x86_64 or aarch64 (glibc 2.28 or newer), or macOS 11 or newer on Apple silicon or Intel.
- CPython 3.12, 3.13 or 3.14. The worker is published as compiled wheels only, one per interpreter and platform; there is no source distribution.
- Git 2.25 or newer, Node.js 22.19 or newer and npm 10 or newer.
- At least one coding agent installed and signed in: Claude Code, Codex or Pi.
- An enrollment token from your Pidgen Cloud Workers page.
Install and enroll
If you use the Pidgen CLI, pidgen worker enroll installs, enrolls and manages the worker
for you. To install it directly, use the version series Pidgen Cloud shows on its Workers
page; the worker's major.minor is the protocol it speaks:
uv tool install "pidgen-worker~=2.11.0"
pidgen-worker enroll --server https://your-pidgen-service.example --token <enrollment-token>
pidgen-worker doctor
enroll exchanges the one-time token for the worker's credential, writes the worker's
configuration, runs the self-check and starts the worker in the background. Afterwards:
| Command | What it does |
|---|---|
pidgen-worker doctor |
Check this machine: tools, configuration, coding agent logins |
pidgen-worker node start / stop / restart |
Start or stop the worker |
pidgen-worker capacity show |
Show how many sessions each coding agent may run |
pidgen-worker --help |
Everything else |
Configuration and state live in ~/.pidgen, or the directory named by PIDGEN_HOME.
Upgrading
Install the newest release of the series Pidgen Cloud shows and restart:
uv tool upgrade pidgen-worker
pidgen-worker node restart
Support
When reporting a problem, include the output of pidgen-worker --version and
pidgen-worker doctor, and the full error output.
Licence
pidgen-worker is proprietary software licensed under the Pidgen Worker End-User Licence
Agreement, included in the package. Installing it accepts that agreement.
Developing the worker
Contributors with access to the source: docs/development/README.md,
docs/development/building.md and docs/development/protocol-and-repository-notes.md.
1 maintainer
Metadata
1 maintainer
Release files for pidgen-worker 2.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 122.8 MB
Release files / pidgen_worker-2.11.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.8 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7b89944544abc8862de649da2545700252f4c4c5deed88c2b400845ae65675af
|
|
BLAKE2b-256 checksum How to use checksums |
9fb46316cbb162a55fc73437f39216883c15d2b70fa3fd222f9d250d16503da3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pidgen_worker-2.11.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 10.9 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
1806e4148b170a994218fa85dbbff096b663b5895671cf885d1b36657dd2de11
|
|
BLAKE2b-256 checksum How to use checksums |
c0df83e8d164784d917dab2968492ef4dc16e6ad6f1e387c1e48422f623ee902
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp314-cp314-macosx_11_0_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp314-cp314-macosx_11_0_x86_64.whl |
|---|---|
| Size | 9.8 MB |
| Tags | CPython 3.14 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
13f1c0a51dc2eb978d3ff8a6f654a8e7059cf226314f72ed4792ca01089c3cf9
|
|
BLAKE2b-256 checksum How to use checksums |
b35bd4b8abf1634b8553cdfdd9d72acd35e8cb6c3f7dc28b2b45758423590821
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | pidgen_worker-2.11.1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.3 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
8641d09b5558c84ed2955324029a331a528811c85947f60f302f2689934120ce
|
|
BLAKE2b-256 checksum How to use checksums |
00db2d071c4bd9493f172e18b4764cab5fe1b7e56684d795d1c3dfb52bf34566
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.3 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7b8a4a11cdb13ba22e595e085a037d11f91d2ada0abfbf28f226151c9450adbc
|
|
BLAKE2b-256 checksum How to use checksums |
7f2c03fbb44ccb55c45b7588ac4af847b2fafc5539879d15e08bc4820164020e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pidgen_worker-2.11.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
69c9e49eec6eaa04837c4134a945cd34f5ff4c265ac0d40903c93a56836e6693
|
|
BLAKE2b-256 checksum How to use checksums |
5d1f755eee26729f3eba47874ced73300b82d230d239ef0540837590f378e127
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp313-cp313-macosx_11_0_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp313-cp313-macosx_11_0_x86_64.whl |
|---|---|
| Size | 9.7 MB |
| Tags | CPython 3.13 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
72a442f95a36ec1abd514b1c1b6bce45a3add1ae30fc2fb1c03b6c337f519772
|
|
BLAKE2b-256 checksum How to use checksums |
a52dde76df07530548119f57d4f41043113e4539634c378c8f506083f5503855
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | pidgen_worker-2.11.1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.2 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9c756d64385546c2ad3d33401b84d5c234831dde9ecc1751ec1f428d3657294b
|
|
BLAKE2b-256 checksum How to use checksums |
8b6461a3bc1d0364365914981c8f8fa8a917f05cea04391b824182c9e078c578
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
956259f6a0eebc569d3874ca0934f087af815b5b95ca8cb0b7289608dad76907
|
|
BLAKE2b-256 checksum How to use checksums |
debed17124e034849826e1a339f39bd2b93685f5c31b413f0da59abb868722b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pidgen_worker-2.11.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 10.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
ce037d9d85573b239d891db0ba89d0565966d6bebc85e34752bb73b984e2cbe4
|
|
BLAKE2b-256 checksum How to use checksums |
229284746e948f266102f05d12b7c85504bbe172a05b0bc5c6222870e83b09e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp312-cp312-macosx_11_0_x86_64.whl
| Download URL | pidgen_worker-2.11.1-cp312-cp312-macosx_11_0_x86_64.whl |
|---|---|
| Size | 9.8 MB |
| Tags | CPython 3.12 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
4b80d50c40d35737f078c7b3a2197af1721d7efbfae5062f0325b45bb47ff318
|
|
BLAKE2b-256 checksum How to use checksums |
7985280995c8d5856e576f70da338f2b0ca4478514ac913e1c722fbb22681c9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / pidgen_worker-2.11.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | pidgen_worker-2.11.1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.3 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f3ad9028e8b249b0dbebcd1a583c8ddd63a82b1261d047a4c3adbaaaf2336f62
|
|
BLAKE2b-256 checksum How to use checksums |
ccf1c249f509bf207b522d3c5ec19e44773211e6428337c817e1659691c22f31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency log
