Familiar

AI agent for domain intelligence, powered by Deep Agents and LangGraph.

Familiar wraps the domain tools from Tower — giving you a conversational interface to investigate domains, DNS records, WHOIS/RDAP data, TLD information, and domain industry terminology. Built on LangChain's Deep Agents framework for planning, subagent delegation, and context management over long-running tasks. Skill documentation from Scrolls is loaded into the agent's system prompt at startup, giving it detailed knowledge of each tool's capabilities.

Setup

Install the project (seer and tome are built from sibling Rust/PyO3 projects):

python3 -m venv .venv
source .venv/bin/activate
pip install maturin
pip install -e ../seer/seer-py -e ../tome/tome-py -e ../scrolls
pip install -e .

Then install the extra for your chosen LLM provider:

pip install -e ".[ollama]"      # Local models via Ollama (default)
pip install -e ".[openai]"      # OpenAI API
pip install -e ".[anthropic]"   # Anthropic API
pip install -e ".[google]"      # Google Gemini API
pip install -e ".[all]"         # All providers

Copy .env.example to .env and configure your model:

cp .env.example .env

For local usage with Ollama, pull a model:

ollama pull nemotron-3-nano:latest

Usage

Interactive mode:

familiar

Single query:

familiar "who owns google.com"

Configuration

Set FAMILIAR_MODEL in .env using provider:model format:

Provider	Example	Required env var
Ollama	ollama:nemotron-3-nano:latest	—
OpenAI	openai:gpt-4o	OPENAI_API_KEY
Anthropic	anthropic:claude-sonnet-4-20250514	ANTHROPIC_API_KEY
Google	google_genai:gemini-2.5-pro	GOOGLE_API_KEY

Variable	Default	Description
FAMILIAR_MODEL	ollama:nemotron-3-nano:latest	LLM to use (must support tool calling)
OLLAMA_BASE_URL	http://localhost:11434	Ollama server URL (only for ollama provider)

Observability (optional)

Agent runs can be traced via LangSmith. Install the optional dependency:

pip install -e ".[tracing]"

Then enable tracing in .env:

Variable	Default	Description
LANGSMITH_TRACING	false	Set to true to enable LangSmith tracing
LANGSMITH_API_KEY		Your LangSmith API key
LANGSMITH_PROJECT	familiar	LangSmith project name

Traces include every LLM call, tool invocation, and agent step. Tracing is disabled by default and requires both the extra install and a valid API key.

Tools

Seer — Domain Intelligence

Tool	Description
seer_lookup	Smart RDAP-first lookup with WHOIS fallback
seer_whois	WHOIS registration data
seer_rdap_domain	RDAP domain lookup
seer_rdap_ip	RDAP IP address lookup
seer_rdap_asn	RDAP Autonomous System Number lookup
seer_dig	DNS record queries
seer_propagation	DNS propagation across global nameservers
seer_status	Domain health check (HTTP, SSL, expiration)
seer_bulk_lookup	Bulk RDAP/WHOIS lookups
seer_bulk_whois	Bulk WHOIS lookups
seer_bulk_dig	Bulk DNS queries
seer_bulk_status	Bulk health checks
seer_bulk_propagation	Bulk propagation checks

Tome — Reference Data

Tool	Description
tome_tld_lookup	TLD information (type, registry, DNSSEC, restrictions)
tome_tld_search	Search TLDs by keyword
tome_record_lookup	DNS record type details
tome_record_search	Search DNS record types
tome_glossary_lookup	Domain industry term definitions
tome_glossary_search	Search the glossary