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

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)

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:
Latest release

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: persian_llm_reference-0.9.1.tar.gz
  • Upload date:
  • Size: 22.2 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.1.tar.gz
Algorithm Hash digest
SHA256 526ddf4f4cb91eaef9ed654fff4b8e0d6128a3f85196c4639b972c65fa63b91a
MD5 a392aae9762bbfcbbadc088fa3f01634
BLAKE2b-256 90e6aa4ea59b4a3a13f5663dbdbae89c8f7fa04fc45bdc14d6c474d731894646

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for persian_llm_reference-0.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bf84236ac48e81c75f9ba47fa79e4ff6bbec400539efee87e01870e32e4da404
MD5 8460ce537508ed48dda7cf04a3273b69
BLAKE2b-256 dfb829931c86b9c825dd9f4e571f8c2c5a47da9c68d6a659ddaefaf144bd1d85

See more details on using hashes here.

Provenance

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