v1.0.3 — SIMURG Search

SIMURG Search — free web search for AI agents, no hallucinations

SIMURG Search gives your agent a free internet. It is an extra layer the
model uses to re-check information on the web before it answers, so it stops
confidently making things up.

Powered by the TinyFish Search API. It ships a bundled free-tier key, so it works the
moment you pip install simurg — no setup.

What it does

• fetch ranked, structured web results ({title, snippet, url, site_name}) and
  feed them into the model's context
• ground() returns a verdict — attested (subject confirmed on the web +
  Wikipedia), thin (weak/generic evidence, treat with caution), or
  no_record (nothing anywhere → likely fabricated → abstain)
• the same engine now powers Monolith's L4 grounded verification

Use it separately

# right after: pip install simurg
python3 -m simurg.websearch "when was the Y2K bug"          # ranked results
python3 -m simurg.websearch "Y2K bug" --ground              # verdict + evidence
python3 -m simurg.websearch "some query" --json --k 5       # machine-readable

from simurg import websearch

hits  = websearch.search("HAL-X AI")          # [{title, snippet, url, site_name}]
text  = websearch.snippets("HAL-X AI")        # ready-to-inject context string
check = websearch.ground("HAL-X AI")          # {'verdict': 'attested'|'thin'|'no_record', ...}

Set TINYFISH_API_KEY for dedicated limits, or TINYFISH_API_KEY="" to opt
out. Stdlib HTTP only — zero new dependencies. Every failure degrades to an
empty result, never an exception.

New contributor

Big thanks to first-time contributor @0xsyntho for the TinyFish integration. 🎉

Install: pip install --upgrade simurg · PyPI: https://pypi.org/project/simurg/1.0.3/