README.md

---
title: AU Teacher Frameworks Self Assessment Tool
emoji: 🎓
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.10.0
app_file: app.py
pinned: false
license: mit
---

# AU Teacher Frameworks Self Assessment Tool

Evaluates national teacher education frameworks against two continental benchmarks:
- **AFSCTP**: African Framework of Standards and Competences for Teachers and School Leaders  
- **ATQF/CTQF**: Continental Teacher Qualification Framework

Uses AI-powered document analysis to score alignment across career stages, professional standards, qualifications, and quality assurance systems.

## How It Works

1. **Select Framework Type**:
   - **Standards & Competencies (AFSCTP)**: Career pathways, professional standards, leadership standards, assessment frameworks
   - **Qualifications Framework (ATQF/CTQF)**: Entry requirements, B.Ed/PGDE structures, accreditation, CPD credits

2. **Input Document**:
   - Choose from pre-loaded frameworks in the categorized folders, **or**
   - Upload your own document (PDF, DOCX, or TXT)

3. **Review Analysis**:
   - Overall alignment percentage (0–100%)
   - Visual dashboards (bar charts, radar profiles, alignment gauges)
   - Detailed criterion scoring with evidence-based justifications
   - Downloadable PDF evaluation reports

## Evaluation Criteria

### AFSCTP — 5 Criteria (Standards & Competencies)
| ID | Section | Focus Area |
|---|---|---|
| S1 | Career & CPD | Career Path Structure (4-stage: Beginner→Proficient→Expert→Distinguished) |
| S2 | Professional Standards | Teacher Professional Standards (5 Domains: Knowledge, Skills, Values, Partnerships, Leadership) |
| S3 | School Leadership | School Leadership Standards (7 Key Areas) |
| S4 | Professional Regulation | Competency Assessment Framework |
| S5 | Policy Context | Continental Strategy Alignment (CESA 16-25, Agenda 2063, SDG4c) |

### ATQF/CTQF — 7 Criteria (Qualifications Framework)
| ID | Section | Focus Area |
|---|---|---|
| Q1 | Entry Requirements | Minimum Entry Qualifications (B.Ed. or Degree+PGDE) |
| Q2 | Initial Teacher Education | B.Ed. Curriculum Structure (150 credits, 40% professional, 1yr practice) |
| Q3 | Initial Teacher Education | PGDE Curriculum Structure (50 credits, 3-month practice) |
| Q4 | Quality Assurance | Accreditation System (Dual: Generic + Professional) |
| Q5 | Career & CPD | CPD Credit System (55 credits per 5-year cycle) |
| Q6 | School Leadership | School Leadership Certification (60-credit Diploma + Proficient status) |
| Q7 | Professional Entry | Induction & Mentoring System (2-year structured program) |

## Scoring Scale

Each criterion scored **0–5**:
- **0–1**: 🔴 Non-existent to Weak  
- **2–3**: 🟡 Developing to Moderate  
- **4–5**: 🟢 Strong to Excellent  

## Folder Structure

Organize pre-loaded frameworks by type:

```bash
frameworks/
├── standards/               # AFSCTP documents (career stages, standards)
│   ├── kenya_tsc_standards.pdf
│   ├── ghana_ges_policy.pdf
│   └── ...
└── qualifications/          # ATQF documents (B.Ed, PGDE, accreditation)
    ├── nigeria_trcn_act.pdf
    ├── south_african_cptd.pdf
    └── ...
```

The dropdown menu automatically updates based on your selected framework type, showing only relevant documents from the appropriate folder.

## Setup

1. **API Key**: Set `NVIDIA_API_KEY` environment variable (uses `moonshotai/kimi-k2-instruct-0905` via NVIDIA API)
2. **Folders**: Create `frameworks/standards/` and `frameworks/qualifications/`
3. **Documents**: Add national framework PDFs to the appropriate folders
4. **Deploy**: Run `python app.py` or deploy to Hugging Face Spaces

## References

- African Framework of Standards and Competences for Teachers and School Leaders (AFSCTP)
- Continental Teacher Qualification Framework (CTQF), 2019  
- Africa Federation of Teaching Regulatory Authorities (AFTRA)
- AU Agenda 2063, CESA 16–25, SDG 4.c
- Continental Teacher Mobility Protocol