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.8.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.8.0)

Count
Total entries 63
Verified 48
Measured 15
PyPI persian-llm-reference 0.8.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.8.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.8.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.8.0-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: persian_llm_reference-0.8.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.8.0.tar.gz
Algorithm Hash digest
SHA256 05bd1e432b877d68d8001f1403e9d2bc6f5535dd6ba960bda3f6cc9f8287389d
MD5 42584ff8081651d5460711657f8034c1
BLAKE2b-256 2527791d240d8da91451830354cfc6ee374b1fc7760d92ce44b04282032d8586

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for persian_llm_reference-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 89cd8fd68dce25d9452a41a1eb62c81b15923578139bac77e613fe87ba456116
MD5 0c689c4830d16de46b8f4d2d32281080
BLAKE2b-256 2337cc84958752aded532d62e460f1ecb1b690ae7b35ed082ed845dac3612e68

See more details on using hashes here.

Provenance

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