How pooja2420/ames-housing-data-exploration-and-predictive-modeling works
Ames Housing is an end-to-end house-price prediction project: raw property data is normalized and validated, prepared and feature-engineered, then used for model training, evaluation, and tuning; a FastAPI service accepts property details and returns price estimates. The README documents experiment tracking and deployment capabilities, but the tree contains no dedicated models package, so training is represented by the existing top-level housing.py. Relationships involving unsampled training and inference internals are documented at the capability level rather than inferred from filenames.
Main entry points: main.py FastAPI application · routes.py API routes · preprocessor.py Data preprocessing · housing.py Training workflow
Components 13
Data preparation
- Ames dataset
- CSV loader
src/ames_housing/data/loader.py - Raw schema
src/ames_housing/data/schema.py - Data preprocessing
src/ames_housing/data/preprocessor.py
Feature engineering
- Feature pipeline
src/ames_housing/features/engineering.py - Feature transformers
src/ames_housing/features/transformers.py
Modeling
- Training workflow
housing.py
Prediction service
- FastAPI application
src/ames_housing/api/main.py - API routes
src/ames_housing/api/routes.py - Request and response schemas
src/ames_housing/api/schemas.py - Structured logging
src/ames_housing/utils/logging.py
Other components
- Configuration
src/ames_housing/config.py - Prediction client
Connections 17
- Ames dataset → CSV loader: provides CSV
src/ames_housing/data/loader.py - CSV loader → Raw schema: validates against
src/ames_housing/data/loader.py - Data preprocessing → CSV loader: loads raw data
src/ames_housing/data/preprocessor.py - Data preprocessing → Raw schema: uses contract
src/ames_housing/data/preprocessor.py - Data preprocessing → Configuration: reads settings
src/ames_housing/data/preprocessor.py - Feature pipeline → Feature transformers: assembles
src/ames_housing/features/engineering.py - Feature pipeline → Configuration: reads settings
src/ames_housing/features/engineering.py - Training workflow → Data preprocessing: uses prepared data
- Training workflow → Feature pipeline: uses features
- Training workflow → FastAPI application: trained model serves predictions
- Prediction client → FastAPI application: requests prediction
README.md - FastAPI application → API routes: registers routes
src/ames_housing/api/main.py - FastAPI application → Structured logging: configures logging
src/ames_housing/api/main.py - FastAPI application → Configuration: reads settings
src/ames_housing/api/main.py - API routes → Request and response schemas: validates and returns
src/ames_housing/api/routes.py - API routes → Configuration: reads settings
src/ames_housing/api/routes.py - API routes → Training workflow: uses trained predictor