feat(providers): implement Hugging Face provider class for local and hosted model inference #3369

Open
opened 2026-04-05 14:39:25 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: feat/v3.6.0/huggingface-provider
  • Commit Message: feat(providers): implement Hugging Face provider class for local and hosted model inference
  • Milestone: v3.6.0
  • Parent Epic: #3365

Background

Issue #3018 identified that the Hugging Face provider is missing from the spec-required provider list. The specification references openai, anthropic, google, azure, openrouter as supported providers, and Hugging Face is a major LLM backend that should be supported for both local inference (via transformers) and hosted inference (via the Hugging Face Inference API).

Expected Behavior

A dedicated HuggingFaceProvider class exists in cleveragents/providers/ that:

  • Implements the provider protocol/interface
  • Supports both local model loading and Hugging Face Inference API
  • Is registered in the provider registry under the huggingface/ namespace
  • Passes all relevant unit and integration tests

Acceptance Criteria

  • HuggingFaceProvider class implemented in cleveragents/providers/huggingface.py
  • Provider registered under huggingface/ namespace in provider registry
  • Actor config config.provider: huggingface resolves to HuggingFaceProvider
  • BDD unit tests cover provider initialization and invocation
  • nox -e typecheck passes with no suppressions
  • Coverage >= 97%

Dependencies

  • Blocked by: (none)
  • Blocks: #3365

Subtasks

  • Create cleveragents/providers/huggingface.py with HuggingFaceProvider class
  • Register HuggingFaceProvider in provider registry
  • Add BDD feature file for Hugging Face provider
  • Add step definitions for Hugging Face provider tests
  • Verify nox passes

Definition of Done

  • All subtasks completed
  • Tests written and passing
  • All nox stages pass
  • Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: Unknown | Agent: ca-epic-planner

## Metadata - **Branch**: `feat/v3.6.0/huggingface-provider` - **Commit Message**: `feat(providers): implement Hugging Face provider class for local and hosted model inference` - **Milestone**: v3.6.0 - **Parent Epic**: #3365 ## Background Issue #3018 identified that the Hugging Face provider is missing from the spec-required provider list. The specification references `openai`, `anthropic`, `google`, `azure`, `openrouter` as supported providers, and Hugging Face is a major LLM backend that should be supported for both local inference (via `transformers`) and hosted inference (via the Hugging Face Inference API). ## Expected Behavior A dedicated `HuggingFaceProvider` class exists in `cleveragents/providers/` that: - Implements the provider protocol/interface - Supports both local model loading and Hugging Face Inference API - Is registered in the provider registry under the `huggingface/` namespace - Passes all relevant unit and integration tests ## Acceptance Criteria - [ ] `HuggingFaceProvider` class implemented in `cleveragents/providers/huggingface.py` - [ ] Provider registered under `huggingface/` namespace in provider registry - [ ] Actor config `config.provider: huggingface` resolves to `HuggingFaceProvider` - [ ] BDD unit tests cover provider initialization and invocation - [ ] `nox -e typecheck` passes with no suppressions - [ ] Coverage >= 97% ## Dependencies - Blocked by: (none) - Blocks: #3365 ## Subtasks - [ ] Create `cleveragents/providers/huggingface.py` with `HuggingFaceProvider` class - [ ] Register `HuggingFaceProvider` in provider registry - [ ] Add BDD feature file for Hugging Face provider - [ ] Add step definitions for Hugging Face provider tests - [ ] Verify `nox` passes ## Definition of Done - [ ] All subtasks completed - [ ] Tests written and passing - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: Unknown | Agent: ca-epic-planner
freemo added this to the v3.6.0 milestone 2026-04-05 14:39:50 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — Hugging Face provider class for local and hosted model inference is part of the v3.6.0 scope.
  • Milestone: v3.6.0 (already set)
  • Story Points: 5 — L — More complex than other provider issues due to supporting both local and hosted inference modes. Requires handling model loading, tokenization, and two distinct execution paths. Estimated 1-2 days.
  • MoSCoW: Should Have — Local model inference is a differentiating feature but not blocking core functionality. Hosted inference via generic path works.
  • Parent Epic: #3365

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: ca-project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: High — Hugging Face provider class for local and hosted model inference is part of the v3.6.0 scope. - **Milestone**: v3.6.0 (already set) - **Story Points**: 5 — L — More complex than other provider issues due to supporting both local and hosted inference modes. Requires handling model loading, tokenization, and two distinct execution paths. Estimated 1-2 days. - **MoSCoW**: Should Have — Local model inference is a differentiating feature but not blocking core functionality. Hosted inference via generic path works. - **Parent Epic**: #3365 --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
freemo removed this from the v3.6.0 milestone 2026-04-06 23:52:53 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#3369
No description provided.