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.

Metadata

Release files for parsimony-fred 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for parsimony-fred 0.0.2
File Size Uploaded Provenance
parsimony_fred-0.0.2.tar.gz 9.9 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for parsimony-fred 0.0.2
File Interpreter ABI Platform
parsimony_fred-0.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 19.3 kB

Release files / parsimony_fred-0.0.2.tar.gz

Download URL parsimony_fred-0.0.2.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b59b9111264b5180479640869c14ae4e2245dd4d8c833a774ff5d24dc15d59a0
BLAKE2b-256 checksum
How to use checksums
ff64030498f79db5b263ee41b686f3e5df8dd0ebc93779aeda5020096f8a1650
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

Release files / parsimony_fred-0.0.2-py3-none-any.whl

Download URL parsimony_fred-0.0.2-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba0c3ffe67eba285f4cb180c8df22f180a6912ee6d279c766108f32b04101afb
BLAKE2b-256 checksum
How to use checksums
08d21361968904ccb94c4b7a1ec94af04562863fd2572860483619b1a1d81356
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

Security for parsimony-fred 0.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for parsimony_fred-0.0.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files Full provenance

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