پارس‌رگ
انگلیسی نصب
پارس‌رگ
مشاهدهٔ کد در گیت‌هاب خواندن این صفحه به انگلیسی

آخرین نسخه ۱.۱.۲

راهنما

مرجع پیکربندی

تنظیمات، متغیرهای محیطی فایل .env هستند و ۲۷ مورد از آن‌ها را بدون راه‌اندازی دوباره از بخش تنظیمات خود برنامه هم می‌توانید تغییر دهید. این‌ها متغیرهایی‌اند که به احتمال زیاد تغییرشان می‌دهید. مقدارهای پیش‌فرض، همان مقدارهای Docker هستند.

در خود برنامه

  • بخش تنظیمات ۲۷ گزینه را در چهار گروه تغییر می‌دهد: مدل (اندازهٔ زمینه، «فکر کردن»، تلاش دوباره و مهلت‌ها)، بازیابی (آستانه، عمق جست‌وجو و جست‌وجوی کلیدواژه‌ای)، اسناد (سقف بارگذاری، OCR و نمایش تصویر) و سرعت ایندکس (تصویرهای هم‌زمان، رشته‌های CPU و اندازهٔ دسته‌ها).
  • کنار هر گزینه مقدار .env آن آمده و می‌توانید یکی‌یکی یا با دکمهٔ «بازگشت همه به .env» به آن برگردید. مقدارهایی که در برنامه ذخیره می‌شوند بر .env مقدم‌اند، پس از راه‌اندازی دوباره هم می‌مانند و در volume به نام app_config نگه داشته می‌شوند.
  • پورت، نشانی‌های مجاز، Qdrant، سقف حافظه، بزرگ‌ترین درخواست بارگذاری و مدل بردارسازی فقط در .env تغییر می‌کنند و پس از راه‌اندازی دوباره اعمال می‌شوند.
  • در فایل .env.example فقط انتخاب مدل فعال است. بقیهٔ سطرها مقدار پیش‌فرض را نشان می‌دهند و بر این اساس گروه‌بندی شده‌اند که از تنظیمات برنامه هم تغییر می‌کنند یا نه.
گروه «سرعت ایندکس» در تنظیمات: «تصویرهایی که هم‌زمان خوانده می‌شوند» روی «خودکار»، «هسته‌های CPU برای بردارسازی» با مقدار ۸ و برچسب «در برنامه تغییر کرده»، مقدار .env برابر ۴ با دکمهٔ بازگشت، دکمهٔ «بازگشت همه به .env» و یادداشتی که می‌گوید درگاه، نشانی‌های مجاز، Qdrant، سقف حافظه و مدل بردارسازی فقط از .env تغییر می‌کنند
تنظیمات «اسناد و سرعت». مقداری که در برنامه تغییر کرده، مقدار .env خودش را نشان می‌دهد و می‌توان به آن برگشت.

مدل

متغیرپیش‌فرضکاربرددر برنامه
LLM_PROVIDERollamaمقدار ollama یا apiمدل و اتصال
LLM_MODEL_NAMEدر .env.example: qwen2.5:7bمدلی که پاسخ را می‌نویسدمدل و اتصال
OLLAMA_DOCKER_BASE_URLدر .env.example: http://host.docker.internal:11434نشانی Ollama از دید کانتینر برنامه؛ برای Ollama داخل Docker، http://ollama:11434مدل و اتصال
MODEL_API_BASE_URLhttps://openrouter.ai/api/v1نشانی سرویس سازگار با OpenAIمدل و اتصال
MODEL_API_KEYخالیکلید محرمانهٔ زمان اجرا؛ هرگز روی دیسک نوشته نمی‌شودمدل و اتصال
MODEL_API_DISCLOSURE_ACKNOWLEDGED0رضایت برای استفاده از API خارجیمدل و اتصال
OLLAMA_CONTEXT_LENGTH8192اندازهٔ زمینه‌ای که Ollama برای هر پرسش کنار می‌گذاردمدل و اتصال
OLLAMA_THINK0اجازهٔ «فکر کردن» پیش از پاسخ، برای مدل‌های فکرکنندهمدل و اتصال
MODEL_CONTEXT_WINDOW32768اندازهٔ زمینهٔ فرضی برای مدل‌های APIمدل و اتصال
MODEL_API_MAX_RETRIES4تعداد تلاش دوباره برای خطاهای HTTP 5xx و 429مدل و اتصال
LLM_REQUEST_TIMEOUT_SECONDS120مهلت هر پاسخمدل و اتصال
OLLAMA_ALLOWED_HOSTSخالیمیزبان‌های دیگری که نشانی Ollama می‌تواند داشته باشدفقط .env

جست‌وجو

متغیرپیش‌فرضکاربرددر برنامه
STRICT_RAG_THRESHOLD0.75آستانهٔ دروازهٔ شواهد در «فقط اسناد»پاسخ‌گویی
STRICT_RAG_TOP_Kخالیعمق ثابت جست‌وجو در «فقط اسناد» بین ۱ تا ۵۰؛ خالی یعنی انتخاب جداگانه برای هر پرسشپاسخ‌گویی
HYBRID_RETRIEVE_TOP_K25تعداد نامزدهای اولیه در حالت ترکیبیپاسخ‌گویی
KEYWORD_SEARCH1ترکیب BM25 با جست‌وجوی برداریپاسخ‌گویی
EMBED_MODEL_NAMEintfloat/multilingual-e5-baseمدل embedding؛ با تغییرش باید اسناد را دوباره بارگذاری کنیدفقط .env
EMBED_DEVICEautoیکی از auto، cpu، cuda یا mpsفقط .env
RERANK_MODELminiReranker_arabic_v1رتبه‌بند حالت ترکیبی؛ مقدار none آن را خاموش می‌کندفقط .env

اسناد و OCR

متغیرپیش‌فرضکاربرددر برنامه
PARSRAG_MAX_FILES_PER_SESSION10تعداد فایل در هر گفت‌وگواسناد و سرعت
PARSRAG_MAX_FILE_BYTES104857600۱۰۰ مبی‌بایت برای هر فایلاسناد و سرعت
PARSRAG_MAX_BATCH_BYTES524288000۵۰۰ مبی‌بایت برای هر بارگذاریاسناد و سرعت
OCR_ENABLED1روشن یا خاموش‌کردن OCRاسناد و سرعت
OCR_LANGUAGESfas+engزبان‌های Tesseractاسناد و سرعت
OCR_DPI200وضوح رندر صفحه‌های اسکن‌شدهاسناد و سرعت
OCR_MAX_PAGES30تعداد صفحه‌های اسکن‌شده‌ای که از هر فایل خوانده می‌شوداسناد و سرعت
OCR_MAX_IMAGES200تعداد تصویرهایی که از هر فایل Word یا PowerPoint خوانده می‌شوداسناد و سرعت
SOURCE_IMAGE_PREVIEWS1نگه‌داشتن نسخه‌ای از هر تصویر برای نمایش کنار منبعشاسناد و سرعت
PARSRAG_MAX_REQUEST_BYTES534773760بزرگ‌ترین درخواست بارگذاری؛ سقف‌های بالا از آن بیشتر نمی‌شوندفقط .env

سرعت ایندکس

متغیرپیش‌فرضکاربرددر برنامه
OCR_WORKERSخالیتعداد تصویرهایی که هم‌زمان خوانده می‌شوند؛ خالی یعنی همهٔ هسته‌های CPU، حداکثر ۸اسناد و سرعت
PARSRAG_CPU_THREADS4رشته‌های CPU برای بردارسازی، تا تعداد هسته‌های واقعیاسناد و سرعت
EMBED_BATCH_SIZE8تعداد متن در هر دور بردارسازی؛ با فایل GPU برابر ۳۲اسناد و سرعت
QDRANT_UPSERT_BATCH_SIZE64تعداد بخش‌هایی که در هر نوبت ذخیره می‌شونداسناد و سرعت

سرویس و حافظه

متغیرپیش‌فرضکاربرددر برنامه
PARSRAG_PORT8000پورت روی رایانهٔ شمافقط .env
PARSRAG_BIND_HOST127.0.0.1نشانی‌ای که پورت روی آن باز می‌شودفقط .env
PARSRAG_ALLOWED_HOSTSخالینام‌های میزبانی که جز localhost، 127.0.0.1 و ::1 پذیرفته می‌شوندفقط .env
PARSRAG_APP_MEMORY_LIMIT6gسقف حافظهٔ کانتینر برنامهفقط .env
QDRANT_MEMORY_LIMIT2gسقف حافظهٔ Qdrantفقط .env
OLLAMA_MEMORY_LIMIT12gسقف حافظهٔ کانتینر Ollamaفقط .env
خواندن معرفی کامل دیدن کد در گیت‌هاب

در حال بارگذاری…