nfrax logonfrax

Infrastructure that just works. Ship products, not boilerplate.

Frameworks

  • svc-infra
  • ai-infra
  • fin-infra
  • robo-infra

Resources

  • Getting Started
  • What's New
  • Contributing

Community

  • GitHub

© 2026 nfrax. All rights reserved.

nfrax logonfrax
Start HereWhat's New
GitHub
fin-infra / API Reference

RecurringDetector

from fin_infra.recurring.detector import RecurringDetector
View source
fin_infra.recurring.detector

High-level recurring transaction detector. Provides easy-to-use interface for detecting recurring patterns. V2: Optional LLM enhancement for merchant normalization (Layer 2), variable amount detection (Layer 4), and insights generation (Layer 5).

Constructor
RecurringDetector(min_occurrences: int = 3, amount_tolerance: float = 0.02, date_tolerance_days: int = 7, merchant_normalizer: MerchantNormalizer | None = None, variable_detector_llm: VariableDetectorLLM | None = None, insights_generator: SubscriptionInsightsGenerator | None = None)
ParameterTypeDefaultDescription
min_occurrencesint3Minimum transactions to detect pattern (default: 3)
amount_tolerancefloat0.02Amount variance tolerance (default: 0.02 = 2%)
date_tolerance_daysint7Date clustering tolerance (default: 7 days)
merchant_normalizerMerchantNormalizer |NoneNoneOptional LLM merchant normalizer (Layer 2, V2)
variable_detector_llmVariableDetectorLLM |NoneNoneOptional LLM variable detector (Layer 4, V2)
insights_generatorSubscriptionInsightsGenerator |NoneNoneOptional LLM insights generator (Layer 5, V2)

Methods

On This Page

Constructordetect_patternsget_stats