langchain-truthbear

LangChain tools for Truth Bear GAUGE, a pay-per-call source of official-record signals (US federal agencies and named registries).

Installation

pip install langchain-truthbear

No API key, no account, no signup for the two free tools.

Tools

Quick start

from langchain_truthbear import GaugeCoverage, GaugeCatalog

# Check a signal line
coverage = GaugeCoverage()
print(coverage.invoke({"signal_id": "hydrology.river-level"}))

# Find valid entities
catalog = GaugeCatalog()
print(catalog.invoke({"signal_id": "hydrology.river-level"}))

With an agent

from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_truthbear import GaugeCoverage, GaugeCatalog

tools = [GaugeCoverage(), GaugeCatalog()]
# ... set up your agent with these tools

Design notes

• Standard library only — no dependency beyond langchain-core.
• No money moves here. GaugeRecord returns the x402 challenge untouched; settling it is the caller's own wallet's job.
• The catalog filter is required. The unfiltered response is ~1.5 MB — too large for an agent's context — so a call with neither signal_id nor industry is rejected.
• A miss is not an error. An unknown signal_id returns {"found": false} rather than raising.
• Every paid record ships a canonical sha256 record_hash that can be recomputed offline.