runtm-worker

Build and deploy worker for Runtm. See the self-hosting docs for deployment setup.

Pipeline

Remote Builder (Default, Recommended)

Unzip artifact from storage
Validate manifest against schema
Create Fly app and allocate IPs
Run flyctl deploy (builds AND deploys in one step)
- Auto-generates fly.toml with optimized health checks
- Builds on Fly's remote builders (fast, no local Docker)
- Deploys to Fly Machine with health check verification
Save provider resource and verify health
Update deployment status + URL in DB
Persist logs

Local Build (Fallback)

Unzip artifact from storage
Validate manifest against schema
Build Docker container locally with BuildKit
Push to Fly.io registry
Create/update Fly Machine via Machines API
Poll for health check
Update deployment status + URL in DB
Persist logs

Development

# Install dependencies
pip install -e ".[dev]"

# Run worker
python -m runtm_worker.main

# Run tests
pytest

Environment Variables

Variable	Description	Default
`DATABASE_URL`	PostgreSQL connection string	Required
`REDIS_URL`	Redis connection string	Required
`FLY_API_TOKEN`	Fly.io API token	Required
`ARTIFACT_STORAGE_PATH`	Local artifact storage path	`/artifacts`
`ARTIFACT_STORAGE_BACKEND`	Storage backend: `local` or `s3`	`local`
`BUCKET_NAME`	S3/Tigris bucket name (when backend=s3)	-
`AWS_ENDPOINT_URL_S3`	S3 endpoint URL (e.g. `https://fly.storage.tigris.dev`)	-
`USE_REMOTE_BUILDER`	Use Fly's remote builder (faster)	`true`

Providers

The worker uses a provider interface to support multiple deployment backends:

FlyProvider - Fly.io Machines (default)
Future: Cloud Run, etc.

Note: When using the remote builder (default), most deployment is handled by flyctl deploy. The FlyProvider is still used for app creation, IP allocation, machine listing, health verification, and custom domain management.

Release files for runtm-worker 0.2.157

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

Source distribution (sdist)

Source distribution for runtm-worker 0.2.157
File	Size	Uploaded
runtm_worker-0.2.157.tar.gz	49.4 kB	Sep 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for runtm-worker 0.2.157
File	Interpreter	ABI	Platform	Reset
runtm_worker-0.2.157-py3-none-any.whl 45.2 kB Sep 25, 2026	Python 3	none	any	Details

Total release size: 94.6 kB

Release files / runtm_worker-0.2.157.tar.gz

Download URL	runtm_worker-0.2.157.tar.gz
Size	49.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`fa50b3b4b1057703b80924ee262ff2d50c53c8713b502d2b6900241ed5ad6db7`
BLAKE2b-256 checksum How to use checksums	`783f0082aaf76245f31b07b14470da3b71c6ea74480576e4cf8565178953efc1`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / runtm_worker-0.2.157-py3-none-any.whl

Download URL	runtm_worker-0.2.157-py3-none-any.whl
Size	45.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3d6a0144e94998de827b9577a8666f3fa6ee5e5be39c6eaf211482a5c7d2f826`
BLAKE2b-256 checksum How to use checksums	`218f0c115cbc4356bdea50e868dfa0d584621445470a3de98b5c964fa0cab3f9`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`