Persian LLM Reference

Local path: ~/Desktop/PERSIAN-LLM-REFERENCE/ — this folder is the git repo root for GitHub.

مرجع مدل‌های زبانی فارسی

The open atlas for Persian (Farsi) language models — 72 sourced entries (v0.13.1) with verification gates, decision presets, gap mapping, normalized measured receipts, and bilingual JSON. Works alongside Awesome-Persian-LLM, MIZAN, PartAI, and the teams who build these models.

Community-maintained · sourced · machine-readable · online-first.

Related evaluation kit (same author): agent-security-bench — Agent Security Evaluation Kit. Walkthrough: docs/SCORE_AGENT_WITH_ASB.md.

Stats (v0.13.1)

How PLR fits the ecosystem

Upstream discovery: Awesome-Persian-LLM — verified community index awesome-persian-llm · ECOSYSTEM.md. Bibliographic link only — not an endorsement or partnership.

Live surfaces (after deploy)

Repository layout

GitHub setup (required)

1. Repo: github.com/sinakazemnezhad/persian-llm-reference
2. Enable GitHub Pages → source: GitHub Actions
3. Push main branch
4. Site: https://sinakazemnezhad.github.io/persian-llm-reference

Python client (PyPI)

Same pattern as sourcea-boot · pypi.org/project/sourcea-boot.

pip install persian-llm-reference
plr stats
plr get persianmind-v1
plr cite
plr validate

Editable install from repo root:

cd workspace && node scripts/sync-python-manifest.mjs
pip install -e .

• Python client: MIT (LICENSE-MIT)
• Registry metadata: CC-BY-4.0 (LICENSE)
• Publish: GitHub Release → publish-pypi workflow (trusted publishing). See docs/PYPI_TRUSTED_PUBLISHING_SETUP.md.

Build & verify

cd workspace
npm run build    # validate + copy manifest to public/
npm run e2e      # local server smoke

Verification gates

indexed → verified → measured → corpus-documented → literary

No invented scores. null until a primary source exists.

How to cite

PLR is a neutral evidence registry — cite the snapshot you used, not a ranking.

1. Machine-readable: CITATION.cff (version, date-released, abstract, repository URL).
2. BibTeX (copy for papers):

@misc{persian_llm_reference,
  title={Persian LLM Reference — Open Atlas},
  author={{Persian LLM Reference maintainers}},
  year={2026},
  version={0.13.0},
  url={https://sinakazemnezhad.github.io/persian-llm-reference/},
  howpublished={\\url{https://raw.githubusercontent.com/sinakazemnezhad/persian-llm-reference/main/data/reference-manifest.json}},
  note={Check manifest generatedAt for snapshot date; measured rows include benchmark, metric, source, and conditions}
}

3. API consumers: pin GET /api/v1/reference.json or the raw manifest URL — same schema, same evidence semantics.

Also see CITATION.cff for Citation File Format metadata.

Contributing

One PR = one entry + primary source URL. See governance/CONTRIBUTING.md.

License

Manifest metadata and docs: CC-BY-4.0. Each model entry retains its own license.