FAR Search - Core SDK

Lightweight SDK for semantic search over Federal Acquisition Regulations (FAR).

No LangChain dependency - just requests. Perfect for:

• Simple scripts and notebooks
• Serverless functions (minimal cold start)
• Projects that don't use LangChain
• Lightweight microservices

Installation

pip install far-search

Size comparison:

• far-search: ~10KB + requests (~1MB total)
• far-search-tool: ~15KB + LangChain (~150MB total)

Quick Start

from far_search_core import FARSearchClient

# Auto-registers on first use - no API key needed!
client = FARSearchClient()

# Search
results = client.search("cybersecurity requirements", top_k=5)

for clause in results:
    print(f"{clause.id}: {clause.title}")
    print(f"  Score: {clause.similarity_score:.1%}")
    print(f"  URL: {clause.url}")

Convenience Function

from far_search_core import search_far

# One-liner search
results = search_far("small business set aside requirements")

FARClause Object

Each result is a FARClause dataclass:

@dataclass
class FARClause:
    id: str              # e.g., "52.204-2"
    title: str           # e.g., "Security Requirements"
    text: str            # Full clause text
    source: str          # e.g., "FAR Part 52"
    url: str             # acquisition.gov URL
    similarity_score: float  # 0.0 - 1.0

Get Formatted Text (for LLMs)

client = FARSearchClient()

# Get pre-formatted text for LLM context
text = client.search_text("contract termination procedures")
print(text)

Get Specific Clause

client = FARSearchClient()

clause = client.get_clause("52.203-1")
if clause:
    print(clause.text)

Configuration

# With explicit API key
client = FARSearchClient(api_key="far_live_...")

# With RapidAPI key (for higher limits)
client = FARSearchClient(rapidapi_key="your-rapidapi-key")

# Environment variables
# export FAR_API_KEY=far_live_...
# export FAR_QUIET=1  # Suppress usage warnings

Pricing

Auto-registers on first use. Upgrade at RapidAPI.

Error Handling

from far_search_core import FARSearchClient, FARAPIError, FARRateLimitError

client = FARSearchClient()

try:
    results = client.search("my query")
except FARRateLimitError:
    print("Rate limit exceeded - upgrade your plan")
except FARAPIError as e:
    print(f"API error: {e}")

Related Packages

License

MIT License - see LICENSE for details.