# wilsonfreitas/awesome-quant architecture

> Architecture diagram of the GitHub repository wilsonfreitas/awesome-quant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wilsonfreitas/awesome-quant
- Repository: https://github.com/wilsonfreitas/awesome-quant

## Overview

Awesome Quant is a curated quantitative-finance resource catalog, maintained as a categorized README and presented as a searchable static site. Contributors add or change catalog entries; shared parsing supports validation, automated review, and audits, while the README also documents a wide range of quant domains. Separate scripts enrich project metadata and generate the site. The graph includes the major catalog branches and sampled runtime tooling; some generator and integration wiring is only partially shown, so those links are omitted where evidence is insufficient.

Main entry points: [`scripts/readme_entries.py`](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/readme_entries.py) (Entry Parser), [`parse.py`](https://github.com/wilsonfreitas/awesome-quant/blob/main/parse.py) (Metadata Enrichment), [`README.md`](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md) (Quant Catalog), [`site/index.html`](https://github.com/wilsonfreitas/awesome-quant/blob/main/site/index.html) (Static Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog"]
  node_readme["Quant Catalog<br/>[README.md]"]
  node_numerical["Numerical Tools<br/>[README.md]"]
  node_pricing["Pricing &amp; Instruments<br/>[README.md]"]
  node_trading["Trading &amp; Risk<br/>[README.md]"]
  node_research["Research &amp; Data<br/>[README.md]"]
  node_resources["Books &amp; Services<br/>[README.md]"]
end

subgraph group_quality["Entry Quality"]
  node_entry_parser["Entry Parser<br/>[readme_entries.py]"]
  node_validator["README Validator<br/>[validate_readme.py]"]
  node_pr_reviewer["PR Reviewer<br/>[review_pr.py]"]
  node_readme_audit["README Audit<br/>[audit_readme.py]"]
  node_url_probe["URL Probe<br/>[url_probe.py]"]
end

subgraph group_maintenance["Catalog Maintenance"]
  node_readme_migration["Catalog Migration<br/>[migrate_readme.py]"]
  node_metadata_enrichment["Metadata Enrichment<br/>[parse.py]"]
  node_cran_scraper["CRAN Scraper<br/>[cranscrape.py]"]
end

subgraph group_site["Discovery Site"]
  node_site_generator["Site Generator<br/>[generate.py]"]
  node_site_page["Static Catalog<br/>[index.html]"]
  node_site_interactions["Search &amp; Filters<br/>[main.js]"]
end

node_contributor(("Contributor"))
node_github{{"GitHub"}}
node_cran{{"CRAN"}}
node_pypi{{"PyPI"}}
node_visitor(("Catalog Visitor"))

node_contributor -->|"edits entries"| node_readme
node_validator -->|"parses entries"| node_entry_parser
node_pr_reviewer -->|"parses entries"| node_entry_parser
node_readme_audit -->|"parses entries"| node_entry_parser
node_readme_audit -->|"checks URLs"| node_url_probe
node_readme_migration -->|"rewrites catalog"| node_readme
node_metadata_enrichment -->|"uses parser"| node_entry_parser
node_metadata_enrichment -->|"fetches repository data"| node_github
node_metadata_enrichment -->|"fetches release dates"| node_pypi
node_cran_scraper -->|"scrapes package pages"| node_cran
node_site_generator -->|"parses catalog"| node_readme
node_site_generator -.->|"generates page"| node_site_page
node_visitor -.->|"views catalog"| node_site_page
node_site_interactions -.->|"filters entries"| node_site_page

click node_readme "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_numerical "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_pricing "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_trading "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_research "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_resources "https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md"
click node_entry_parser "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/readme_entries.py"
click node_validator "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/validate_readme.py"
click node_pr_reviewer "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/review_pr.py"
click node_readme_audit "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/audit_readme.py"
click node_url_probe "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/url_probe.py"
click node_readme_migration "https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/migrate_readme.py"
click node_metadata_enrichment "https://github.com/wilsonfreitas/awesome-quant/blob/main/parse.py"
click node_cran_scraper "https://github.com/wilsonfreitas/awesome-quant/blob/main/cranscrape.py"
click node_site_generator "https://github.com/wilsonfreitas/awesome-quant/blob/main/site/generate.py"
click node_site_page "https://github.com/wilsonfreitas/awesome-quant/blob/main/site/index.html"
click node_site_interactions "https://github.com/wilsonfreitas/awesome-quant/blob/main/site/static/main.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_numerical,node_pricing,node_trading,node_research,node_resources toneBlue
class node_entry_parser,node_validator,node_pr_reviewer,node_readme_audit,node_url_probe toneAmber
class node_readme_migration,node_metadata_enrichment,node_cran_scraper toneMint
class node_site_generator,node_site_page,node_site_interactions toneRose
class node_contributor,node_github,node_cran,node_pypi,node_visitor toneIndigo
```

## Components

### Catalog

- [Quant Catalog](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`
- [Numerical Tools](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`
- [Pricing & Instruments](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`
- [Trading & Risk](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`
- [Research & Data](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`
- [Books & Services](https://github.com/wilsonfreitas/awesome-quant/blob/main/README.md): `README.md`

### Entry Quality

- [Entry Parser](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/readme_entries.py): `scripts/readme_entries.py`
- [README Validator](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/validate_readme.py): `scripts/validate_readme.py`
- [PR Reviewer](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/review_pr.py): `scripts/review_pr.py`
- [README Audit](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/audit_readme.py): `scripts/audit_readme.py`
- [URL Probe](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/url_probe.py): `scripts/url_probe.py`

### Catalog Maintenance

- [Catalog Migration](https://github.com/wilsonfreitas/awesome-quant/blob/main/scripts/migrate_readme.py): `scripts/migrate_readme.py`
- [Metadata Enrichment](https://github.com/wilsonfreitas/awesome-quant/blob/main/parse.py): `parse.py`
- [CRAN Scraper](https://github.com/wilsonfreitas/awesome-quant/blob/main/cranscrape.py): `cranscrape.py`

### Discovery Site

- [Site Generator](https://github.com/wilsonfreitas/awesome-quant/blob/main/site/generate.py): `site/generate.py`
- [Static Catalog](https://github.com/wilsonfreitas/awesome-quant/blob/main/site/index.html): `site/index.html`
- [Search & Filters](https://github.com/wilsonfreitas/awesome-quant/blob/main/site/static/main.js): `site/static/main.js`

### Other components

- **Contributor**
- **GitHub**
- **CRAN**
- **PyPI**
- **Catalog Visitor**

## Connections

- Contributor → Quant Catalog: edits entries (evidence: `README.md`)
- README Validator → Entry Parser: parses entries (evidence: `scripts/validate_readme.py`)
- PR Reviewer → Entry Parser: parses entries (evidence: `scripts/review_pr.py`)
- README Audit → Entry Parser: parses entries (evidence: `scripts/audit_readme.py`)
- README Audit → URL Probe: checks URLs (evidence: `scripts/audit_readme.py`)
- Catalog Migration → Quant Catalog: rewrites catalog (evidence: `scripts/migrate_readme.py`)
- Metadata Enrichment → Entry Parser: uses parser (evidence: `parse.py`)
- Metadata Enrichment → GitHub: fetches repository data (evidence: `parse.py`)
- Metadata Enrichment → PyPI: fetches release dates (evidence: `parse.py`)
- CRAN Scraper → CRAN: scrapes package pages (evidence: `cranscrape.py`)
- Site Generator → Quant Catalog: parses catalog (evidence: `site/generate.py`)
- Site Generator → Static Catalog: generates page
- Catalog Visitor → Static Catalog: views catalog
- Search & Filters → Static Catalog: filters entries
