{"id":15944247,"url":"https://github.com/cristianvasquez/housing","last_synced_at":"2026-06-11T04:31:08.734Z","repository":{"id":40958223,"uuid":"276088697","full_name":"cristianvasquez/housing","owner":"cristianvasquez","description":"A simulation of the \"Housing by shares,\" a hybrid mechanism, something in between renting and buying a house.","archived":false,"fork":false,"pushed_at":"2023-05-01T21:43:05.000Z","size":991,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-26T07:17:39.179Z","etag":null,"topics":["housing-affordability","proof-of-concept","simulation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cristianvasquez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-06-30T12:12:09.000Z","updated_at":"2023-03-17T16:18:16.000Z","dependencies_parsed_at":"2022-09-20T19:12:04.992Z","dependency_job_id":null,"html_url":"https://github.com/cristianvasquez/housing","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cristianvasquez/housing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristianvasquez%2Fhousing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristianvasquez%2Fhousing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristianvasquez%2Fhousing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristianvasquez%2Fhousing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cristianvasquez","download_url":"https://codeload.github.com/cristianvasquez/housing/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristianvasquez%2Fhousing/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34183109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["housing-affordability","proof-of-concept","simulation"],"created_at":"2024-10-07T08:21:47.876Z","updated_at":"2026-06-11T04:31:08.709Z","avatar_url":"https://github.com/cristianvasquez.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Housing by shares\n\nWe need a house to live in. To do so, the most common options are:\n\n1. To rent a house\n2. To buy a house\n\nThis simulation explores \"Housing by shares,\" a hybrid mechanism that lives somewhere in between option 1 and 2. This mechanism is meant to co-exist with 1 and 1.\n\n## The problem\n\nEveryone wants to own a house, but not everyone can buy a home.\n\nThe ability to own a house is determined by an individual's access (or lack of access) to financing, and lower-income individuals have less access. \nBanks are more likely to offer to finance to those who already own capital or, thanks to higher incomes, have greater repayment capacities.\n\nPeople with lower-income must take on significant and unsustainable debt burdens, which reduced wealth among the bottom income groups, increased poverty, and further exasperated inequalities.\n\nAlso, Inheritance plays a significant effect on social stratification, affecting the distribution of wealth. Heritage is transmitted across generations, determining people's chances in society.  Those who receive an inheritance are more likely to own a home than those who do not.\n\nHow can we smooth these existing disparities, which also have intergenerational consequences?\n\n## The mechanism\n\nA person pays a fee to live in a house just like in renting, but with the possibility of owning a fraction of the house, materialized in shares. The paid price goes proportionally to all the share-holders that previously lived in the house.\n\nThe idea is that a person collects several shares during her lifetime, that will represent an income in the future, especially when the person is retired.\n\n## Setup\n\nA community needs a founder, for example, the government or a big cooperative\n\nHouses enter the community, bought in traditional markets by the founder.  Each time a house enters, it's initial value is divided into a fixed amount of shares that are transferred to the founder, meaning that in the beginning, he is the only shareholder.\n\nIf a person wants to live for one month in one of those houses, she has to pay a fee corresponding to the price of a share. The paid amount goes proportionally to all share-holders, and one share is created to the person, and one share of the founder is destroyed.\n\nWhen a person dies, the shares go back to the founder (i.e big cooperative, government), that can buy more houses if needed. To ensure the share-influx, shares are not bought or sold in the open market.\n\n## Simulation\n\nI don't have a finished idea of how this would work, so I programmed a simple simulation that spans for 300 years, in a micro community of people.\nPeople can have childs and die, and wants to give the *Housing by shares* a try.\n\nSince this is only a preliminary exploration, I try to keep it simple, for example,there are no taxes.\n\nInitial values:\n\n- The number of initial shares created corresponds to the number of months an average person can live. \n- The price of each share is simply the house's initial price divided by the number of initial shares.\n\nI'm exploring two options, with inheritance and without, to see how it goes. If inheritance is enabled, a random sibling inherits the shares, otherwise the founder.\n\n\n## Screenshots\n\n### Parameters \n\n![parameters](images/parameters.png)\n\n### Demographics\n\n![demographics](images/image_00.png)\n\nPeople live, have childs and die. From time to time they change houses. When there is a lack of houses, the founder buys more.\n\n### How shares evolve\n\n![evolution of shares](images/image_01.png)\n\nOwnership of shares go from person to person. The founder recovers shares when a person dies.\n\n### How wealth evolve\n\n![wealth of the population](images/image_02.png)\n\nPeople has higher incomes at later ages, coming from the shares they gathered through their lifetime.\n\n## App\n\nInstall the requirements\n```\npip install -r requirements.txt\n```\n\nto run the simulation:\n```\npython app.py\n```\n\nJuly, 2020, Cristian Vasquez\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristianvasquez%2Fhousing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcristianvasquez%2Fhousing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristianvasquez%2Fhousing/lists"}