Struct HfJobsClient 

pub struct HfJobsClient { /* private fields */ }

Client for the HuggingFace Jobs REST API.

The Rust hf_hub crate has no Jobs API support, so we call the 5 simple endpoints directly with reqwest.

Implementations

impl HfJobsClient

pub fn from_env() -> Result<Self>

Build a client from environment.

Requires HF_TOKEN or HUGGING_FACE_HUB_TOKEN to be set.

pub async fn submit(&self, namespace: &str, spec: &JobSpec) -> Result<JobInfo>

Submit a new job.

pub async fn inspect(&self, namespace: &str, job_id: &str) -> Result<JobInfo>

Inspect a job’s current status.

pub async fn stream_logs( &self, namespace: &str, job_id: &str, ) -> Result<impl Stream<Item = Result<String>> + use<>>

Stream job logs via SSE. Returns lines as they arrive.

Each SSE data: line is a JSON object with data and timestamp fields.

pub async fn cancel(&self, namespace: &str, job_id: &str) -> Result<()>

Cancel a running job.

pub async fn list(&self, namespace: &str) -> Result<Vec<JobInfo>>

List recent jobs in a namespace.

pub fn token(&self) -> &str

The token this client was constructed with.

pub fn endpoint(&self) -> &str

The HF endpoint this client targets.