renta 0.1.2

Real Estate Network and Trend Analyzer - A Python library for real estate investment analysis in Buenos Aires

Real Estate Network and Trend Analyzer

RENTA is a Python library for real estate investment analysis in Buenos Aires. It combines Airbnb market data, Zonaprop listings, geospatial enrichment, and AWS Bedrock summaries to deliver investment-ready datasets.

Features

• Download and normalize Airbnb datasets from InsideAirbnb with freshness caching.
• Scrape or ingest Zonaprop listings, capturing pricing, engagement, and location data.
• Match properties to nearby Airbnb listings with configurable spatial filters.
• Generate Claude Sonnet 4.5 summaries in Argentine Spanish through AWS Bedrock.
• Export enriched results to pandas, CSV, or JSON with consistent schemas.

Installation

pip install renta

Quick Start

from renta import RealEstateAnalyzer

analyzer = RealEstateAnalyzer()

airbnb = analyzer.download_airbnb_data(force=True)
properties = analyzer.scrape_zonaprop(
    "https://www.zonaprop.com.ar/inmuebles-venta-palermo-2-dormitorios-50000-130000-dolar.html"
)
enriched = analyzer.enrich_with_airbnb(properties)
summaries = analyzer.generate_summaries(enriched)

analyzer.export(enriched, format="csv", path="investment_analysis.csv")

AWS Bedrock Requirements

Claude Sonnet 4.5 access is required for AI summaries.

export AWS_ACCESS_KEY_ID="YOUR_KEY"
export AWS_SECRET_ACCESS_KEY="YOUR_SECRET"
export AWS_REGION="us-east-1"

Or configure ~/.aws/credentials or an IAM role. In AWS Console → Amazon Bedrock → Model access, request us.anthropic.claude-sonnet-4-5-20250929-v1:0.

Configuration

Create config.yaml to override defaults in renta/data/default_config.yaml.

data:
  cache_dir: "~/.renta/cache"
  freshness_threshold_hours: 24
airbnb:
  matching:
    radius_km: 0.3
    min_nights_threshold: 7
aws:
  region: "us-east-1"
logging:
  level: "INFO"

Load with RealEstateAnalyzer(config_path="config.yaml") or set RENTA_CONFIG=/path/config.yaml. Configuration is validated against renta/schemas/config_schema.json.

Troubleshooting

• Download issues: call analyzer.download_airbnb_data(force=True).
• Zonaprop blocked: use html_path="saved_results.html" with previously saved HTML.
• Bedrock errors: verify credentials with aws sts get-caller-identity and confirm model access.
• Schema validation failures: run RealEstateAnalyzer(config_path="config.yaml") to surface detailed errors.

Security and Compliance

Logs scrub PII when enabled in config, credentials are never persisted, and scraping obeys configurable rate limits. Review renta/data/legal_notice.md and LEGAL_COMPLIANCE.md for jurisdiction-specific guidance. Users are responsible for complying with local laws, Zonaprop terms, and AWS policies.

Documentation and Examples

• API reference and guides: https://renta.readthedocs.io
• Example scripts and notebooks: examples/
• Default prompts and configuration templates ship with the package.

Contributing

We welcome pull requests. Install development tooling with:

pip install -e ".[dev]"
pytest
black . && isort . && flake8

See CONTRIBUTING.md for workflow details.

License

MIT License – see LICENSE.

---

RENTA supports research and exploratory investment analysis. Always verify property data independently and consult legal counsel when deploying scraping or AI-driven workflows in production.