mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-17 04:11:35 +00:00
Answers and written deliverables that rest on retrieved information now get inline numbered citations plus a mechanically-rendered Sources list, with a persistent ledger that makes a hallucinated citation detectable. - skills/research/grounded-citations/scripts/sources.py: stdlib citation ledger (add/ingest/list/render/verify) at $HERMES_HOME/cache/citations/ledger.json, profile-aware, O_EXCL-locked so parallel subagents sharing a ledger can't collide on ids - SKILL.md: cite-while-drafting procedure, register-at-retrieval rule, pitfalls, verification gate - references/citation-formats.md: per-target placement (markdown, LaTeX/PDF, docx, pptx, xlsx, wiki, BibTeX handoff to research-paper-writing) - references/grounding-rationale.md: why numbered ids (ALCE 2305.14627, WebGPT 2112.09332, Perplexity marker conventions), and how this relates to the in-process registry in PR #44833 - tests/skills/test_grounded_citations_skill.py: 30 tests
23 lines
836 B
Python
23 lines
836 B
Python
"""Resolve HERMES_HOME for standalone skill scripts.
|
|
|
|
Skill scripts may run outside the Hermes process (system Python, nix env,
|
|
CI) where ``hermes_constants`` is not importable. This module provides the
|
|
same ``get_hermes_home()`` contract without requiring it on ``sys.path``.
|
|
|
|
When ``hermes_constants`` IS available it is used directly so profile
|
|
resolution and any future enhancements are picked up automatically.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from pathlib import Path
|
|
|
|
try:
|
|
from hermes_constants import get_hermes_home as get_hermes_home
|
|
except (ModuleNotFoundError, ImportError):
|
|
|
|
def get_hermes_home() -> Path:
|
|
"""Return the Hermes home directory (default: ``~/.hermes``)."""
|
|
val = os.environ.get("HERMES_HOME", "").strip()
|
|
return Path(val) if val else Path.home() / ".hermes"
|