See the stars

Civic Quant Specification

Home / Civic Quant / Civic Quant Specification

Civic Quant

Data That Belongs to Everyone.


Overview

Civic Quant is an open-source, AI-powered federal fiscal transparency platform designed to make government finances understandable, accessible, and independently verifiable. It provides a comprehensive view of how much the United States federal government collects, spends, owns, and owes by consolidating financial information from the Department of the Treasury, the Office of Management and Budget, the Congressional Budget Office, and other authoritative government sources.

The platform tracks federal revenue from taxes, tariffs, fees, fines, contracts, land leases, natural resources, spectrum auctions, and other sources while monitoring government expenditures across mandatory programs, discretionary budgets, federal agencies, public services, and debt servicing. Every financial figure is connected to its original government data source, allowing users to examine supporting documentation, reporting periods, calculation methodologies, and data transformations.

Civic Quant also features a National Dividend Calculation Engine that evaluates potential distributable net fiscal gains and calculates hypothetical equal distributions among all U.S. citizens, regardless of age. Its interactive Fiscal Simulation and Scenario Modeling environment allows users to explore alternative government policies, revenue strategies, spending adjustments, and economic assumptions while observing their projected effects on federal finances and potential national dividends.

The platform combines comprehensive financial tracking, AI-assisted analysis, independent verification, and public participation to give citizens, researchers, journalists, economists, and policymakers the tools to examine government finances and explore opportunities for responsible national wealth distribution.


Core Modules

Federal Revenue Intelligence Module

Provides comprehensive tracking, classification, reconciliation, and analysis of federal government revenue across agencies, departments, programs, and collection mechanisms.

Features include:

  • Federal individual income tax collections.
  • Corporate income tax collections.
  • Payroll and employment taxes.
  • Excise taxes and other federal taxes.
  • Customs duties and tariffs.
  • Import and export-related revenue.
  • Visa, immigration, passport, and federal application fees.
  • Federal fines, penalties, and forfeitures.
  • Government contract receipts and recoveries.
  • Federal land leases, royalties, and resource extraction revenue.
  • Mineral, energy, and natural resource royalties.
  • Spectrum auctions and licensing revenue.
  • Federal property sales and asset disposals.
  • Interest income and investment-related receipts.
  • Foreign government payments and contractual receipts.
  • Domestic government contracts and service-related receipts.
  • Federal loan repayments, recoveries, and interest collections.
  • Other miscellaneous federal receipts.

Revenue records are classified according to their financial nature, collection status, originating agency, reporting period, and source documentation.

The module distinguishes recurring revenue, nonrecurring revenue, transfers, recoveries, asset sales, borrowing, and other financial transactions to prevent double counting and inaccurate revenue reporting.

Federal Expenditure Intelligence Module

Provides comprehensive visibility into federal government spending, obligations, disbursements, and financial commitments.

Features include:

  • Mandatory federal spending.
  • Discretionary federal spending.
  • Defense and national security expenditures.
  • Social Security expenditures.
  • Medicare and Medicaid expenditures.
  • Federal employee compensation and benefits.
  • Federal agency operating expenses.
  • Infrastructure and public works expenditures.
  • Education and research funding.
  • Federal grants and assistance programs.
  • Foreign aid and international expenditures.
  • Federal contracts and procurement.
  • Disaster relief and emergency expenditures.
  • Federal subsidies and tax expenditures.
  • Interest payments on federal debt.
  • Federal loan programs and financial assistance.
  • Government administrative expenses.
  • Other federal expenditures.

The module distinguishes budget authority, obligations, outlays, accrued expenses, and actual disbursements.

Users can examine spending by agency, department, program, category, funding source, and fiscal year.

Federal Financial Position Module

Maintains a consolidated view of federal financial assets, liabilities, obligations, and outstanding commitments.

Features include:

  • Federal debt outstanding.
  • Debt servicing obligations.
  • Treasury securities and related liabilities.
  • Federal cash balances.
  • Government-owned financial assets.
  • Federal loan assets and receivables.
  • Government property and infrastructure assets.
  • Federal trust fund balances.
  • Pension and benefit obligations.
  • Unfunded liabilities and long-term commitments.
  • Contingent liabilities and financial guarantees.
  • Federal credit and lending exposure.
  • Changes in federal net financial position.

The module distinguishes financial assets, nonfinancial assets, recognized liabilities, and estimated long-term obligations.

It provides historical comparisons and identifies changes in the government’s overall financial position.

National Revenue Reconciliation Module

Reconciles revenue information across federal agencies, the Department of the Treasury, and other authoritative government reporting systems.

Features include:

  • Cross-agency revenue reconciliation.
  • Treasury receipt verification.
  • Duplicate transaction identification.
  • Revenue classification consistency.
  • Collection and reporting period reconciliation.
  • Revenue projection comparisons.
  • Identification of missing or inconsistent records.
  • Historical revenue comparisons.
  • Reconciliation of federal transfers and intergovernmental transactions.
  • Identification of discrepancies between reported and independently calculated totals.

The module maintains traceable relationships between consolidated financial figures and their original reporting records.

National Expenditure Reconciliation Module

Reconciles federal spending information across agency budgets, Treasury records, and government financial reporting systems.

Features include:

  • Budget-to-outlay reconciliation.
  • Agency spending verification.
  • Obligation and disbursement comparisons.
  • Contract expenditure reconciliation.
  • Duplicate expenditure detection.
  • Spending classification verification.
  • Identification of unreported or inconsistent expenditures.
  • Historical expenditure comparisons.
  • Reconciliation of transfers between federal accounts.
  • Identification of discrepancies between published budgets and actual expenditures.

National Dividend Calculation Module

Calculates hypothetical national dividend distributions using verified net fiscal gains and clearly defined eligibility and distribution rules.

Features include:

  • Calculation of total eligible net fiscal surplus.
  • Identification of available distributable funds.
  • Deduction of applicable financial obligations and reserves.
  • Separation of recurring and nonrecurring fiscal gains.
  • Calculation of equal per-citizen distributions.
  • Inclusion of every U.S. citizen regardless of age.
  • Population and citizenship data validation.
  • Historical dividend comparisons.
  • Alternative distribution methodology simulations.
  • Annual, quarterly, and other configurable distribution periods.
  • Calculation of total distribution costs.
  • Comparison of equal distributions and alternative allocation models.

The default calculation distributes an eligible surplus equally among all U.S. citizens, including children and adults.

The calculation engine distinguishes hypothetical dividend estimates from authorized or funded government payments. It does not treat borrowing, internal transfers, unfunded projections, or asset liquidation as recurring distributable gains.

All assumptions, eligibility rules, deductions, population estimates, and calculation methodologies must be publicly documented and independently reproducible.

Citizen Population and Eligibility Module

Provides the population data and eligibility assumptions necessary to calculate potential national dividend distributions.

Features include:

  • Total U.S. citizen population estimates.
  • Age-independent citizen inclusion.
  • Historical population comparisons.
  • Population projection modeling.
  • Citizenship data source identification.
  • Population reporting date verification.
  • Inclusion and exclusion assumption documentation.
  • Alternative population scenario modeling.
  • Estimated distribution recipient counts.

The module uses appropriately aggregated and privacy-preserving population information. It does not require the collection or public disclosure of individual citizenship records.

Fiscal Simulation and Scenario Modeling Module

Allows users to construct, modify, and compare hypothetical federal fiscal scenarios.

Features include:

  • Tax rate adjustment simulations.
  • New federal revenue stream simulations.
  • Tariff and customs revenue scenarios.
  • Federal fee and licensing adjustment scenarios.
  • Government spending reduction simulations.
  • New federal program expenditure simulations.
  • Debt servicing and borrowing scenario analysis.
  • Federal asset revenue scenarios.
  • Economic growth and contraction assumptions.
  • Inflation and purchasing power adjustments.
  • Population growth and demographic assumptions.
  • National dividend distribution simulations.
  • Multi-year fiscal projections.
  • Comparison of alternative budget strategies.
  • Sensitivity analysis.
  • Best-case, baseline, and worst-case scenario modeling.

Users can modify individual assumptions or entire fiscal models and examine their projected impact on federal revenue, expenditures, net fiscal position, debt, and potential national dividend distributions.

Simulations remain separate from actual government financial records and clearly identify hypothetical assumptions, estimates, and projected outcomes.

Government Data Integration Module

Connects Civic Quant to authoritative federal government data sources and public financial reporting systems.

Primary data sources include:

  • U.S. Department of the Treasury.
  • Treasury Fiscal Data.
  • Monthly Treasury statements.
  • Daily Treasury statements.
  • Office of Management and Budget.
  • Congressional Budget Office.
  • Government Accountability Office.
  • Internal Revenue Service.
  • U.S. Customs and Border Protection.
  • Federal agency financial reports.
  • USAspending.gov.
  • Federal procurement reporting systems.
  • Federal Reserve economic and financial datasets.
  • Other authoritative federal financial reporting systems.

Features include:

  • Public API integrations.
  • Government dataset ingestion.
  • Automated data retrieval.
  • Scheduled data synchronization.
  • Historical data imports.
  • Data source identification.
  • Source document preservation.
  • Data format normalization.
  • Reporting period alignment.
  • Dataset version tracking.
  • Source availability monitoring.

The platform prioritizes original government records and authoritative publications over third-party estimates or secondary reporting.

Financial Audit and Verification Module

Provides a transparent audit trail for every financial figure, calculation, reconciliation, and simulation produced by Civic Quant.

Features include:

  • Direct source attribution.
  • Original document references.
  • Source URL preservation.
  • Dataset version identification.
  • Publication and retrieval timestamps.
  • Data transformation records.
  • Calculation methodology documentation.
  • Revenue and expenditure reconciliation histories.
  • Automated discrepancy detection.
  • Historical calculation reproduction.
  • Audit log generation.
  • Independent verification support.
  • Reproducible financial calculations.

Every consolidated financial figure must be traceable to its underlying records, transformations, and calculation methodology.

Where information cannot be independently verified, the platform identifies the limitation rather than presenting the figure as confirmed.

AI Financial Intelligence Module

Provides AI-assisted analysis of federal financial information without replacing underlying financial records or established calculation methodologies.

Features include:

  • Natural-language financial queries.
  • Federal revenue analysis.
  • Government spending analysis.
  • Budget comparisons.
  • Revenue and expenditure trend identification.
  • Anomaly and discrepancy detection.
  • Financial report summarization.
  • Cross-agency financial comparisons.
  • National dividend explanations.
  • Scenario analysis assistance.
  • Identification of unusual financial changes.
  • Source-based explanations.
  • Automated report generation.

AI-generated findings must reference underlying data and distinguish verified facts, calculated results, estimates, and interpretations.

AI systems must not independently alter official financial records, invent missing figures, or silently change established calculation assumptions.

Public Transparency Dashboard Module

Provides an accessible public interface for examining the financial position and fiscal activity of the federal government.

Features include:

  • Total federal revenue.
  • Total federal expenditures.
  • Federal budget balance.
  • Federal debt and interest obligations.
  • Revenue source breakdowns.
  • Spending category breakdowns.
  • Agency-level financial reporting.
  • Historical fiscal comparisons.
  • Federal asset and liability summaries.
  • Potential national dividend estimates.
  • Per-citizen dividend calculations.
  • Revenue and expenditure trends.
  • Fiscal simulation results.
  • Data verification status.
  • Direct links to original government sources.

Users can explore financial information at national, agency, department, program, and reporting-period levels.

Public Financial Research Module

Provides tools for researchers, journalists, economists, policymakers, educators, and citizens to independently investigate federal finances.

Features include:

  • Advanced financial data search.
  • Custom reporting periods.
  • Revenue and expenditure filtering.
  • Agency and program comparisons.
  • Historical dataset exploration.
  • Downloadable financial datasets.
  • Custom financial reports.
  • Source document access.
  • Calculation methodology access.
  • Reproducible analysis exports.
  • Public research sharing.
  • Comparative fiscal analysis.

Reporting and Publication Module

Generates standardized and customizable reports based on verified government financial information and user-defined simulation assumptions.

Features include:

  • Federal revenue reports.
  • Federal expenditure reports.
  • Government financial position reports.
  • National dividend reports.
  • Agency financial reports.
  • Historical fiscal performance reports.
  • Revenue and expenditure reconciliation reports.
  • Financial discrepancy reports.
  • Fiscal simulation reports.
  • Annual and quarterly comparisons.
  • Exportable datasets and reports.
  • Public report references and source citations.

Reports identify the reporting period, source datasets, calculation methods, assumptions, and verification status.


Optional Plugin Modules

State and Local Government Integration Plugin

Extends Civic Quant to include state, county, municipal, and local government financial information.

Features include:

  • State revenue and expenditure reporting.
  • Local government financial reporting.
  • Intergovernmental transfer analysis.
  • State and local debt tracking.
  • Comparative government financial analysis.
  • Consolidated public-sector fiscal reporting.

International Fiscal Comparison Plugin

Provides comparative analysis of federal government revenue, expenditures, debt, and public financial performance across participating countries.

Features include:

  • International government revenue comparisons.
  • Government expenditure comparisons.
  • Public debt analysis.
  • Tax structure comparisons.
  • Public-sector financial performance.
  • Currency and purchasing power adjustments.
  • International fiscal trend analysis.

Economic Impact Analysis Plugin

Evaluates the potential economic effects of alternative revenue policies, spending decisions, and national dividend distributions.

Features include:

  • Household purchasing power analysis.
  • Consumer spending impact projections.
  • Economic growth scenario modeling.
  • Inflation sensitivity analysis.
  • Employment impact projections.
  • Income distribution comparisons.
  • Economic multiplier assumptions.
  • Long-term economic impact comparisons.

Public Contract Intelligence Plugin

Provides deeper analysis of federal contracts, procurement awards, vendor payments, contract modifications, and government purchasing trends.

Features include:

  • Federal contract tracking.
  • Procurement award analysis.
  • Vendor payment monitoring.
  • Contract modification tracking.
  • Contract value comparisons.
  • Agency procurement analysis.
  • Contract spending discrepancy identification.
  • Historical procurement reporting.

Federal Asset Intelligence Plugin

Tracks federal property, land, mineral rights, natural resources, spectrum rights, and other government-owned assets and their associated revenue potential.

Features include:

  • Federal land and property inventories.
  • Natural resource revenue tracking.
  • Mineral and energy royalty analysis.
  • Federal lease monitoring.
  • Spectrum auction tracking.
  • Government asset valuation references.
  • Asset revenue trend analysis.
  • Asset utilization comparisons.

Tax Policy Simulation Plugin

Provides detailed simulations of federal tax structures, tax rates, deductions, credits, exemptions, and alternative taxation methodologies.

Features include:

  • Individual income tax simulations.
  • Corporate tax simulations.
  • Payroll tax scenarios.
  • Excise tax scenarios.
  • Tariff and customs duty simulations.
  • Tax credit and deduction modeling.
  • Alternative tax structure comparisons.
  • Estimated federal revenue impact analysis.

National Dividend Policy Plugin

Allows users to compare alternative national dividend eligibility rules, distribution frequencies, reserve requirements, and allocation methodologies.

Features include:

  • Equal per-citizen distribution models.
  • Alternative eligibility scenarios.
  • Distribution frequency comparisons.
  • Reserve allocation modeling.
  • Recurring and one-time dividend comparisons.
  • Multi-year distribution projections.
  • Population sensitivity analysis.
  • Dividend sustainability assessments.

Public Data Contribution Plugin

Allows qualified contributors to submit additional public financial datasets, source documentation, corrections, and research findings for review and potential inclusion.

Features include:

  • Public dataset submissions.
  • Source document submissions.
  • Data correction proposals.
  • Contributor identification.
  • Submission review workflows.
  • Source validation.
  • Dataset approval tracking.
  • Contributor acknowledgment.

Legislative Impact Analysis Plugin

Connects proposed legislation and enacted federal laws to relevant revenue, expenditure, debt, and national dividend assumptions.

Features include:

  • Proposed legislation tracking.
  • Legislative spending impact analysis.
  • Tax policy impact comparisons.
  • Revenue projection comparisons.
  • Program funding analysis.
  • Long-term fiscal impact modeling.
  • Alternative legislative scenario comparisons.

Public Accountability and Oversight Plugin

Provides tools for identifying unusual spending patterns, contract irregularities, unexplained financial discrepancies, and areas requiring further public investigation.

Features include:

  • Unusual expenditure identification.
  • Revenue discrepancy monitoring.
  • Federal contract anomaly detection.
  • Agency spending comparisons.
  • Historical spending pattern analysis.
  • Financial risk indicators.
  • Supporting document references.
  • Public oversight reporting.

Identified anomalies are treated as indicators requiring further examination, not automatic evidence of fraud or misconduct.

Historical Fiscal Archive Plugin

Maintains expanded historical federal financial datasets and supports long-term comparisons across administrations, legislative periods, and economic cycles.

Features include:

  • Historical federal revenue records.
  • Historical federal expenditure records.
  • Historical debt and liability records.
  • Long-term fiscal trend analysis.
  • Historical national dividend simulations.
  • Administration and legislative period comparisons.
  • Historical dataset preservation.
  • Reproducible historical calculations.

Specification Branding License (SBL)

Standard

Optional


License & Notice Requirements

Civic Quant is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

  • All contributions must comply with the AGPL-3.0+ terms.
  • Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
    Roxanne Ardary and roxanneardary.com.
  • Civic Quant specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
  • The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
    Any update that adds new contributors or modifies attribution should also update notice.md.
  • When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
  • Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.


Notice – Civic Quant

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

  • Roxanne Ardary, roxanneardary.com – November 20, 2026
    Created the repository for Civic Quant. Developed the project concept and specification for an open-source AI-powered federal fiscal transparency platform featuring comprehensive government revenue and expenditure tracking, financial auditing, fiscal simulations, and national dividend calculations.
  • Add other contributors here – [Date]
    [Describe contribution in one sentence]

License – Civic Quant

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points:

  • You are free to use, modify, and distribute the code.
  • All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
  • The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.