# Requirements Archive: v1.4 Hermes Default Provider

**Archived:** 2026-04-02
**Status:** SHIPPED

For current requirements, see `.planning/REQUIREMENTS.md`.

---

# Requirements — Milestone v1.4: Hermes Default Provider

## Hermes Integration (7)

- [x] **HERM-01** — Hermes adapter is installed, enabled, and appears in the "Add Agent" dropdown
- [x] **HERM-02** — User can create a Hermes agent with config options (model selection, tool permissions)
- [x] **HERM-03** — Heartbeat execution spawns `hermes chat -q`, processes task, returns result
- [x] **HERM-04** — Session persistence works across heartbeats via `--resume` flag
- [x] **HERM-05** — Nexus-managed skills are visible alongside Hermes native skills in agent config
- [x] **HERM-06** — Cost tracking captures token usage and model costs for Hermes agents
- [x] **HERM-07** — Dashboard shows Hermes-specific info (model name, memory usage, native skill count)

## Ollama Integration (5)

- [x] **OLLA-01** — Nexus detects whether Ollama is installed locally
- [x] **OLLA-02** — User can see a list of available Ollama models when configuring a Hermes agent
- [x] **OLLA-03** — User can configure a Hermes agent with any local Ollama model
- [x] **OLLA-04** — Model recommendation based on RAM/VRAM from a shipped catalog
- [x] **OLLA-05** — If Ollama is not present, user is offered installation instructions

## Default Provider Logic (4)

- [x] **DFLT-01** — If no cloud provider (Claude Code, etc.) is detected, Hermes + Ollama is offered as default during onboarding
- [x] **DFLT-02** — Default agent templates (PM, Engineer, Generalist) work correctly with Hermes runtime
- [x] **DFLT-03** — GSD workflow functions correctly with Hermes as the agent runtime
- [x] **DFLT-04** — Fresh install with only Hermes + Ollama works end-to-end (no paid subscription or API key required)

---

## Future Requirements

None deferred — all PRD items included in this milestone.

## Out of Scope

- Multi-provider model routing (Hermes can use OpenRouter/Anthropic/OpenAI but that's Hermes config, not Nexus)
- Hermes MCP server management (Hermes handles its own MCP connections)
- Custom Hermes skill authoring UI (skills are file-based, not GUI-managed)

## Traceability

| Requirement | Phase | Status |
|-------------|-------|--------|
| HERM-01 | Phase 27 | Complete |
| HERM-02 | Phase 27 | Complete |
| HERM-03 | Phase 27 | Complete |
| HERM-04 | Phase 27 | Complete |
| HERM-05 | Phase 28 | Complete |
| HERM-06 | Phase 28 | Complete |
| HERM-07 | Phase 28 | Complete |
| OLLA-01 | Phase 28 | Complete |
| OLLA-02 | Phase 28 | Complete |
| OLLA-03 | Phase 28 | Complete |
| OLLA-04 | Phase 28 | Complete |
| OLLA-05 | Phase 28 | Complete |
| DFLT-01 | Phase 29 | Complete |
| DFLT-02 | Phase 29 | Complete |
| DFLT-03 | Phase 29 | Complete |
| DFLT-04 | Phase 29 | Complete |
