Alba Core Logo

About

  • Introduction
    • What Alba Core owns
    • What Alba Core does not own yet

Getting started

  • Setting up Alba Core
    • Useful commands
  • Running your first search
    • Expected flow

Manual

  • Requirement Extraction
    • Inputs
    • Outputs
    • Common Fields
    • Extension Rule
  • Matching Pipeline
    • Hard Filters
    • Soft Scoring
  • Lead Summaries

Alba Core details

  • Architecture
    • Subsystem Overview
    • Design Principles
  • Data Flow
    • Stateful Conversations
  • PropertyMe Cache
    • Why cache data?
    • Cache Rules

Class reference

  • Class Reference
    • Pipeline
      • AlbaCore
        • AlbaCore.from_environment()
        • AlbaCore.search()
      • Example
      • Environment-based setup
    • Requirements And Records
      • RentalRequirements
        • RentalRequirements.is_search_ready
        • RentalRequirements.merge()
        • RentalRequirements.missing_required_fields
        • RentalRequirements.to_dict()
      • Example: merge conversation turns
        • PropertyRecord
      • Example: public API output
        • MatchResult
      • Example: serialise a match result
        • clean_text()
    • Requirement Extraction
      • ExtractionOutput
        • ExtractionOutput.to_dict()
      • RequirementExtractor
        • RequirementExtractor.extract()
      • Example
      • Continuing a conversation
    • Matching
      • MatchingOutput
        • MatchingOutput.to_dict()
      • PropertyMatcher
        • PropertyMatcher.match()
      • Example
      • No-match handling
    • Lead Summaries
      • build_lead_summary()
      • money()
      • Example
      • No-match example
    • PropertyMe Cache And OAuth
      • load_property_cache()
      • Example: load the local cache
        • PropertyMeOAuthConfig
        • build_authorization_url()
        • token_exchange_payload()
        • refresh_payload()
      • Example: build OAuth requests
        • PropertyMeClient
      • Example: refresh a raw rental cache
    • HTTP API
      • SearchRequest
        • SearchRequest.model_config
      • search()
      • Example: request body
      • Example: curl
      • Example: Python client

Contributing

  • Contributing to Alba Core
    • Contribution Loop
    • Commands
  • Code Commenting Guidelines
    • Module Comments
    • Class Comments
    • Function Comments
    • Good Comments

API reference

  • Alba Core API Reference
  • PropertyMe API Reference
  • HTTP API Reference
Alba Core
  • Running your first search
  • View page source

Running your first search

Alba Core includes a small smoke script that runs the full backend flow against real cached PropertyMe-backed data.

python scripts\smoke_search.py "Find me a house in Auckland with 4 bedrooms under 5000 move in asap"

Expected flow

The output should show:

  • extracted requirements such as location, budget, bedrooms, property type, and move-in timing;

  • search_ready: true when the required fields are known;

  • at most three real property matches;

  • match notes explaining why each property was selected;

  • a lead summary for Alba staff.

If no property fits, Alba Core should return an honest no-match result rather than creating a fake option.

Previous Next

© Copyright .

Built with Sphinx using a theme provided by Read the Docs.