223 lines
6.5 KiB
Plaintext
223 lines
6.5 KiB
Plaintext
---
|
|
title: Settings
|
|
description: Configure Jan to work best for your needs and hardware.
|
|
keywords:
|
|
[
|
|
Jan,
|
|
settings,
|
|
configuration,
|
|
model management,
|
|
privacy,
|
|
hardware settings,
|
|
local AI,
|
|
customization,
|
|
]
|
|
---
|
|
|
|
import { Tabs, Steps, Callout } from 'nextra/components'
|
|
import { Settings, EllipsisVertical, Plus, FolderOpen, Pencil } from 'lucide-react'
|
|
|
|
# Settings
|
|
|
|
Access Jan's settings by clicking the <Settings width={16} height={16} style={{display:"inline"}}/> icon in the bottom left corner.
|
|
|
|
## Managing AI Models
|
|
|
|
Find all model options at **Settings** > **Model Providers**:
|
|
|
|
### Adding Models
|
|
|
|
**From Hugging Face:**
|
|
- Enter a model's ID (like `microsoft/DialoGPT-medium`) in the search bar
|
|
- **Need authentication?** Some models require a Hugging Face token - add yours at **Settings > Model Providers > Hugging Face Access Token**
|
|
|
|
**From Your Computer:**
|
|
- Click **Import Model** and select GGUF files from your computer
|
|
- Works with any compatible model files you've downloaded
|
|
|
|
### Managing Existing Models
|
|
|
|
**Start a model:**
|
|
1. Open a new chat and select the model you want
|
|
2. Or go to **Settings > Model Providers** and click the **Start** button
|
|
|
|
**Remove a model:**
|
|
- Click the trash icon next to the **Start** button
|
|
- Confirm deletion when prompted
|
|
|
|
### Hugging Face Token Setup
|
|
|
|
For restricted models (like Meta's Llama models):
|
|
1. Get your token from [Hugging Face Tokens](https://huggingface.co/docs/hub/en/security-tokens)
|
|
2. Add it at **Settings > Model Providers > Hugging Face**
|
|
|
|
## Model Configuration (Gear Icon)
|
|
|
|
|
|
|
|
Click the gear icon next to any model to adjust how it behaves:
|
|
|
|
**Basic Settings:**
|
|
- **Context Size**: How much conversation history the model remembers
|
|
- **GPU Layers**: How much of the model runs on your graphics card (higher = faster, but uses more GPU memory)
|
|
- **Temperature**: Controls creativity (0.1 = focused, 1.0 = creative)
|
|
|
|
**Advanced Controls:**
|
|
- **Top K & Top P**: Fine-tune how the model picks words (lower = more focused)
|
|
- **Min P**: Minimum probability threshold for word selection
|
|
- **Repeat Penalty**: Prevents the model from repeating itself too much
|
|
- **Presence Penalty**: Encourages the model to use varied vocabulary
|
|
|
|
<Callout type="info">
|
|
For detailed explanations of these parameters, see our [Model Parameters Guide](/docs/desktop/desktop/model-parameters).
|
|
</Callout>
|
|
|
|
## Hardware Monitoring
|
|
|
|
Check your computer's performance at **Settings** > **Hardware**:
|
|
|
|
- **CPU, RAM, GPU**: Real-time usage and specifications
|
|
- **GPU Acceleration**: Turn GPU acceleration on/off
|
|
- **Temperature monitoring**: Keep an eye on system heat
|
|
|
|
|
|
|
|
<Callout type="warning">
|
|
If your computer gets very hot, consider using smaller models or reducing GPU layers.
|
|
</Callout>
|
|
|
|
## Personalization
|
|
|
|
### Visual Appearance
|
|
|
|
Customize Jan's look at **Settings** > **Appearance**:
|
|
- **Theme**: Choose light or dark mode
|
|
- **Colors**: Pick your preferred color scheme
|
|
- **Code highlighting**: Adjust syntax colors for programming discussions
|
|
|
|
|
|
|
|
### Writing Assistance
|
|
|
|
**Spell Check:** Jan can help catch typing mistakes in your messages.
|
|
|
|
|
|
|
|
## Privacy & Data Control
|
|
|
|
Access privacy settings at **Settings** > **Privacy**:
|
|
|
|
### Usage Analytics
|
|
|
|
**Default: No data collection.** Everything stays on your computer.
|
|
|
|
**Optional: Help improve Jan**
|
|
- Toggle **Analytics** to share anonymous usage patterns
|
|
- No conversations or personal data ever shared
|
|
- Change this setting anytime
|
|
|
|
<Callout type="info">
|
|
See exactly what we collect (with your permission) in our [Privacy Policy](/docs/desktop/desktop/privacy).
|
|
</Callout>
|
|
|
|
|
|
|
|
### Log Management
|
|
|
|
**Viewing System Logs:**
|
|
- Logs help troubleshoot problems
|
|
- Click the folder icon to open App Logs and System Logs
|
|
- Logs are automatically deleted after 24 hours
|
|
|
|
|
|
|
|
**Clearing Logs:**
|
|
- Click **Clear** to remove all log files immediately
|
|
- Useful before sharing your computer or troubleshooting
|
|
|
|
<Callout type="warning">
|
|
Clearing logs cannot be undone.
|
|
</Callout>
|
|
|
|
|
|
|
|
### Data Folder Management
|
|
|
|
Jan stores everything locally on your computer in standard file formats.
|
|
|
|
**Access Your Data:**
|
|
- Click the folder icon to open Jan's data directory
|
|
- Find your chat history, models, and settings
|
|
- All files are yours to backup, move, or examine
|
|
|
|
|
|
|
|
**Change Storage Location:**
|
|
1. Click the pencil icon to edit the data folder location
|
|
2. Choose an empty directory
|
|
3. Confirm the move (original folder stays intact)
|
|
4. Restart Jan to complete the change
|
|
|
|
|
|
|
|
<Callout type="info">
|
|
This duplicates your data to the new location - your original files stay safe.
|
|
</Callout>
|
|
|
|
## Local API Server
|
|
|
|
All settings for running Jan as a local, OpenAI-compatible server have been moved to their own dedicated page for clarity.
|
|
|
|
This includes configuration for:
|
|
- Server Host and Port
|
|
- API Keys
|
|
- CORS (Cross-Origin Resource Sharing)
|
|
- Verbose Logging
|
|
|
|
[**Go to Local API Server Settings →**](/docs/desktop/desktop/api-server)
|
|
|
|
## Emergency Options
|
|
|
|
### Factory Reset
|
|
|
|
**When to use:** Only as a last resort for serious problems that other solutions can't fix.
|
|
|
|
**What it does:** Returns Jan to its original state - deletes everything.
|
|
|
|
**Steps:**
|
|
1. Click **Reset** under "Reset to Factory Settings"
|
|
2. Type **RESET** to confirm you understand this deletes everything
|
|
3. Optionally keep your current data folder location
|
|
4. Click **Reset Now**
|
|
5. Restart Jan
|
|
|
|
|
|
|
|
|
|
|
|
<Callout type="error">
|
|
**This cannot be undone.** All chat history, downloaded models, and settings will be permanently deleted.
|
|
</Callout>
|
|
|
|
**Try these first:**
|
|
- Restart Jan
|
|
- Check the [Troubleshooting Guide](./troubleshooting)
|
|
- Ask for help on [Discord](https://discord.gg/qSwXFx6Krr)
|
|
|
|
## Quick Tips
|
|
|
|
**For new users:**
|
|
- Start with default settings
|
|
- Try a few different models to find what works best
|
|
- Enable GPU acceleration if you have a graphics card
|
|
|
|
**For performance:**
|
|
- Monitor hardware usage in real-time
|
|
- Adjust GPU layers based on your graphics card memory
|
|
- Use smaller models on older hardware
|
|
|
|
**For privacy:**
|
|
- All data stays local by default
|
|
- Check the data folder to see exactly what's stored
|
|
- Analytics are opt-in only
|