Ai Models And Configuration

This guide covers AI model setup, provider configuration, and system prompts in SystemSculpt.

Quick Setup

Using SystemSculpt License

The easiest way to get started - no API keys needed!

1. Purchase a SystemSculpt license
2. Enter your license key in Setup & Connect settings
3. Start using AI models immediately

Benefits:

• Access to various AI models through SystemSculpt's provider
• No API key management
• Credit-based system
• Models available depend on SystemSculpt's current offerings

Using Your Own API Keys

For direct provider access:

1. Get API keys from your chosen provider
2. Enter keys in Setup & Connect settings
3. Select models from the dropdown in your chats

Available Providers

SystemSculpt supports adding your own API keys for:

• OpenAI - Get key from platform.openai.com
• Anthropic - Get key from console.anthropic.com
• OpenRouter - Get key from openrouter.ai
• Ollama (Local) - Install from ollama.ai
• Custom Endpoints - Any OpenAI-compatible API

Available models depend on:

• Your provider subscriptions
• Current provider offerings
• SystemSculpt license (if using SystemSculpt provider)

Model Settings in SystemSculpt

What You Can Configure

Model Selection

• Default Chat Model - Set in Model Settings tab
• Title Generation Model - For auto-generating chat titles
• Post-Processing Model - For audio transcription processing

System Prompts

• Default System Prompt Type: Choose from General Use, Concise, or Custom
• Custom System Prompts: Create your own in the System Prompts directory

What's Fixed

• Temperature: Set to 0.7 (not user-configurable)
• Max Tokens: Uses model defaults (not user-configurable)
• Streaming: Always enabled when supported by the model

System Prompts

Default Options

SystemSculpt provides three default system prompt types:

1. General Use - Balanced, helpful assistant
2. Concise - Brief, direct responses
3. Custom - Use your own system prompt file

Creating Custom System Prompts

1. Navigate to your System Prompts directory (default: "SystemSculpt/System Prompts")
2. Create a new .md file
3. Write your system prompt
4. Select "Custom" in System Prompt Settings
5. Choose your file from the dropdown

Example system prompt file:

Markdown
Copy to clipboard
You are a helpful assistant integrated into Obsidian.
Focus on clear, concise responses with practical examples.
Use markdown formatting for better readability.

Templates

Creating Templates

Templates are stored in your vault and can be loaded via the /template command.

1. Create a note in your vault
2. Add template content
3. Use /template in chat to load it

Templates can include:

• Initial prompts
• Context setup
• Specific instructions

Using Templates

1. Type /template in chat
2. Search for your template
3. Select to load it into the current chat

Managing Models

Favorite Models

In AI Chat settings, you can:

• Add frequently used models to favorites
• Remove models from favorites
• Quickly access favorites in the model dropdown

Context Window Management

Context Window Percentage (in Advanced settings)

• Adjust how much of the model's context window to use
• Default: 80%
• Range: 0-100%

This helps prevent context length errors by leaving buffer space.

Directory Settings

Configure where SystemSculpt stores files:

• Chats Directory - Where chat logs are saved
• System Prompts Directory - Where custom prompts are stored
• Attachments Directory - For file attachments
• Extractions Directory - For extracted content

Advanced Settings

MCP (Model Context Protocol)

• Enable/disable MCP tools in Advanced settings
• Required for Agent Mode features
• Individual tools can be enabled/disabled

Context Management

• Max Vault Directory Entries - Limits directories included in prompts
• Context Window Percentage - Controls context usage

Troubleshooting

"Invalid API Key" Error

• Verify key in Setup & Connect settings
• Check for extra spaces or characters
• Ensure key has proper permissions

"Model Not Available"

• Check your provider subscription
• Verify the model still exists
• Try refreshing SystemSculpt

Context Length Errors

• Use /clear to reset conversation
• Reduce Context Window Percentage in Advanced settings
• Remove large file attachments

Security Notes

• API keys are stored encrypted locally
• Never share your API keys
• Keys are only sent to their respective providers
• SystemSculpt license keys are separate from API keys

Next Steps

• Unlock Agent Mode with Pro license
• Explore Smart Features
• Learn Commands and Workflows