Skip to main content

Configuration Guide

Customize Dinoki to work exactly how you want. This guide covers the essential settings and options.

Quick Settings Access​

  • Open Settings: Cmd+, or Dinoki menu → Preferences
  • Quick Toggle: Click menu bar icon
  • Instance Settings: Right-click on any character

AI Provider Setup​

Choosing Your AI Brain​

Dinoki can use different AI providers. Here's how to choose:

Best for: Complete privacy, offline use

  1. Install Ollama from ollama.ai
  2. In Terminal: ollama pull qwen3
  3. Select "Ollama" in Dinoki
  4. Choose your model (qwen3, qwen3:32b, etc.)

Recommended models:

  • qwen3 - Best overall performance (5B)
  • qwen3:32b - Most powerful (needs 32GB RAM)
  • mistral-small3.2 - Good alternative

OpenRouter​

Best for: Access to 300+ models without managing API keys

  1. Select "OpenRouter"
  2. Click "Connect with OpenRouter"
  3. Authorize in your browser
  4. Choose from available models

No API keys needed - uses secure OAuth!

OpenAI​

Best for: GPT-4 and GPT-3.5 users

  1. Get API key from platform.openai.com
  2. Select "OpenAI"
  3. Paste your API key
  4. Choose model (GPT-4, GPT-3.5-turbo)

Custom Provider​

Best for: Using other AI services

  1. Select "Custom Provider"
  2. Enter the API endpoint
  3. Add authentication details
  4. Test connection

Switching Providers​

You can change AI providers anytime:

  1. Open Settings → AI Provider
  2. Select new provider
  3. Configure if needed
  4. Your conversations continue seamlessly

Character Settings​

Choosing Your Companion​

Free users enjoy Dinoki:

  • Dinoki 🦕 - Your friendly dinosaur companion

Pro users can switch between:

  • Dinoki 🦕 - Friendly and helpful
  • TomatoBoy 🍅 - Energetic and playful
  • PigPig 🐷 - Sweet and cheerful
  • Fuegato 🐱 - Cool and confident

Character Behavior​

Activity Level

  • Low - Moves every 5-10 minutes
  • Medium - Moves every 2-5 minutes
  • High - Moves every 30 seconds to 2 minutes

Size Options

  • Auto - Adjusts to your screen
  • Small - Tiny desktop friend
  • Medium - Standard size
  • Large - Big and bold

Screen Position

  • Let character wander freely
  • Set preferred location (left, right, center)
  • Keep on specific monitor

Character Personality​

Customize how your character acts:

Example: Make Dinoki more playful
"You love to dance and tell jokes. You're always excited
about everything and use lots of emojis!"

Instance Management​

Creating Multiple Instances​

Run several characters at once:

  1. Click "+" in instance manager
  2. Name your instance (e.g., "Research Assistant")
  3. Choose character and settings
  4. Configure tools and personality

Instance Examples​

Work Assistant

  • Character: Dinoki
  • Tools: Email, Calendar, Reminders
  • Personality: Professional and efficient

Research Buddy

  • Character: TomatoBoy
  • Tools: Search, Web, Save File
  • Personality: Curious and thorough

Social Manager

  • Character: PigPig
  • Tools: Slack, Gmail
  • Personality: Friendly and social

Tool Configuration (Pro Only)​

Enabling Tools​

  1. Go to Settings → Tools
  2. Toggle tools on/off
  3. Configure permissions

Tool Provider Setup​

Slack​

  1. Click "Connect Slack"
  2. Choose your workspace
  3. Authorize Dinoki
  4. Select channels to access

Gmail​

  1. Click "Connect Gmail"
  2. Sign in with Google
  3. Grant permissions
  4. Choose what Dinoki can do

Tool Permissions​

Control what tools can do:

File Access

  • Set allowed folders
  • Enable/disable file creation
  • Limit file sizes

Web Access

  • Allow/block domains
  • Set search limits
  • Control deep search

System Settings​

Keyboard Shortcuts​

Customize shortcuts for:

  • Show/Hide Dinoki
  • Open chat
  • Switch modes
  • Create instances

Default shortcuts:

  • Cmd/Ctrl + Shift + D - Toggle Dinoki
  • Cmd/Ctrl + N - New chat
  • Cmd/Ctrl + 1/2/3 - Switch modes

Startup Options​

  • Launch at startup - Start with your computer
  • Start minimized - Hidden in menu bar
  • Restore windows - Remember positions

Performance​

Thanks to native architecture (WPF on Windows, SwiftUI on macOS), Dinoki is already optimized:

Native advantages:

  • Windows: WPF with hardware acceleration (69MB)
  • macOS: SwiftUI with Metal rendering (6MB)
  • Instant startup (no Electron framework)
  • Minimal RAM usage (~100MB)
  • Efficient CPU usage (less than 1% idle)

Performance tuning:

  • Reduce character animation FPS if needed
  • Limit conversation history length
  • Use smaller AI models for older hardware
  • Disable unused tools and features

Appearance​

Window Settings​

  • Transparency - Make windows see-through
  • Always on top - Keep above other windows
  • Theme - Choose color scheme

Chat Appearance​

  • Font size - Make text larger/smaller
  • Message style - Compact or spacious
  • Timestamps - Show/hide time stamps

Privacy & Data​

Data Storage​

Your data is stored locally:

  • Mac: ~/Library/Application Support/Dinoki
  • Windows: %APPDATA%\Dinoki

Privacy Options​

  • Clear chat history - Remove conversations
  • Reset character data - Fresh start
  • Delete tool data - Remove credentials

Telemetry​

Control what's shared:

  • Usage analytics (optional)
  • Crash reports (recommended)
  • Feature usage (helps us improve)

Backup & Sync​

Export Settings​

  1. Settings → Backup
  2. Click "Export Configuration"
  3. Save backup file

Includes:

  • AI provider settings
  • Character preferences
  • Tool configurations
  • Custom prompts

Import Settings​

  1. Settings → Backup
  2. Click "Import Configuration"
  3. Select backup file

Agent Mode Settings (Pro Only)​

Execution Intervals​

How often agent checks for work:

  • Fast - Every 30 seconds
  • Normal - Every 2 minutes
  • Slow - Every 5 minutes
  • Custom - Set your own

Task Settings​

  • Auto-approval - Let agent work freely
  • Require approval - Confirm actions
  • Daily limits - Cap tool usage

Troubleshooting Settings​

Reset Options​

If something's not working:

Soft Reset

  • Settings → Advanced → Reset Settings
  • Keeps your data, resets configuration

Hard Reset

  • Quit Dinoki
  • Delete data folder
  • Reinstall

Tool Reset

  • Disconnect problematic tools
  • Clear tool cache
  • Reconnect

Pro Tips​

Optimize for Your Workflow​

For Research

  • Use qwen3 for best Ollama performance
  • Enable web tools
  • Increase agent frequency

For Communication

  • Connect all messaging tools
  • Set up auto-replies
  • Use medium agent speed

For Fun

  • High character activity
  • Playful personality
  • Enable character tool

Performance Tips​

If Dinoki feels slow:

  1. Use Ollama with qwen3 (instead of qwen3:32b)
  2. Reduce character animations
  3. Clear old conversations
  4. Disable unused tools

If using too much CPU:

  1. Lower agent frequency
  2. Reduce character activity
  3. Use "Low Power Mode"

Need help? Check our Troubleshooting Guide →