{"library":"policyengine-us","title":"PolicyEngine US","description":"PolicyEngine US is an open-source Python library that provides a comprehensive microsimulation model of the United States tax and benefit system. Built upon the PolicyEngine Core framework (a fork of OpenFisca), it accurately models federal individual income taxes, major federal benefit programs, and state income taxes for all 50 states and D.C. The library enables researchers and policymakers to estimate household-level tax liabilities and benefit eligibility, and to simulate the distributional impacts and budgetary effects of proposed policy reforms. It is actively maintained with continuous updates driven by changes in tax and benefit legislation.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install policyengine-us"],"cli":{"name":"policyengine","version":"sh: 1: policyengine: not found"}},"imports":["from policyengine_us import system","from policyengine_core.entities import Person","from policyengine_core.entities import Household","from policyengine_core.simulation import Simulation"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from policyengine_us import system\nfrom policyengine_core.entities import Person, Household\nfrom policyengine_core.simulation import Simulation\n\n# Define a simple household\n# A person named 'alice' who is 40 years old and has wage income\nalice = Person(age=40, wages=50000, employment_status='EMPLOYED')\n\n# A household with Alice\nhousehold = Household(members=[alice])\n\n# Get the current US tax-benefit system\n# By default, uses the latest available policy year (e.g., 2025 as of recent updates)\nsim_system = system.get_system()\n\n# Create a simulation for the household\nsimulation = Simulation(household=household, system=sim_system)\n\n# Calculate a variable, e.g., Alice's net income in 2025\nalice_net_income = simulation.get_person_variable(person_id=alice.id, variable_name='net_income', period='2025')\n\nprint(f\"Alice's net income in 2025: ${alice_net_income:,.2f}\")\n\n# Example of applying a simple reform (e.g., a universal basic income)\nreform_code = {\n    'universal_basic_income': [\n        {\n            'period': '2025',\n            'value': 12000,\n            'description': 'A universal basic income of $12,000 per year for all adults.'\n        }\n    ]\n}\n\n# Apply the reform to the system\nreformed_system = system.get_system(reform=reform_code)\n\n# Run simulation with the reformed system\nreformed_simulation = Simulation(household=household, system=reformed_system)\n\nalice_net_income_reformed = reformed_simulation.get_person_variable(\n    person_id=alice.id, variable_name='net_income', period='2025'\n)\n\nprint(f\"Alice's net income in 2025 with UBI reform: ${alice_net_income_reformed:,.2f}\")\n","lang":"python","description":"This quickstart demonstrates how to define a simple household, retrieve the current US tax-benefit system, run a simulation to calculate a person's net income, and then apply a basic policy reform (Universal Basic Income) to see its impact.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"1.693.4","pypi_latest":"1.693.4","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":50,"avg_install_s":34.6,"avg_import_s":39.83,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"policyengine-us","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"policyengine-us","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":36,"import_time_s":29,"mem_mb":557.6,"disk_size":"656M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"policyengine-us","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"policyengine-us","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":34.4,"import_time_s":46.17,"mem_mb":509.4,"disk_size":"695M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"policyengine-us","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"policyengine-us","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":32.7,"import_time_s":47.23,"mem_mb":492.1,"disk_size":"677M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"policyengine-us","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"policyengine-us","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":32.7,"import_time_s":41.76,"mem_mb":509.2,"disk_size":"673M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"policyengine-us","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"policyengine-us","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":37,"import_time_s":34.98,"mem_mb":556.6,"disk_size":"616M"}]}}