Settings & Configuration

StudioBrain’s Settings page provides centralized control over every aspect of the application. Open Settings from the sidebar gear icon. Settings are organized into sections, each accessible from the Settings hub.

Settings are saved per user and persist across sessions. On Team and Enterprise plans, tenant owners and group admins can override certain settings to enforce policies across their organization.

General Settings

Core application configuration that affects the overall behavior of your StudioBrain instance.

Setting	Default	Description
Site Name	”StudioBrain”	Application title displayed in the navigation bar and browser tab.
Tagline / Project Name	(empty)	Appears below the site name in the sidebar. Useful for identifying which project is open.
Site Logo	(none)	Upload a custom logo image. Displayed in the navigation sidebar.
Favicon	(default)	Browser tab icon. Accepts an emoji or uploaded image.
Site Description	(empty)	Meta description for the application, used in browser previews and SEO.
Default Language	English	Interface language.
Time Zone	America/Los_Angeles	Used for timestamps on entities, activity logs, and sync events.
Auto-Save Enabled	On	Automatically save entity changes as you edit.
Auto-Save Interval	60 seconds	How frequently auto-save triggers. Range: 10-300 seconds.

Content Path

The project root directory containing your entities, templates, rules, and assets. Change this to switch between different StudioBrain projects.

Startup Behavior

Setting	Default	Description
Sync on Launch	On (Indie+)	Sync with cloud storage immediately on app launch.
Skip Startup Scan	Off	Skip the initial file scan for faster launches. Uses the cached database instead of re-scanning the filesystem.

Data and Privacy

Setting	Default	Description
Telemetry	Off	Anonymous usage statistics to help improve StudioBrain. Opt-in only.
Crash Reports	Off	Automatic error reporting. Opt-in only.
Data Export	—	Export all your data as a ZIP archive of Markdown files at any time.

Display Settings

Control how the interface looks and scales, independent of theme colors.

Grid Layout

These settings affect how entity lists and card grids render across different screen sizes.

Setting	Default	Range	Description
Grid Density	Normal	Comfortable / Normal / Compact	Spacing between cards and list items.
Minimum Card Width	280px	200-400px	Minimum width for entity cards. Affects how many columns fit per row.
Maximum Columns	8	3-12	Hard limit on columns, useful for ultrawide displays.
Adaptive Grid	On	—	Automatically adjust columns to screen width.

UI and Text Scaling

These settings ensure readability across different displays, from laptops to ultrawide monitors.

Setting	Default	Range	Description
UI Scale	1.0x	0.75x-2.0x	Global scaling multiplier for all UI elements.
Text Scale	Base	xs / sm / base / lg / xl / 2xl	Text size multiplier applied across the application.
Minimum Text Size	12px	10-20px	Floor for the smallest text. Prevents text from becoming unreadable at lower scales.

Theme Settings

StudioBrain uses a semantic surface token system for theming. Every color in the interface is controlled through 12 semantic surfaces, each with 7 coordinated properties.

Mode and Font

Setting	Default	Options	Description
Theme Mode	Light	Light / Dark / System	Color scheme. “System” follows your OS preference.
Font Size	Medium	Small / Medium / Large	Base font size for the application.
Font Family	Inter	Inter, SF Pro, Segoe UI, Roboto, Open Sans, JetBrains Mono, Fira Code	Primary font used throughout the interface.
Custom CSS	(empty)	—	Raw CSS for advanced customization. Applied after the theme.

Semantic Surface Editor

The Theme Editor lets you customize each of the 12 surfaces individually, for both light and dark mode. Each surface has 7 properties:

Property	Description
Background	The surface’s background color.
Text	Primary text color on this surface.
Text Secondary	Muted/secondary text color on this surface.
Border	Border color for elements on this surface.
Hover	Background color when hovering over interactive elements.
Active	Background color when clicking/pressing interactive elements.
Shadow	Shadow color for elevated elements on this surface.

The 12 Surfaces

Surface	Purpose	Example Uses
Base	Main page background and content areas	Page background, section containers
Elevated	Cards, panels, sidebars	Editor panels, card components, property sheets
Overlay	Modals, dropdowns, tooltips	Dialog boxes, context menus, popovers
Primary	Primary brand actions	CTA buttons, active tabs, selected items
Secondary	Secondary actions	Alternative buttons, secondary navigation
Accent	Highlights, special emphasis	AI feature badges, notification dots, special labels
Success	Positive states	Confirmation alerts, saved indicators, online status
Warning	Caution states	Warning alerts, pending status, quota warnings
Error	Error and destructive states	Error alerts, delete buttons, validation errors
Info	Informational states	Tips, help text, informational badges
Navigation	Navigation areas	Sidebar, top nav bar, breadcrumbs
Input	Form controls	Text fields, selects, textareas, checkboxes

Changes apply in real time across all open browser tabs. Themes are saved per user.

Layout Designer Surface Overrides

The Layout Designer allows per-section surface overrides within entity edit pages. Each section can specify which surface it uses, enabling visual hierarchy:

A section with “elevated” surface sits visually above the base
Critical fields can use “warning” or “error” surface for emphasis
AI-related sections can use “accent” surface

Team Theme Policies

On Team and Enterprise plans, tenant owners can:

Lock theme settings to enforce brand consistency across all team members
Set a default theme that new members inherit
Restrict custom CSS to prevent users from breaking the interface
Enforce light or dark mode

AI Services Settings

Configure AI providers, local services, generation parameters, and content moderation.

Local AI Service

The built-in AI orchestration service handles AI routing, context building, and local model inference.

Setting	Default	Description
Local AI Enabled	On	Enable the StudioBrain AI service.
Local AI URL	http://localhost	AI service hostname.
Local AI Port	8202	AI service port.

External AI Providers

Each external provider requires an API key. Keys are encrypted at rest and stored per user.

Provider	Key Format	Model Default	How to Get a Key
OpenAI	`sk-...`	gpt-4	platform.openai.com/api-keys
Anthropic	`sk-ant-...`	claude-3-sonnet	console.anthropic.com/settings/keys
Google Gemini	API key string	gemini-1.5-pro-latest	aistudio.google.com/apikey
Grok	API key string	grok-beta	console.x.ai

Each provider shows a status indicator:

Green check — Key is valid and the provider is available
Red X — Key is invalid or the provider is unreachable
Gray circle — No key configured

Click Test next to any provider to verify connectivity, key validity, model availability, and response time.

Ollama Integration

Run open-source models locally through Ollama.

Setting	Default	Description
Ollama Enabled	Off	Enable Ollama local model support.
Ollama URL	http://localhost	Ollama server address.
Ollama Port	11434	Ollama server port.
Ollama Model	llama2	Model name to use for generation.

ComfyUI Integration

Image generation through ComfyUI, available in local (self-hosted) or cloud mode.

Setting	Default	Description
ComfyUI Enabled	Off	Enable ComfyUI image generation.
ComfyUI Mode	Local	Local (self-hosted ComfyUI) or Cloud (API-based).
ComfyUI URL	http://localhost	Local ComfyUI server URL. Ignored in cloud mode.
ComfyUI Port	8188	Local ComfyUI server port.
ComfyUI API Key	(empty)	Optional key for secured local instances.
ComfyUI Cloud API Key	(empty)	Required API key for cloud mode.

Generation Parameters

Default parameters for AI text generation. These can be overridden per request in the AI Workshop.

Setting	Default	Description
Default Service	Local	Primary AI service to use for generation.
Max Tokens	4096	Maximum tokens per generation request.
Temperature	0.7	Controls randomness. 0.0 = deterministic, 1.0 = creative.
Streaming Enabled	On	Stream AI responses in real time as they generate.
Service Priority	local, claude, gpt, grok, google, ollama	Fallback order when the selected provider is unavailable.

Entity Chat Settings

Configuration specific to the entity chat feature (AI conversations about individual entities).

Setting	Default	Description
Default Provider	openai	Provider used for entity chat conversations.
Entity Chat Model	gpt-4o	Specific model for entity conversations.
Max Tokens	8192	Maximum tokens per entity chat response.
Timeout	120 seconds	Maximum time to wait for a response.
Polling Interval	1 second	How often to check for task completion.

Image Generation Settings

Setting	Default	Tier	Description
Default Provider	openai_dalle	All	Primary image generation service.
Enable Qwen Image	On	Indie+	Enable local Qwen image generation.
Enable Qwen Image Edit	On	Team+	Enable AI-powered image editing.
Qwen Image Quality	Standard	Indie+	draft / standard / high
Qwen Image Style	Realistic	Indie+	Default art style for generation.

Video Generation Settings

Setting	Default	Tier	Description
Default Provider	openai_sora	Team+	Video generation service.
Default Duration	8 seconds	Team+	Default video length.
Default Resolution	720p	Team+	Output resolution.
Default Aspect Ratio	16:9	Team+	Frame aspect ratio.

AI Feature Toggles

Control which AI features are active. Some features are tier-gated.

Setting	Default	Tier	Description
Smart Import	On	Indie+	Use AI to enhance imported content.
Content Generation	On	Indie+	AI generation for entity fields.
Image Generation	On	Indie+	AI image creation.
Vector Search	Off	Team+	RAG-based semantic search across entities.

Rate Limiting

Setting	Default	Description
Requests Per Minute	60	Maximum AI requests per minute.
Enable Rate Limit	On	Enforce rate limiting. Prevents accidental cost spikes.

Timeout Configuration

Setting	Default	Description
Generation Timeout	600 seconds	Maximum time for a single AI generation.
Request Timeout	350 seconds	API request timeout.
Quick Test Timeout	30 seconds	Timeout for provider health checks.
Local Test Timeout	180 seconds	Timeout for local AI tests (longer due to model loading).

Content Moderation

Safety settings for AI-generated content. These are admin-level settings.

Setting	Default	Description
OpenAI Moderation	Low	Least restrictive. Options: low, auto.
Google Moderation	BLOCK_NONE	Google safety block level.
Grok Moderation	None	Options: none, low, auto.
Global Override	On	Enforce moderation settings on all requests regardless of provider selection.

Provider Priority

StudioBrain resolves providers in this order:

User-selected provider — Whatever you choose in the AI Workshop
BYO API key — Your own key, no BrainBits consumed
Managed AI fallback — StudioBrain Orchestrator (paid tiers), consumes BrainBits
Local AI — Qwen, free, used as final fallback

Vision and Image Analysis Settings

Configure how StudioBrain analyzes images using vision models. These settings affect asset tagging, captioning, and deep analysis.

Tagging Models

Setting	Default	Tier	Description
Primary Tagging Model	auto	All	Model used to generate tags for uploaded images.
Secondary Tagging Model	none	Team+	Backup tagging model for cross-referencing.
Combine Tagging Results	Off	Team+	Merge tags from primary and secondary models.
Confidence Threshold	0.7	All	Minimum confidence score to accept a tag. Range: 0.0-1.0.
Max Tags Per Image	20	All	Limit on tags returned per image.

Caption Models

Setting	Default	Tier	Description
Primary Caption Model	blip2	All	Model used to generate image captions.
Generate Long Captions	On	All	Generate extended multi-sentence descriptions.
Generate Short Captions	Off	Team+	Generate one-line summary captions.

Deep Analysis

Deep analysis uses advanced vision models to provide detailed, context-aware analysis of images in relation to your entities.

Setting	Default	Tier	Description
Deep Analysis Model	qwen3_vl	Team+	Vision model for advanced analysis.
Include Context in Analysis	On	Team+	Feed entity context into the analysis prompt.
Max Context Images	5	Team+	Number of related images to include for cross-reference.
Custom Analysis Prompts	11 entity-specific prompts	Team+	Tailored analysis prompts per entity type (character, location, brand, etc.).

Processing Options

Setting	Default	Tier	Description
Enable OCR	On	Team+	Extract text from images.
Enable Color Extraction	On	All	Extract dominant colors from images.
Enable Batch Processing	On	Team+	Process multiple images at once.

GPU Models Settings

Manage GPU model loading and memory allocation. These settings apply to self-hosted and Enterprise deployments with dedicated GPU hardware.

Setting	Default	Tier	Description
Preload Models at Startup	On	Team+	Load models into GPU memory when the AI service starts.
Keep Tier 1 Always Loaded	Off	Team+	Prevent unloading of core models (embedding, tagging).
Auto-Unload Timeout	300 seconds	Team+	Unload idle models after this many seconds to free GPU memory.

The GPU Models panel also displays:

Currently loaded models with VRAM usage
Available models that can be loaded on demand
Load/unload controls for each model
Total GPU memory usage and availability

Note: GPU model management is only relevant for self-hosted deployments with local GPU access. Cloud-tier users access AI through managed APIs.

RAG Configuration

RAG (Retrieval-Augmented Generation) settings control how the vector database indexes your entities and enriches AI prompts with relevant context.

Local RAG (ChromaDB)

Used on the Free tier and desktop-only mode. ChromaDB stores entity embeddings locally.

Setting	Default	Description
Embedding Model	all-MiniLM-L6-v2	Model used to generate embeddings.
Index on Save	On	Re-index an entity every time it is saved.
Search Results	5	Number of similar entities returned for RAG context.

Cloud RAG (Qdrant)

Used on paid tiers with cloud sync. Qdrant provides the vector database with per-tenant collections.

Setting	Default	Tier	Description
Vector DB Type	qdrant	Team+	qdrant or chroma.
Chunk Size	Configurable	Team+	Tokens per document chunk.
Chunk Overlap	Configurable	Team+	Overlapping tokens between chunks.
Auto-Index Changes	On	Team+	Automatically re-index when entities are modified.
Index File Types	md, txt, json	Team+	File types to index for RAG retrieval.

RAG Operations

The RAG settings page provides manual controls:

Index modified files — Re-index only files that changed since last indexing
Full reindex — Rebuild the entire vector index from scratch
Index specific types — Re-index only certain entity types
Test search — Enter a query and view matching results with relevance scores

Rules Settings

Rules control validation and AI generation behavior for each entity type. Rules are stored as Markdown files in _Rules/ and can be managed through the Settings interface.

Global Rule Settings

Setting	Default	Description
Enforce Strict Mode	On	Apply all rules strictly. When off, rules generate warnings instead of errors.
Validate on Create	On	Run validation rules when creating new entities.
Validate on Update	On	Run validation rules when editing existing entities.
Validate on Import	On	Run validation rules when importing entities from files.

Per-Entity-Type Rules

Each entity type (character, location, brand, dialogue, etc.) has its own set of rules:

Setting	Description
Active Rules	Toggle individual rules on or off per entity type.
Apply Defaults	Use default values from rules when creating new entities.
Personality Modifiers	(Dialogue) Apply character personality to generated dialogue.
Relationship Aware	(Dialogue) Consider character relationships when generating dialogue.
System Prompts	Edit the AI system prompts used for entity generation.

Rule Management

Through the Settings interface you can:

Add new rules with auto-generated rule IDs
Edit existing rules (description, category, priority, validation type)
Delete rules
Toggle rule enforcement per entity type
Edit the Markdown documentation body for each rule

For details on rule file format, see Template Authoring.

Template Settings

Templates define your entity types. The Template Manager provides a visual interface for viewing and editing templates.

Template Manager

Feature	Description
Entity Type Selector	Choose from all discovered entity types (character, location, brand, district, faction, item, job, campaign, dialogue, event, quest, style_bible, timeline, universe, and any custom types).
YAML Frontmatter Editor	View and edit the structured data fields that define the entity type’s schema.
Markdown Body Editor	View and edit the content template that new entities are initialized with.
Generation Instructions	View and edit the AI instructions used when generating entities of this type.
Reload from Disk	Re-sync the template from the filesystem if it was edited externally.

Template Health Check

Each template displays a health status indicating:

Whether frontmatter is valid YAML
Whether a Markdown body is present
Whether AI generation instructions are included

For details on creating custom templates, see Template Authoring.

Production Status Settings

Production status tracks provide pipeline visibility for entities as they move through your production workflow.

Available Tracks

Track	Stages	Use Case
General	Concept, Draft, In Progress, Review, Approved, Final, Published, Live	Default pipeline for most entity types
Game (UEFN)	None, Concept, Modeling, Rigging, Texturing, Testing, Approved, Live	Game asset production
TV / Showrunner	None, Concept, Script, Pre-Production, Production, Post-Production, Review, Archived	TV/film production pipeline

Admins can customize the stage names and order for each track.

Entity Types Settings

A read-only reference view showing the schema for each entity type.

Feature	Description
Entity Type Schemas	View all fields for each entity type, including field names, types, and defaults.
Form Layouts	See how fields are mapped to form components in the visual editor.
Preview Renders	How entities display in list views and card grids.

Service Control Settings

Monitor and control the services that make up your StudioBrain deployment. This section is primarily relevant for self-hosted, desktop, and Enterprise deployments.

Service Status

Real-time status for each service:

Service	Port	Description
Backend API	8201	FastAPI server handling entities, auth, sync.
AI Service	8202	AI orchestration, model inference, RAG.
Frontend	3100	Next.js web interface.

Service Controls

Action	Description
Start	Start a stopped service.
Stop	Gracefully stop a running service.
Restart	Stop and start a service.

Console Output

Each service has a View Console button that opens a real-time log viewer with:

Streaming log output with 3-second polling
Search and filter by log level (DEBUG, INFO, WARN, ERROR)
Auto-scroll with pause/resume
Download and copy log contents
Clear log files

Log files:

backend-api.log — API requests, database operations, sync events
ai-service.log — AI generation, model loading, GPU status
frontend-studio.log — Build output, client interactions, SSR errors

Note: Service Control is only available on self-hosted and desktop deployments. Cloud-tier users access managed infrastructure.

Security Settings

Setting	Default	Tier	Description
Enable Authentication	On	All	Require login to access the application.
Session Timeout	3600 seconds	All	Auto-logout after this many seconds of inactivity.
Require MFA	Off	Team+	Mandate two-factor authentication for all users.
Allowed CORS Origins	localhost	All	Cross-origin sources allowed to access the API.
Encrypt Local Storage	Off	All	Encrypt settings and cached data in browser storage.

SSO and OAuth Settings

Single Sign-On configuration for Team and Enterprise plans.

Setting	Default	Tier	Description
Google OAuth Enabled	Off	Team+	Enable Sign in with Google.
Google Client ID	(empty)	Team+	OAuth 2.0 client ID from Google Cloud Console.
Google Client Secret	(empty)	Team+	OAuth 2.0 client secret.
GitHub OAuth Enabled	Off	Team+	Enable Sign in with GitHub.
GitHub Client ID	(empty)	Team+	OAuth App client ID from GitHub Settings.
GitHub Client Secret	(empty)	Team+	OAuth App client secret.
Custom OIDC Enabled	Off	Enterprise	Connect a custom OIDC identity provider (Okta, Auth0, etc.).
OIDC Provider URL	(empty)	Enterprise	The OIDC discovery endpoint URL.

Notification Settings

Configure how StudioBrain alerts you about important events.

Channels

Setting	Default	Tier	Description
Email Notifications	Off	All	Send alerts to your email. Requires SMTP configuration.
Email Server	(empty)	All (Admin)	SMTP server address for outbound email.
Slack Notifications	Off	All	Send alerts to a Slack channel.
Slack Webhook	(empty)	All (Admin)	Incoming webhook URL from Slack.
Discord Notifications	Off	All	Send alerts to a Discord channel.
Discord Webhook	(empty)	All (Admin)	Webhook URL from Discord channel settings.

Notification Types

Setting	Default	Description
Generation Complete	On	Alert when an AI generation finishes.
Error	On	Alert on API errors and service failures.
Storage Warning	On	Alert when approaching storage limits.
Rate Limit	On	Alert when rate limited by an AI provider.

User Management Settings

Team and Enterprise plans only. Manage team members from Settings > User Management.

Feature	Description
User List	View all users with their roles, status, and usage.
Invite User	Send an email invite to add a new team member.
Change Role	Set a user’s role: viewer, editor, admin, or owner.
Storage Quota	Set per-user storage limits.
Token Quota	Set per-user monthly BrainBits allocation from the team pool.
Disable User	Deactivate an account. The user’s data is preserved.
Reset Password	Force a password change on next login.

Team Admin Overrides

On Team and Enterprise plans, tenant owners and admins can enforce settings across the organization:

Override	Description
Lock Theme	Enforce a specific theme for all team members.
Lock Branding	Enforce site name, logo, and favicon.
Restrict User Access	Control which sections users can access.
Enforce Moderation	Lock content moderation settings so users cannot disable them.
Set Default Provider	Set the default AI provider for the team.
Allocate BrainBits	Distribute the pooled monthly quota across team members.

Billing and Usage Settings

Track your subscription, BrainBits usage, and manage your plan.

Current Plan

Field	Description
Current Tier	Your active plan (Free, Indie, Team, Enterprise).
Monthly Quota	BrainBits allocated per billing cycle.
Used This Month	Current usage with visual progress bar.
Remaining	Budget remaining until quota resets.
Reset Date	When your monthly quota resets (from Stripe).

Usage Trends

Usage chart — Time series graph showing BrainBits consumption over time
Period filter — View by day, week, or month
Usage by provider — Pie chart breakdown across AI services

Team Usage (Team+ Only)

Feature	Description
Organization Token Pool	Total team allocation.
Unallocated Pool	Tokens not yet assigned to any member.
Member Usage Table	Per-user breakdown of consumption.
Allocate Quota	Distribute tokens from the pool to individual members.

Token Purchases

On Indie plans and above, you can purchase additional BrainBits token blocks:

Choose a block size (1M, 5M, or 10M tokens)
Purchase is processed through Stripe
Purchased tokens do not expire

Invoices

View all invoices with amounts and dates
Download invoice PDFs
Access the Stripe Customer Portal for subscription management

For full plan details, see Billing & Plans.

Storage Settings

Manage storage providers and monitor usage.

Storage Usage

Field	Description
Storage Used	Current disk/cloud usage.
Storage Limit	Plan allocation (local: unlimited, Indie: 25 GB, Team: 100 GB).
Usage Percentage	Visual progress bar.

Storage Providers

Provider	Tier	Description
LocalFS	All	Default. Files stored on your machine’s disk.
Google Drive	Indie+	Sync to Google Drive via OAuth.
S3	Team+	Amazon S3 bucket. Enter bucket name, region, access key, secret key.
Azure Blob	Team+	Azure Blob Storage. Enter container name and connection string.
NAS / SMB	Team+	Network share. Enter network path and credentials.

Storage Actions

Action	Description
Connect / Disconnect Provider	Link or unlink a cloud storage provider.
Optimize Storage	Compress and clean up storage to reclaim space.
Clear Cache	Clear local caches to free memory.

Google Drive Settings

Detailed configuration for Google Drive sync (Indie+ plans).

Setting	Default	Description
Google Drive Enabled	Off	Enable cloud sync to Google Drive.
Drive Folder ID	(empty)	Target folder in your Google Drive.
Auto-Sync Enabled	On	Automatically sync on changes.
Sync Interval	300 seconds	How often to push changes.
Sync Direction	Bidirectional	One-way (local to cloud, or cloud to local) or two-way sync.

Backup Settings

Setting	Default	Tier	Description
Auto-Backup Enabled	Off	Indie+	Enable automatic scheduled backups.
Backup Interval	Daily	Indie+	daily / weekly / monthly.
Backup Location	./backups	Indie+	Where to store backup files.
Max Backups Retained	10	Indie+	Older backups are automatically deleted.
Include Assets	On	Indie+	Include binary files (images, audio, video) in backups.
Create Backup Now	—	All	Trigger an immediate backup.
Download Latest	—	All	Export the most recent backup file.

Plugin Management

Manage installed plugins from Settings > Plugins. StudioBrain ships with 22 built-in plugins.

Plugin Browser

The plugin list shows:

Plugin name, version, and author
Current status (enabled / disabled)
Entity type compatibility

Per-Plugin Settings

Some plugins have their own configuration:

Setting	Description
Entity Type Binding	Which entity types the plugin panel appears on.
API Keys	Some plugins (Discord Poster, Jira Sync) require their own credentials.
Display Options	Panel size, default visibility, positioning within the editor.

Plugin Actions

Action	Description
Enable	Activate the plugin. It becomes available in entity editors and the Layout Designer.
Disable	Turn off the plugin. Its data is preserved.
Remove	Delete the plugin and its configuration. Entity data stored in YAML is preserved.
Browse Gallery	(Team+) Browse and install plugins from the marketplace.

For plugin development, see Plugin Development. For using plugins, see Using Plugins.

Discord Bot Settings

Team+ plans only. Integrate StudioBrain with a Discord server.

Setting	Default	Description
Discord Bot Enabled	Off	Enable the Discord bot integration.
Bot Token	(empty)	Discord bot token from the Discord Developer Portal.
Server ID	(empty)	Target Discord server (guild) ID.
Channel ID	(empty)	Channel where the bot listens for commands.
Prefix	!	Command prefix (e.g., `!generate`, `!status`).

Bot Permissions

Setting	Default	Description
Allow Generation Commands	On	Enable `/generate` slash commands.
Allow Import Commands	On	Enable `/import` slash commands.
Allow Status Commands	On	Enable `/status` commands.
Admin Only	Off	Restrict all commands to Discord server admins.

MCP Server Settings

Team+ plans only. Enable the Model Context Protocol server for integration with AI coding tools like Claude Code.

Setting	Default	Description
MCP Server Enabled	Off	Enable the MCP server.
MCP Server Port	3000	Port for the MCP server.
Server Name	”StudioBrain MCP”	Display name for the MCP server.
Entity Tools	On	Expose entity CRUD tools through MCP.
Generation Tools	On	Expose AI generation tools through MCP.
RAG Tools	On	Expose vector search tools through MCP.
MCP API Key	(auto-generated)	Authentication token for MCP clients.

API Keys and Vault

StudioBrain stores API keys in an encrypted vault using Fernet symmetric encryption. Keys are stored per user and per provider.

Feature	Description
List Providers	View which providers have stored keys (keys are masked).
Store API Key	Save a key encrypted at rest.
Delete API Key	Remove a stored key.
Auto-Expire Keys	(Team+) Keys automatically expire after a configured number of days.
Key Rotation	(Team+) Force rotation of all stored keys.

Keyboard Shortcuts

View and customize keyboard shortcuts in Settings > Keyboard Shortcuts.

Default Shortcuts

Action	Windows / Linux	macOS
Save entity	`Ctrl+S`	`Cmd+S`
New entity	`Ctrl+N`	`Cmd+N`
Search	`Ctrl+K`	`Cmd+K`
Toggle sidebar	`Ctrl+B`	`Cmd+B`
Open AI Workshop	`Ctrl+Shift+A`	`Cmd+Shift+A`
Switch to Visual tab	`Ctrl+1`	`Cmd+1`
Switch to YAML tab	`Ctrl+2`	`Cmd+2`
Switch to Markdown tab	`Ctrl+3`	`Cmd+3`
Toggle theme	`Ctrl+Shift+T`	`Cmd+Shift+T`
Sync (cloud)	`Ctrl+Shift+S`	`Cmd+Shift+S`

Settings by Tier

Quick reference for which settings sections are available on each plan.

Settings Section	Free	Indie	Team	Enterprise
General	Yes	Yes	Yes	Yes
Display	Yes	Yes	Yes	Yes
Theme	Yes	Yes	Yes	Yes
AI Providers (BYO keys)	Yes	Yes	Yes	Yes
AI Generation Parameters	Yes	Yes	Yes	Yes
Templates	Yes	Yes	Yes	Yes
Rules	Yes	Yes	Yes	Yes
Entity Types	Yes	Yes	Yes	Yes
Keyboard Shortcuts	Yes	Yes	Yes	Yes
Production Status	Yes	Yes	Yes	Yes
Storage Providers (Cloud)	—	Yes	Yes	Yes
Google Drive	—	Yes	Yes	Yes
Billing & Usage	—	Yes	Yes	Yes
Backup (Automated)	—	Yes	Yes	Yes
Smart Import / Generation	—	Yes	Yes	Yes
Image Generation (Qwen)	—	Yes	Yes	Yes
Video Generation	—	—	Yes	Yes
Vision Deep Analysis	—	—	Yes	Yes
RAG / Vector Database	—	—	Yes	Yes
GPU Models	—	—	Yes	Yes
User Management	—	—	Yes	Yes
Team Admin Overrides	—	—	Yes	Yes
SSO / OAuth	—	—	Yes	Yes
Plugins (Marketplace)	—	—	Yes	Yes
Discord Bot	—	—	Yes	Yes
MCP Server	—	—	Yes	Yes
Service Control	Desktop	Desktop	Yes	Yes
Security (MFA)	—	—	Yes	Yes
Notifications	Yes	Yes	Yes	Yes
API Keys Vault	Yes	Yes	Yes	Yes
Custom OIDC	—	—	—	Yes

Settings Persistence

Per-user storage: Each user has their own settings, saved in the database (authenticated) or localStorage (desktop/unauthenticated).
Real-time sync: Settings changes propagate to all open browser tabs immediately.
Server-side validation: Tier restrictions are enforced server-side, not just hidden in the UI.
Export/Import: Settings can be backed up as JSON and restored.

Next Steps

Getting Started — Overview of the application
Managing Entities — Templates, rules, and entity editing
AI Workshop — Configure and use AI providers for content generation
Using Plugins — Plugin installation and configuration
Billing & Plans — Plan details and subscription management
Theme Customization — Developer reference for the surface token system

Sync & Collaboration Billing & Plans