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.9.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.9.0)

Count
Total entries 63
Verified 48
Measured 15
PyPI persian-llm-reference 0.9.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

indexed → verified → measured → corpus-documented → literary

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.9.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.

Project links

Data verified by PyPI on Aug 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for sinakazemnezhad from gravatar.com sinakazemnezhad

Credits

Author: Persian LLM Reference maintainers

GitHub Statistics

Data verified by PyPI on Aug 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

persian farsi llm language-model benchmark registry nlp

Classifiers

Report project as malware

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.9.0.tar.gz (22.1 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.9.0-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: persian_llm_reference-0.9.0.tar.gz
  • Upload date:
  • Size: 22.1 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.9.0.tar.gz
Algorithm Hash digest
SHA256 aac9c7a4d8805c0a3a7009ba9d08faa042e3baaeeb365e71d0ad4bc03d8490ec
MD5 89fb6d3a89837fe449b10d9f8a4b9c92
BLAKE2b-256 c303a2c6561e276ed8c2c317ca2e048bda2915d6f171c2d7d893878c728a1c4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for persian_llm_reference-0.9.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.9.0-py3-none-any.whl.

File metadata

File hashes

Hashes for persian_llm_reference-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 39bb6055694700d8589ae19ea9e2f25393df2ddbbac84edb7c665c6b9134d325
MD5 aefefd59c78f2da814a995fc26131036
BLAKE2b-256 b89ccf2a4b11d0405a5fb4d0c32f185fd8169e67f5202c9faa3ad4970ad29fa9

See more details on using hashes here.

Provenance

The following attestation bundles were made for persian_llm_reference-0.9.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