{"id":23459,"library":"cpi","title":"cpi","description":"Quickly adjust U.S. dollars for inflation using the Consumer Price Index (CPI). Uses FRED data. Current version 2.0.10, actively maintained with regular data updates.","status":"active","version":"2.0.10","language":"python","source_language":"en","source_url":"https://github.com/palewire/cpi","tags":["inflation","CPI","economics","FRED","data"],"install":[{"cmd":"pip install cpi","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Fetch CPI data from FRED API","package":"requests","optional":false},{"reason":"Data handling and time series operations","package":"pandas","optional":true}],"imports":[{"note":"Direct import is the common pattern; avoid relying on module-level import for the function.","wrong":"import cpi; cpi.to_usd()","symbol":"cpi.to_usd","correct":"from cpi import to_usd"},{"note":"adjust is the recommended API; from cpi import adjust is cleaner.","wrong":"import cpi; cpi.adjust()","symbol":"adjust","correct":"from cpi import adjust"}],"quickstart":{"code":"from cpi import to_usd\nprint(to_usd(100, 1990, 2023))","lang":"python","description":"Adjust $100 from 1990 to 2023 dollars."},"warnings":[{"fix":"Use from cpi import adjust; adjust(100, 1990, 2023)","message":"cpi.to_usd() is deprecated in favor of adjust()","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"To adjust from 2020 to 2023, use to_usd(amount, 2020, 2023). It uses CPI data through 2022.","message":"Year ranges are inclusive for the start year; end year is exclusive (i.e., data up to but not including end year).","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure internet access on first use. Cache location: ~/.cpi/ on Linux/macOS.","message":"First run downloads CPI data from FRED; requires internet. Subsequent runs use a local cache.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2.0.10':19 'activ':20 'adjust':3 'consum':10 'cpi':1,13,27 'current':17 'data':16,24,30 'dollar':5 'econom':28 'fred':15,29 'index':12 'inflat':7,26 'maintain':21 'price':11 'quick':2 'regular':23 'u.s':4 'updat':25 'use':8,14 'version':18","created_at":"2026-05-01T08:07:53.389095+00:00","updated_at":"2026-05-01T08:07:53.389095+00:00","problems":{"verify_error":"<string>:1: StaleDataWarning: CPI data is out of date. To accurately inflate to today's dollars, you must run `cpi.update()`.\nTraceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'to_usd' from 'cpi' (/tmp/tmpo5usq27h/venv/lib/python3.12/site-packa"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.0.10","cli_name":"cpi","cli_version":"sh: 1: cpi: not found","type":"library","homepage":"https://palewi.re/docs/cpi/","github":"https://github.com/palewire/cpi","docs":"https://palewi.re/docs/cpi/","changelog":null,"pypi":"https://pypi.org/project/cpi/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-09","install_tag":null}}