How do I connect SillyTavern to OpenAI, Claude, or Gemini?

Open SillyTavern’s API settings and paste your API keys for each provider, then select the model name and save. The official API connections guide lists supported providers and parameters you may need to set.

Can I use SillyTavern with a local model like Llama?

Yes. Run a local backend such as KoboldAI or oobabooga/text-generation-webui, then point SillyTavern to the local server URL. Make sure the backend exposes an API endpoint and is using a compatible instruct-tuned model.

What settings improve roleplay consistency in SillyTavern?

Refine the system prompt, add sample dialogue to the character card, and use a small memory book for facts and relationships. Tune temperature, Top‑p, and repetition penalties to balance creativity and coherence.

Which model is best for long-form storytelling in SillyTavern?

Claude models are strong for long-context narrative coherence, while OpenAI and Gemini are versatile and cost-effective for general chat. Local Llama models are great for privacy if you’re comfortable tuning them.

How do I reduce token costs with API models in SillyTavern?

Shorten context length, enable concise replies, and summarize arcs periodically. You can also switch to lower-cost models for filler scenes and keep premium models for pivotal moments.

نحوه استفاده از SillyTavern: راهنمای عملی برای راه‌اندازی، مدل‌ها و ویژگی‌های پیشرفته RP

مطمئناً نام SillyTavern را شنیده‌اید: یکی از منعطف‌ترین رابط‌های کاربری برای نقش‌آفرینی و گفتگو با مدل‌های زبان بزرگ. اما از کجا شروع می‌کنید، از کدام مدل‌ها باید استفاده کنید و چگونه بهترین ویژگی‌های آن را بدون خراب کردن چیزی فعال کنید؟ این راهنما شما را گام به گام راهنمایی می‌کند—بدون حاشیه، فقط یک مسیر عملی و راه‌حل‌محور از نصب تا جلسات حرفه‌ای.

SillyTavern چیست—و چرا از آن استفاده کنیم؟

SillyTavern یک رابط کاربری قدرتمند و قابل تنظیم برای تعامل با LLMها است—هم APIهای میزبانی شده و هم مدل‌های محلی. آن را به عنوان اتاق کنترل خود برای چت فراگیر، نقش‌آفرینی شخصیت، جهان‌سازی و همکاری در داستان‌نویسی در نظر بگیرید. این برنامه به APIهایی مانند OpenAI، Anthropic و Google متصل می‌شود، یا به backendهای محلی مانند KoboldAI و oobabooga/text-generation-webui (TGI/ExLlama و غیره)، و به شما امکان می‌دهد حس و حال، حافظه و سبک جلسات خود را تنظیم کنید. این برنامه به گونه‌ای طراحی شده است که در عین سادگی، عمیق باشد و دارای ویژگی‌هایی مانند کارت‌های شخصیت، حافظه بلندمدت، افزونه‌ها و کنترل‌های دقیق برای اعلان‌ها و نمونه‌برداری است.

راه‌اندازی سریع: از صفر تا اولین چت

این جریان ساده را دنبال کنید. پس از اینکه راحت شدید، می‌توانید بعداً تنظیمات پیشرفته را دوباره بررسی کنید.

1) نصب و اجرا

SillyTavern را از مخزن GitHub آن (یا یک انشعاب نگهداری شده) کلون یا دانلود کنید و اسکریپت راه‌اندازی موجود را برای سیستم عامل خود دنبال کنید. در ویندوز، معمولاً یک start.bat را برای راه‌اندازی وب سرور محلی اجرا می‌کنید؛ در macOS/Linux، یک اسکریپت start.sh رایج است.

URL محلی نشان داده شده در ترمینال (معمولاً ` یا پورتی که SillyTavern چاپ می‌کند) را باز کنید تا به رابط کاربری دسترسی پیدا کنید.

نکته: پوشه SillyTavern خود را مرتب نگه دارید—کارت‌های شخصیت، تنظیمات از پیش تعیین شده و افزونه‌ها در زیرشاخه‌های قابل پیش‌بینی قرار دارند و پشتیبان‌گیری را آسان‌تر می‌کنند.

2) مسیر مدل خود را انتخاب کنید: API یا محلی

API میزبانی شده: سریع‌ترین راه برای شروع؛ کلید API خود را در پنل تنظیمات API در SillyTavern وارد کنید.

Backend محلی: بهترین گزینه برای حفظ حریم خصوصی و کنترل؛ SillyTavern را به یک سرور محلی مانند KoboldAI یا oobabooga/text-generation-webui متصل کنید.

SillyTavern از طیف گسترده‌ای از ارائه‌دهندگان API و کانکتورهای محلی پشتیبانی می‌کند، با یادداشت‌هایی در مورد نقاط قوت، محدودیت‌ها و موارد استفاده در اسناد.

3) وارد کردن اطلاعات کاربری API (در صورت استفاده از مدل‌های میزبانی شده)

OpenAI، Anthropic، Google ({Gemini}) و سایر موارد را می‌توان با چسباندن کلیدهای API در تب اتصالات SillyTavern اضافه کرد.

نکته: از تنظیمات از پیش تعیین شده برای هر ارائه‌دهنده استفاده کنید؛ مدل‌های مختلف به اعلان‌های سیستمی، دما و جریمه‌های کمی متفاوت بهتر پاسخ می‌دهند.

گزارش‌های انجمن نشان می‌دهد که می‌توان از {Gemini} گوگل به صورت رایگان با کلید Google AI Studio استفاده کرد، که آن را به یک نقطه شروع مقرون به صرفه برای آزمایش تبدیل می‌کند.

4) اتصال به LLMهای محلی (اختیاری)

Backend محلی خود ({KoboldAI}، text-generation-webui/oobabooga، LM Studio و غیره) را شروع کنید و تأیید کنید که یک نقطه پایانی API ارائه می‌دهد.

در SillyTavern، کانکتور مربوطه را انتخاب کنید و URL محلی و هر پارامتر مورد نیاز را وارد کنید.

با ارسال یک پیام آزمایشی کوتاه، اعتبارسنجی کنید.

5) ایجاد یا وارد کردن یک شخصیت

برای ساختن از ابتدا روی Characters → New کلیک کنید، یا یک کارت شخصیت (PNG/JSON) را از کتابخانه خود وارد کنید.

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

6) شروع چت

شخصیت و مدل خود را انتخاب کنید، سپس اولین پیام خود را بنویسید.

از یک شروع نرم مانند: «بیایید صحنه را آماده کنیم: .» استفاده کنید.

مدل‌های مبتنی بر Llama محلی: خصوصی، قابل تنظیم؛ کیفیت به کوانتیزاسیون و تنظیم دقیق بستگی دارد.

پشته‌های KoboldAI/oobabooga: کنترل عمیق بر استنتاج، فرمت‌های اعلان و افزونه‌ها.

راهنمای اتصالات API در SillyTavern، ارائه‌دهندگان پشتیبانی شده و هشدارها را در یک مکان شرح می‌دهد.

ساخت شخصیت: ساختن شخصیت‌هایی که در نقش خود باقی می‌مانند

یک جلسه عالی با یک کارت شخصیت عالی شروع می‌شود.

شخصیت: 2-4 جمله در مورد هویت، نقش، صدا.

پیشینه: 3-5 نکته اصلی از تاریخ شکل‌گیری؛ از جدول زمانی جامع خودداری کنید.

اهداف و مرزها: خواسته‌ها و خطوطی را که شخصیت از آن عبور نمی‌کند، روشن کنید.

الگوهای گفتاری: چند نمونه از اصطلاحات یا ویژگی‌های غیرعادی اضافه کنید.

گفتگوی نمونه: 3 تبادل که لحن، سرعت و دامنه احساسی را برجسته می‌کند.

نکته حرفه‌ای: لنگرهای محیطی (به عنوان مثال، «شهر بوی باران و نئون قدیمی می‌دهد») را اضافه کنید تا مدل را بدون یادآوری مداوم، توصیفی نگه دارید.

افزونه‌ها، پلاگین‌ها و ویژگی‌های قدرتمند

SillyTavern دارای یک اکوسیستم از افزودنی‌ها است که قابلیت‌های آن را گسترش می‌دهد:

حافظه و کتاب‌های اطلاعات: تزریق خودکار حقایق کلیدی در صورت شناسایی محرک‌ها.

ابزارهای جهان/داستان: الگوهای صحنه، فهرست NPC و اعلان‌های رویداد.

TTS/STT: جلسات خود را با تبدیل متن به گفتار و گفتار به متن فعال کنید.

قلاب‌های تصویر: برخی از کانکتورها از اعلان‌ها/پاسخ‌های تصویری پشتیبانی می‌کنند (وابسته به مدل).

اتوماسیون: ماکروها برای ضرب‌های روایی مکرر یا قالب‌بندی.

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

ایمنی، فیلترها و مرزها

سیاست‌های مدل: مدل‌های API (به عنوان مثال، Anthropic، Google) قوانین ایمنی را اعمال می‌کنند که ممکن است بر انواع خاصی از محتوا تأثیر بگذارد. اهداف خلاقانه خود را بر این اساس تنظیم کنید.

کنترل محلی: مدل‌های محلی آزادی بیشتری به شما می‌دهند اما مسئولیت بیشتری نیز دارند—مرزهای شخصی و برچسب‌های محتوا را از قبل تعیین کنید.

بهداشت جلسه: از هشدارهای محتوایی، صحنه‌های اختیاری و انتقال‌های واضح استفاده کنید. اگر چیزی از مسیر خارج شد، خلاصه کنید، لحن را بازنشانی کنید و سناریو را دوباره تثبیت کنید.

عیب‌یابی: رفع سریع مشکلات رایج

مدل تکرار می‌شود یا حلقه می‌زند: جریمه تکرار را افزایش دهید، دما را کمی کاهش دهید، حقایق زمینه‌ای بیشتری به حافظه اضافه کنید.

پاسخ‌های خارج از شخصیت: تعریف شخصیت را تقویت کنید و 2-3 گفتگوی نمونه اضافه کنید؛ اعلان سیستم را سفت کنید.

هزینه‌ها افزایش می‌یابد (استفاده از API): طول متن را کاهش دهید، پاسخ‌های کوتاه‌تر را فعال کنید، به طور دوره‌ای خلاصه کنید، یا برای صحنه‌های پرکننده به یک مدل کم‌هزینه‌تر تغییر دهید.

مدل محلی کند است: یک کوانتیزاسیون کوچک‌تر را امتحان کنید، شتاب GPU را فعال کنید، یا حداکثر توکن‌ها را کاهش دهید.

خطاهای اتصال: URL ارائه‌دهنده، اعتبار کلید و نام مدل را دوباره بررسی کنید. برای پارامترهای دقیق به صفحه اتصالات API مراجعه کنید.

یک گردش کار شروع 10 دقیقه‌ای (این را کپی کنید)

یک ارائه‌دهنده را انتخاب کنید (به عنوان مثال، {Gemini} برای آزمایش‌های کم‌هزینه یا Claude برای قوس‌های داستانی طولانی).

یک شخصیت با شخصیت، نکات اصلی پیشینه و 3 گفتگوی نمونه ایجاد کنید.

دما را روی 0.8، Top‑p 0.9، جریمه تکرار متوسط تنظیم کنید.

یک کتاب حافظه کوچک اضافه کنید: تنظیمات، روابط، اهداف فعال.

چت را با یک تنظیم صحنه واضح و لحن دلخواه شروع کنید.

پس از 10 پیام، چت را صادر کنید، دو بهبود را یادداشت کنید و کارت شخصیت را به روز کنید.

این حلقه را تکرار کنید و شاهد افزایش چشمگیر سازگاری خواهید بود.

نکات ویژه مدل (برگه تقلب)

OpenAI: اعلان‌های سیستم مختصر را دوست دارد؛ دستورالعمل‌ها را به وضوح با مراحل شماره‌گذاری شده فرمت کنید.

Claude: در خلاصه‌های چند پاراگرافی رشد می‌کند؛ برای تداوم روایی و خلاصه‌ها عالی است.

Gemini: با اعلان‌های ساختاریافته و محدودیت‌های صریح به خوبی کار می‌کند؛ سهمیه‌های سطح رایگان را بررسی کنید.

Llama محلی: از انواع تنظیم شده با دستورالعمل استفاده کنید؛ 2-3 کوانتیزاسیون را برای سرعت/کیفیت آزمایش کنید.

پشتیبان‌گیری، صادرات و سازماندهی

از پوشه‌های جداگانه برای هر «جهان» استفاده کنید تا از آلودگی متقابل اطلاعات جلوگیری شود.

به طور مرتب چت‌ها (JSON/HTML) را صادر کنید و از کارت‌های شخصیت خود عکس بگیرید.

یک سند «متا» با ثبت تنظیمات نمونه‌برداری، نسخه‌های مدل و جلسات قابل توجه نگه دارید.

شایان ذکر است: تسریع گردش کار خود با Sider.AI

اگر پیش‌نویس بیوگرافی‌های شخصیت، طرح‌های صحنه یا اطلاعات را خارج از SillyTavern تهیه می‌کنید، یک دستیار نوار کناری می‌تواند به شما در تکرار سریع کمک کند. به هر حال، دستیار درون مرورگر Sider.AI می‌تواند رونوشت‌های طولانی را خلاصه کند، ویژگی‌های غیرعادی شخصیت را پیشنهاد کند یا بذرهای صحنه را ایجاد کند، سپس می‌توانید نتایج را مستقیماً در SillyTavern جای‌گذاری کنید. این یک همراه پیش تولید مفید برای جهان‌سازی و صیقل دادن اعلان است.

نکات کلیدی

ساده شروع کنید: یک ارائه‌دهنده، یک شخصیت و یک کتاب حافظه کوچک را انتخاب کنید.

کنترل پادشاه است: اعلان‌های سیستم، نمونه‌برداری و حافظه، سازگاری را شکل می‌دهند.

مدل‌ها را بر اساس هدف انتخاب کنید: طول روایت، هزینه، خلاقیت یا حریم خصوصی.

تکرار: کارت شخصیت و تنظیمات از پیش تعیین شده خود را صادر، بررسی و اصلاح کنید.

منابع

بررسی اجمالی اتصالات API در SillyTavern: ارائه‌دهندگان، محدودیت‌ها و یادداشت‌های پشتیبانی شده.

بحث انجمن در مورد بهترین مدل‌ها و گزینه‌های رایگان/کم‌هزینه مانند {Gemini}.

بررسی اجمالی GitHub از SillyTavern به عنوان یک frontend LLM برای نقش‌آفرینی و چت.

سوالات متداول

Q1: چگونه SillyTavern را به OpenAI، Claude یا Gemini متصل کنم؟ تنظیمات API در SillyTavern را باز کنید و کلیدهای API خود را برای هر ارائه‌دهنده جای‌گذاری کنید، سپس نام مدل را انتخاب و ذخیره کنید. راهنمای رسمی اتصالات API، ارائه‌دهندگان پشتیبانی شده و پارامترهایی را که ممکن است نیاز به تنظیم داشته باشید، فهرست می‌کند.

Q2: آیا می‌توانم از SillyTavern با یک مدل محلی مانند Llama استفاده کنم؟ بله. یک backend محلی مانند KoboldAI یا oobabooga/text-generation-webui را اجرا کنید، سپس SillyTavern را به URL سرور محلی هدایت کنید. مطمئن شوید که backend یک نقطه پایانی API را در معرض دید قرار می‌دهد و از یک مدل تنظیم شده با دستورالعمل سازگار استفاده می‌کند.

Q3: چه تنظیماتی سازگاری نقش‌آفرینی را در SillyTavern بهبود می‌بخشد؟ اعلان سیستم را اصلاح کنید، گفتگوی نمونه را به کارت شخصیت اضافه کنید و از یک کتاب حافظه کوچک برای حقایق و روابط استفاده کنید. دما، Top‑p و جریمه‌های تکرار را برای ایجاد تعادل بین خلاقیت و انسجام تنظیم کنید.

Q4: کدام مدل برای داستان‌سرایی بلندمدت در SillyTavern بهترین است؟ مدل‌های Claude برای انسجام روایی با متن طولانی قوی هستند، در حالی که OpenAI و Gemini برای چت عمومی همه‌کاره و مقرون به صرفه هستند. مدل‌های Llama محلی برای حریم خصوصی عالی هستند اگر از تنظیم آنها راحت باشید.

Q5: چگونه هزینه‌های توکن را با مدل‌های API در SillyTavern کاهش دهم؟ طول متن را کوتاه کنید، پاسخ‌های مختصر را فعال کنید و به طور دوره‌ای قوس‌ها را خلاصه کنید. همچنین می‌توانید برای صحنه‌های پرکننده به مدل‌های کم‌هزینه‌تر تغییر دهید و مدل‌های ممتاز را برای لحظات محوری نگه دارید.