The Residential Property Acquisition OS — From raw listing to Bank-Ready dossier.
Property-Ops is an AI-native screening engine designed for professional-grade real estate due diligence. It transforms a single URL into a 1000+ word corporate feasibility study, including net-net yield modeling, environmental risk audits, and automated bank packages.
- 🤖 Autonomous Feasibility Study: Executes a mandatory strategy interview followed by deep hyper-local web research on employment hubs and micro-economics.
- 💰 Advanced Financial Engineering: Integrated support for Asset-Backed Financing (Pledging) and Differentiated Scenario Analysis (Home vs. Investment).
- 📄 Automated Bank Package: Generates a complete, professional PDF/HTML dossier for lenders with a single command.
- 🔍 Surgical Risk Audit: Automated checks for soil pollution (BDES), flood risks (WalOnMap), and urban planning compliance.
- 🌍 Agnostic & Scalable: Fully customizable via regional YAML Packs (Registration duties, energy policies, and construction costs).
git clone https://github.com/antoineghigny/property-ops.git
cd property-ops
npm install
npm run init-userFill your financial profile in config/profile.yml and define your investment goals in config/strategy.yml.
# Using Gemini CLI or Claude Code
/property-ops https://www.immoweb.be/fr/annonce/maison/a-vendre/...├── adapters/ # Connectors to external data (Market, Notary, Energy)
├── config/ # User-specific profile and strategy (Protected by gitignore)
├── engine/ # Core logic
│ ├── finance/ # Mortgage & Yield modeling
│ ├── pricing/ # Intrinsic value & Market gap analysis
│ ├── decision-engine/# Scoring and Go/No-Go logic
│ └── artifacts/ # Expert report & PDF generators
├── packs/ # Regional policy rules (Duties, Energy, Construction)
├── scripts/ # CLI entry points and maintenance tools
└── modes/ # AI Agent operational protocols
- Runtime: Node.js (ESM)
- Validation: Zod for strict data contract enforcement.
- Automation: Playwright for listing ingestion.
- Reporting: Custom Markdown-to-HTML/PDF engine for bank packages.
- AI Integration: Optimized for agentic workflows (Gemini CLI, Claude Code).
Property-Ops is open-source. We welcome contributions to expand regional Packs (France, Luxembourg, etc.) or new Adapters (local market data).
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Privacy by Design: Property-Ops is built to run locally. All sensitive financial data (income, assets, specific cases) is stored in the config/ and data/ directories, which are strictly excluded from git tracking via .gitignore.
Built with precision by [Antoine Ghigny](https://github.com/antoineghigny)