Skip to main content

parsimony-fred

FRED (Federal Reserve Economic Data) connector for the parsimony framework.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-fred.

What it does

Once installed, this plugin is discovered automatically and exposes the following connectors:

Connector Kind Tool-tagged Description
fred_search connector yes Keyword search across FRED series (id, title, units, frequency).
fred_fetch connector Fetch observation-level data for a FRED series by series_id.

Install

pip install parsimony-fred

Pulls in a compatible parsimony automatically.

Configuration

export FRED_API_KEY="<your-key>"

Get a key at https://fred.stlouisfed.org/docs/api/api_key.html.

Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Quick start

from parsimony_fred import CONNECTORS

result = CONNECTORS["fred_fetch"](series_id="UNRATE")
print(result.raw.head())

For multi-plugin composition:

from parsimony import discover

connectors = discover.load_all()

Catalog discovery

FRED ships a native search endpoint, so this plugin does not publish an embedded catalog. Use fred_search for keyword discovery — it calls /series/search directly against the FRED API.

Development

uv sync --extra dev
uv run pytest

Release-blocking conformance test: uv run pytest tests/test_conformance.py.

Provider

License

Apache-2.0 — see LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parsimony_fred-0.0.2.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

parsimony_fred-0.0.2-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

Details for the file parsimony_fred-0.0.2.tar.gz.

File metadata

  • Download URL: parsimony_fred-0.0.2.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for parsimony_fred-0.0.2.tar.gz
Algorithm Hash digest
SHA256 b59b9111264b5180479640869c14ae4e2245dd4d8c833a774ff5d24dc15d59a0
MD5 e177cf83040c32c4eec502f70ae513e0
BLAKE2b-256 ff64030498f79db5b263ee41b686f3e5df8dd0ebc93779aeda5020096f8a1650

See more details on using hashes here.

Provenance

The following attestation bundles were made for parsimony_fred-0.0.2.tar.gz:

Publisher: release.yml on ockham-sh/parsimony-connectors

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file parsimony_fred-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: parsimony_fred-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 9.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for parsimony_fred-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ba0c3ffe67eba285f4cb180c8df22f180a6912ee6d279c766108f32b04101afb
MD5 be5c1325675d68eac7be10aa626ea73a
BLAKE2b-256 08d21361968904ccb94c4b7a1ec94af04562863fd2572860483619b1a1d81356

See more details on using hashes here.

Provenance

The following attestation bundles were made for parsimony_fred-0.0.2-py3-none-any.whl:

Publisher: release.yml on ockham-sh/parsimony-connectors

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page