Metadata-Version: 2.4
Name: fastercode-runner
Version: 0.1.3
Summary: Self-hosted runner for fastercode.ai
License-Expression: LicenseRef-Proprietary
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx==0.28.1
Requires-Dist: pytest==9.0.1
Requires-Dist: truststore==0.10.4
Dynamic: license-file

# fastercode-runner

Self-hosted runner agent for the [fastercode.ai](https://fastercode.ai) SaaS
platform. It lets scheduled and webhook-triggered optimisation jobs run on
your own machine instead of fastercode.ai's cloud runner - useful if a
repository's build/test environment needs to stay on infrastructure you
control.

Requires an active fastercode.ai account with at least one registered
environment (Environments page in the dashboard).

## Recommended: install via fastercode-ai

```bash
pip install fastercode-ai
fastercode login --runner-id <id> --token <token>
fastercode runner start
```

`fastercode-ai` bundles this package automatically - no separate install
step. Running `fastercode login` with no arguments opens the Environments
page in your browser and prompts for the ID/token interactively.

## Direct install

If you're wiring this into your own process manager or container image
rather than using the `fastercode` CLI, install this package directly and
set its three required environment variables:

```bash
pip install fastercode-runner
```

```
FASTERCODE_SAAS_BACKEND_URL   e.g. "https://fastercode.ai"
FASTERCODE_RUNNER_ID          issued when you register an environment
FASTERCODE_RUNNER_TOKEN       issued when you register an environment - keep it secret
```

Then run the console script:

```bash
fastercode-runner-agent
```

## License

Proprietary - see the bundled `LICENSE` file. Requires an active
fastercode.ai account; not for redistribution.
