Skip to main content

Troubleshooting & Support

Having issues with Dinoki? This guide will help you solve common problems and get support when needed.

Quick Fixes​

🚀 Try These First​

  1. Restart Dinoki - Fixes 90% of issues
  2. Check for updates - Settings → About → Check for Updates
  3. Restart your computer - Clears system issues
  4. Join Discord - discord.gg/dinoki for instant help

Common Issues​

Installation Problems​

Windows MSIX Installation Issues​

"App Installer is not available"

  • Update App Installer from Microsoft Store
  • Or download the .msixbundle directly
  • Alternative: Use portable version

"Package conflicts with an existing package"

# PowerShell (Admin)
Get-AppxPackage *Dinoki* | Remove-AppxPackage

Certificate Issues (rare)

  • Our MSIX is signed with DigiCert
  • If issues persist, use portable version

Installation Security Warnings​

"Dinoki can't be opened"

  1. Right-click Dinoki in Applications
  2. Select "Open" (not double-click)
  3. Click "Open" in the security dialog

Alternative solution:

  • System Preferences → Security & Privacy → "Open Anyway"

AI Provider Issues​

"Ollama not working"​

Check these:

  1. Is Ollama running? Type ollama serve in Terminal
  2. Do you have models? Type ollama list
  3. If empty, run ollama pull qwen3

Quick fix:

# In Terminal (Mac) or Command Prompt (Windows)
ollama serve
# Then in new terminal:
ollama pull qwen3

"Can't connect to OpenAI"​

Solutions:

  • Check your API key is correct
  • Verify you have credits in OpenAI account
  • Try regenerating your API key
  • Check internet connection

"Custom provider not connecting"​

Check:

  • URL format (needs http:// or https://)
  • API key/authentication is correct
  • Endpoint is OpenAI-compatible
  • Try the endpoint in browser first

Character Issues​

"Character not appearing"​

  1. Check Character Mode is enabled
  2. Try "Show Character" in menu bar
  3. Check which monitor you're using
  4. Free users: You'll see Dinoki
  5. Pro users: Try different characters

"Character stuck or frozen"​

  1. Right-click character → Reset Position
  2. Change character size in settings
  3. Disable and re-enable Character Mode
  4. Free users: Dinoki should reappear
  5. Pro users: Try switching characters

"Character not responding"​

  • Check if Dinoki is the active window
  • Try clicking directly on character
  • Verify character animations are enabled

Chat Problems​

"Chat not opening"​

  • Use keyboard shortcut Cmd/Ctrl+Shift+D
  • Right-click menu bar icon → Open Chat
  • Check chat window isn't behind other windows

"Messages not sending"​

  • Check AI provider is connected
  • Verify internet connection (for cloud providers)
  • Try switching AI providers temporarily

"Responses are slow"​

For cloud providers:

  • Check internet speed
  • Try different AI model
  • OpenAI may be experiencing high load

For Ollama:

  • Use smaller model (qwen3 instead of qwen3:32b)
  • Close other heavy applications
  • Check CPU usage in Activity Monitor/Task Manager

Tool Issues (Pro Only)​

"Slack not connecting"​

  1. Disconnect in Settings → Tools
  2. Clear browser cookies for Slack
  3. Reconnect and reauthorize
  4. Check you selected the right workspace

"Gmail not working"​

  1. Re-authenticate with Google
  2. Check Gmail API is enabled in Google account
  3. Try with different browser for auth
  4. Verify permissions were granted

"Tools not available"​

  • Verify Pro license is active
  • Check tool is enabled in settings
  • Some tools need provider setup first
  • Restart Dinoki after enabling tools

Agent Mode Issues (Pro Only)​

"Agent not running tasks"​

  • Check agent is actually enabled
  • Verify execution interval isn't too long
  • Review task goals - are they clear?
  • Check required tools are enabled

"Agent doing wrong things"​

  • Make goals more specific
  • Reduce number of enabled tools
  • Set clearer boundaries in prompts
  • Use approval mode first

Windows-Specific Issues​

System Tray Problems​

Icon not visible:

  1. Click the ^ arrow to show hidden icons
  2. Right-click taskbar → Taskbar settings
  3. Turn on "Always show all icons"
  4. Restart Dinoki if needed

Character Behind Windows​

Fix z-order:

  1. Right-click character → "Always on Top"
  2. Or Settings → Character → Enable "Always on Top"
  3. May need to toggle off and on

MSIX Auto-Update Issues​

Updates not working:

  1. Check internet connection
  2. Windows Settings → Update & Security → Advanced → Delivery Optimization
  3. Ensure "Allow downloads from other PCs" is on
  4. Manual update: Download latest .msixbundle

Performance Issues​

Note: Dinoki is built native (SwiftUI on Mac, WPF on Windows), not Electron, so it's already highly optimized. If you're experiencing issues, try these solutions:

High CPU Usage​

Solutions:

  1. Switch to qwen3 if using qwen3:32b
  2. Reduce character animation frequency
  3. Lower agent execution frequency
  4. Disable unused tools
  5. Clear conversation history

High Memory Usage​

Solutions:

  1. Use qwen3 (8B) instead of qwen3:32b
  2. Limit conversation history in settings
  3. Use only one character instance
  4. Close unused chat windows
  5. Restart Dinoki periodically

Slow Responses​

Try:

  • Optimal AI model (qwen3 for Ollama)
  • Clear conversation and start fresh
  • Check system resources
  • Disable background agent tasks

Platform-Specific Troubleshooting​

Windows Troubleshooting​

Check Digital Signature​

# Verify Dinoki is properly signed
Get-AuthenticodeSignature "C:\Program Files\WindowsApps\Dinoki*\Dinoki.exe"

MSIX Installation Logs​

# View installation logs
Get-AppxLog | Select-String "Dinoki"

Windows Event Viewer​

  1. Win+X → Event Viewer
  2. Windows Logs → Application
  3. Filter by "Dinoki"

macOS Troubleshooting​

Console Logs​

  1. Open Console app
  2. Filter by "Dinoki"
  3. Check for crash reports

Reset Launch Services​

/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user

Advanced Troubleshooting​

Reset Options​

Soft Reset (Keep Data)​

  1. Settings → Advanced → Reset Settings
  2. Restart Dinoki
  3. Reconfigure as needed

Hard Reset (Fresh Start)​

# Quit Dinoki first
rm -rf ~/Library/Application\ Support/Dinoki
rm ~/Library/Preferences/ai.dinoki.plist

Reset Specific Features​

  • Chat: Settings → Privacy → Clear History
  • Character: Settings → Character → Reset
  • Tools: Disconnect and reconnect
  • Agent: Clear goals and restart

Debug Information​

Getting Logs​

  1. Settings → Advanced → Enable Debug Mode
  2. Reproduce the issue
  3. Settings → Advanced → Export Logs
  4. Share with support

System Information​

When reporting issues, include:

  • Dinoki version (Help → About)
  • Operating system version
  • AI provider being used
  • Which tools are enabled

License Issues​

"License not recognized"​

  1. Check license key for typos
  2. Ensure no extra spaces
  3. Try copy-paste instead of typing
  4. Contact support with order number

"License already in use"​

  • Licenses work on all your personal devices
  • May need to wait 5 minutes between activations
  • Contact support if legitimate issue

Getting Help​

💬 Discord Community​

Fastest support: discord.gg/dinoki

  • Active community
  • Developer presence
  • Real-time help
  • Feature discussions

📧 Email Support​

For private issues: support@dinoki.ai

  • License problems
  • Account issues
  • Bug reports
  • Feature requests

🐛 Report Bugs​

GitHub Issues: github.com/dinoki-ai/public/issues

  • Detailed bug reports
  • Track issue progress
  • Contribute fixes

📚 Resources​

Video Tutorials

  • YouTube: Search "Dinoki tutorials"
  • Getting started videos
  • Feature demonstrations
  • Tips and tricks

Community Resources

  • Discord guides channel
  • User-created workflows
  • Character personality sharing
  • Tool configuration examples

Frequently Asked Questions​

General​

Is Dinoki really free? Yes! Chat Mode with Dinoki character, OpenRouter access, and Ollama support is completely free forever. Pro features are optional.

Why is Dinoki so small? Dinoki is built native with SwiftUI (Mac) and WPF (Windows), not Electron. This means no bundled browser engine or JavaScript runtime - just pure native performance!

Does the free version include a character? Yes! You get Dinoki (the dinosaur) in the free version. Pro lets you switch between 4 different characters.

Is my data private? Absolutely. With Ollama, everything runs locally. We don't collect or see your conversations.

Can I use Dinoki offline? Yes, with Ollama installed, Dinoki works 100% offline.

Pro Features​

Is Pro a subscription? No, it's a one-time purchase with lifetime updates.

Can I try Pro features? Yes, we offer trial licenses. Activate directly from the app.

How many devices can I use Pro on? All your personal devices - no limits for personal use.

Technical​

What are system requirements?

Minimum:

  • Windows 10 (1903+) or macOS 10.15+
  • 4GB RAM (8GB recommended)
  • 100MB free disk space

For Local AI (Ollama):

  • 8GB RAM for qwen3
  • 16GB+ RAM recommended
  • 32GB RAM for larger models

Download Size:

  • Windows: 69MB (native WPF)
  • macOS: 6MB (native SwiftUI)

Which AI models work best?

  • Best Overall: qwen3 (Ollama)
  • Most Powerful: qwen3:32b (needs 32GB RAM)
  • Cloud Power: GPT-4 (via OpenAI/OpenRouter)

Can I create custom tools? With MCP support, yes! Check our developer docs (Pro feature).

Best Practices​

Prevention Tips​

  1. Regular updates - Keep Dinoki current
  2. Backup settings - Export configuration monthly
  3. Monitor resources - Check CPU/memory usage
  4. Clean installs - Fresh install for major updates

Optimization Tips​

  1. Choose right model - qwen3 for best performance
  2. Limit tools - Only enable what you need
  3. Manage instances - Don't run too many characters
  4. Clear old data - Remove old conversations

Security Tips​

  1. Protect API keys - Never share them
  2. Use OAuth - Prefer OAuth over passwords
  3. Check permissions - Review tool access
  4. Update regularly - Security fixes included

Still Need Help?​

If you've tried everything:

  1. Join Discord - Fastest response
  2. Email support - For private issues
  3. Check GitHub - Known issues list
  4. Be patient - We're a small team but we care!

Remember: Most issues have simple solutions. Don't hesitate to ask for help!

Thank you for being part of the Dinoki family! 🦕