Skip to content

vllm_pearl

vllm_pearl

The v1 vllm-pearl mining provider.

See spec docs/design/2026-05-05-vllm-pearl-mining-integration-design.md.

Classes

VllmPearlProvider 

VllmPearlProvider(docker_client: Optional[Any] = None)

Bases: MiningProvider

vLLM + Pearl Docker container, solo-mining only in v1.

Source code in src/openjarvis/mining/vllm_pearl.py 
43
44
45
46
47
48
49
def __init__(self, docker_client: Optional[Any] = None):
    if docker_client is None:
        import docker

        docker_client = docker.from_env()
    self._client = docker_client
    self._launcher = PearlDockerLauncher(client=docker_client)

Functions

ensure_registered 

ensure_registered() -> None

Idempotent registration. Required because tests/conftest.py clears every registry before each test (see Spec A §4.2).

Source code in src/openjarvis/mining/vllm_pearl.py 
147
148
149
150
151
152
def ensure_registered() -> None:
    """Idempotent registration. Required because tests/conftest.py clears
    every registry before each test (see Spec A §4.2).
    """
    if not MinerRegistry.contains("vllm-pearl"):
        MinerRegistry.register_value("vllm-pearl", VllmPearlProvider)