Open WebUI و LibreChat

اگر تیمتان یک چت داخلی می‌خواهد، شبیه ChatGPT ولی روی سرور خودتان و با مدل‌هایی که خودتان انتخاب کرده‌اید، Open WebUI و LibreChat دو گزینهٔ متن‌باز رایج‌اند. هر دو اتصال سازگار با OpenAI دارند؛ با کلید گیسو، اعضای تیم از یک صفحه با Claude، Gemini، GPT و DeepSeek گفت‌وگو می‌کنند و کلید فقط روی سرور شما می‌ماند.

Open WebUI

ساده‌ترین راه نصب، Docker است. نشانی و کلید را همان بار اول بدهید:

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://gisoo.pro/api/v1 \
  -e OPENAI_API_KEY=sk-gisoo-v1-... \
  -e ENABLE_OLLAMA_API=false \
  -v open-webui:/app/backend/data \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

1. حساب مدیر

   http://SERVER:3000 را باز کنید؛ اولین حسابی که ساخته شود، مدیر است.

2. اتصال را بررسی کنید

   در Admin Panel → Settings → Connections اتصال OpenAI باید با نشانی گیسو دیده شود. اگر Docker را بدون متغیرها اجرا کرده‌اید، همین‌جا یک اتصال تازه با نشانی و کلید بسازید.

3. فهرست مدل‌ها را کوتاه کنید

   Open WebUI فهرست مدل‌ها را از /models می‌خواند که صدها مدل دارد. در تنظیم همان اتصال، در Model IDs فقط مدل‌هایی را بنویسید که تیم لازم دارد؛ بقیه در فهرست نمی‌آیند.

4. مدل کارهای جانبی

   Open WebUI برای ساختن عنوان گفت‌وگو و پیشنهاد پرسش هم از مدل استفاده می‌کند. در Admin Panel → Settings → Interface مدل این کارها (Task Model) را یک مدل ارزان مثل gpt-4.1-mini بگذارید.

سند، تصویر و صدا

هر کدام همان endpoint گیسو را صدا می‌زند و هزینه‌اش جدا در گزارش مصرف دیده می‌شود: امبدینگ، تصویر و صدا.

LibreChat

در LibreChat گیسو یک endpoint سفارشی (custom endpoint) است. کلید را در .env و تعریف endpoint را در librechat.yaml بگذارید:

# .env of LibreChat
GISOO_API_KEY=sk-gisoo-v1-...

برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.

# librechat.yaml — keep "version" as in the sample file of your LibreChat release
version: 1.2.1
cache: true

endpoints:
  custom:
    - name: "Gisoo"
      apiKey: "${GISOO_API_KEY}"
      baseURL: "https://gisoo.pro/api/v1"
      models:
        default: ["openrouter/anthropic/claude-sonnet-5.5", "gemini-3.6-flash", "gpt-4o-mini"]
        fetch: false
      titleConvo: true
      titleModel: "gpt-4o-mini"
      modelDisplayLabel: "Gisoo"

• fetch: false یعنی فقط مدل‌های فهرست default نشان داده شوند؛ با true صدها مدل کاتالوگ در فهرست می‌آید.
• titleModel مدلی است که عنوان گفت‌وگوها را می‌سازد؛ مدلی ارزان بگذارید.
• اگر LibreChat را با Docker Compose اجرا می‌کنید، فایل librechat.yaml را طبق راهنمای خود LibreChat در کانتینر سوار کنید و سرویس را دوباره راه بیندازید.

کدام مدل‌ها را بگذارید

شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.

برای تیم

• برای چت تیم یک پروژه و کلید جدا با بودجهٔ ماهانه بسازید؛ اگر کسی بی‌حساب مصرف کند، همان بودجه جلویش را می‌گیرد.
• کاربرها کلید گیسو را نمی‌بینند؛ کلید فقط روی سرور است. نقش‌ها و دسترسی هر کاربر را در خود Open WebUI یا LibreChat تعیین کنید.
• اگر روی کلید فهرست IP مجاز می‌گذارید، IP همان سروری را بنویسید که Open WebUI یا LibreChat رویش اجرا می‌شود.

خطاهای رایج

پرسش‌های پرتکرار

راهنماهای مرتبط