Skip to main content

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 — 63 sourced entries (v0.6.0) with verification gates and bilingual JSON. Works alongside Awesome-Persian-LLM, MIZAN, PartAI, and the teams who build these models.

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

Stats (v0.6.0)

Count
Total entries 63
Verified 48
Measured 15
PyPI persian-llm-reference 0.6.0

How PLR fits the ecosystem

Resource What it offers What PLR adds alongside
Awesome Persian LLM Curated discovery links Structured records + verification gates
Leaderboards (MIZAN, PartAI) Benchmark scores Links to leaderboards inside one manifest
Hugging Face search Model hosting + cards Persian taxonomy · corpus · script fields
Papers & repos Primary artifacts Indexed rows with asOf dates and cite URLs

Discovery credit: Awesome-Persian-LLM by Mohammad Heydari — verified entry awesome-persian-llm · ECOSYSTEM.md.

Live surfaces (after deploy)

Surface URL
Atlas UI https://sinakazemnezhad.github.io/persian-llm-reference
PyPI (Python client) https://pypi.org/project/persian-llm-reference/
Manifest JSON /data/reference-manifest.json
Raw manifest (cite in papers) https://raw.githubusercontent.com/sinakazemnezhad/persian-llm-reference/main/data/reference-manifest.json
Source radar (field gaps + forecast) /data/source-radar.json
Agent discovery /.well-known/persian-llm-reference.json

Repository layout

Path Role
data/reference-manifest.json SSOT — all models, datasets, benchmarks
workspace/public/ Static site (GitHub Pages root after build)
governance/MANIFEST_LAW.md Taxonomy + verification gates
governance/METHODOLOGY.md Trust, axes, cite policy
governance/POSITIONING.md What PLR is — alongside other references
governance/ROADMAP.md Full phased plan — meaningful · usable · productive · smart
docs/PYPI_TRUSTED_PUBLISHING_SETUP.md PyPI OIDC publish (sourcea-boot pattern)
pyproject.toml Python package · pip install persian-llm-reference

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

indexedverifiedmeasuredcorpus-documentedliterary

No invented scores. null until a primary source exists.

Cite

@misc{persian_llm_reference,
  title={Persian LLM Reference — Open Atlas},
  author={{Persian LLM Reference maintainers}},
  year={2026},
  version={0.6.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}
}

Also see CITATION.cff for machine-readable 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

persian_llm_reference-0.6.0.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

persian_llm_reference-0.6.0-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file persian_llm_reference-0.6.0.tar.gz.

File metadata

  • Download URL: persian_llm_reference-0.6.0.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for persian_llm_reference-0.6.0.tar.gz
Algorithm Hash digest
SHA256 20a390e6cbbc69c45f12b23904417be2f20bb586f4fc1bec1bbf7a2990a089e5
MD5 4d636314e32bc2b1af83ea71662da06b
BLAKE2b-256 caefd4d58cbcce5fcd85c50da89ddf1cf6cbf37d2480a3bdeb614421f281325b

See more details on using hashes here.

Provenance

The following attestation bundles were made for persian_llm_reference-0.6.0.tar.gz:

Publisher: publish-pypi.yml on sinakazemnezhad/persian-llm-reference

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file persian_llm_reference-0.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for persian_llm_reference-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4ea1e219866979c50798a72c312108617742464c6f83dc9e92b7133c383eb207
MD5 6aff9a3fbb3d938f3b9490d86b009a46
BLAKE2b-256 476fd45a9571af5a7834fcd4dfabdecb16d4f05a09325bf2e383b7f84f3ba0a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for persian_llm_reference-0.6.0-py3-none-any.whl:

Publisher: publish-pypi.yml on sinakazemnezhad/persian-llm-reference

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page