.. _installation-usage:

Installation and Usage Guide
=============================

Learn how to **install FedFred**, initialize the client, and quickly start interacting with the **FRED® API**.  
This section covers everything from **basic examples** to **advanced asynchronous usage** and **data visualization**.

---

Contents
--------

.. toctree::
   :maxdepth: 1
   :caption: Installation & Getting Started

   installation
   quickstart

.. toctree::
   :maxdepth: 1
   :caption: Basic and Advanced Usage

   basic_usage
   advanced_usage

.. toctree::
   :maxdepth: 1
   :caption: Data Visualization

   data_visualization

---

Related Resources
-----------------

.. grid::
    :gutter: 2

    .. grid-item-card:: API Reference
        :link: api-index
        :link-type: ref
        :link-alt: Full API Reference

        Explore all available FedFred methods, clients, and object models.

    .. grid-item-card:: Use Cases
        :link: use-cases
        :link-type: ref
        :link-alt: Real-World FedFred Applications

        See real-world examples of using FedFred for economic analysis, dashboards, and automation.

    .. grid-item-card:: Parameter Handling Notes
        :link: api-notes
        :link-type: ref
        :link-alt: API Parameter Conversion Rules

        Learn how FedFred automatically validates and transforms parameters like dates and lists.