# onestardao/WFGY

WFGY is heading toward WFGY 5.0 Polaris Protocol, a major open-source release for AI reasoning, RAG, agents, and real-world workflows. Includes Problem Map, Global Debug Card, WFGY 4.0, and the CFV Easter Egg.

Repository: https://github.com/onestardao/WFGY
Canonical: https://ross.abutalabs.com/products/wfgy
Homepage: https://github.com/onestardao/WFGY
Language: Jupyter Notebook
License: NOASSERTION
License Family: other
Topics: rag, ai-agents, alignment, debugging, evaluation, reasoning, graphrag, hallucination, information-retrieval, knowledge-graph, llm, retrieval-augmented-generation
Last push: 2026-08-26T06:53:10+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 83, longevity 32
- inputs: {"age_days": 455, "days_push": 7, "days_rel": 114, "gap_med": 16.5, "n_releases_24m": 11}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1785, forks 165 (observed 2026-08-28T04:05:36.056079+00:00)

## What it is
WFGY is an open-source ecosystem of protocols and tools for debugging and improving AI reasoning, RAG pipelines, and agent workflows, currently rolling out its WFGY 5.0 Polaris Protocol in stages. It includes components like Problem Map 3.0, Global Debug Card, Polaris Goal Compiler, and Cite First Verification for diagnosing broken LLM pipelines and reducing hallucinations.

## Use cases
- debug a broken rag pipeline
- reduce llm hallucinations
- evaluate ai agent workflows
- add citation verification to llm answers
- diagnose why my agent fails
- improve retrieval augmented generation quality
- structure llm reasoning with a protocol

## When to choose
- you need structured debugging tools for RAG or agent pipelines
- you want protocol-level approaches to hallucination and citation verification
- you want to follow an evolving open methodology for LLM reasoning reliability

## When to avoid
- you need a production-ready library with stable APIs rather than staged protocol documents
- you want a lightweight drop-in dependency instead of a methodology ecosystem
- you require a permissive license - the license is non-standard (NOASSERTION)

## Facets
- artifact type: framework
- maturity: active
- function: rag, agent-framework, prompt-engineering
- domain: large-language-models, developer-tools, artificial-intelligence
- platform: python, cross-platform
- tags: hallucination-mitigation, llm-debugging, knowledge-graph, graphrag, reasoning-protocol, polaris-protocol, debugging, evaluation, retrieval-augmented-generation, ai-agents

## Member repositories
- onestardao/WFGY (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:36.056079+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:24:13.533900+00:00, confidence not recorded.
  - readme: https://github.com/onestardao/WFGY (fetched 2026-08-28T04:05:36.056079+00:00, sha 163e95dd40cd)
  - homepage: https://github.com/onestardao/WFGY (fetched 2026-08-29T11:02:36.318044+00:00, sha 47a7a7be2d3f)
- Data as of 2026-08-30T08:39:29.467469+00:00.