Mascot
Mascot is the desktop client for OpenHuman, providing you with a locally running AI Agent experience.
Core Features
Local-First
- All data stored locally
- Rust Core runs on your machine
- No worries about cloud data security
Intuitive Interface
- Chat View - Converse with the agent
- Memory Tree View - Visualize your knowledge base
- Skills View - Manage integrations and tools
- Settings View - Configure everything
Multi-function Bar
| Feature | Description |
|---|---|
| Search | Quickly search memories and files |
| Shortcuts | One-click access to common features |
| Notifications | Receive real-time alerts |
Installation
macOS
brew install --cask openhuman
Windows
winget install OpenHuman
Linux
sudo snap install openhuman
Interface Navigation
Chat View
The main interface for agent conversation. You can:
- Input messages to interact with the agent
- Upload files or images
- View agent responses
Memory Tree View
Visualize your knowledge base:
📁 Root
├── 👤 Persona
│ └── User Information
├── 📂 Projects
│ ├── Project A
│ └── Project B
└── 🌐 World
└── Various Topics
Skills View
Manage your integrations and tools:
- Integrations - Connect third-party services
- Tools - Enable/disable tools
- Local AI - Configure local models
Remote Core
If you have a remotely running Rust Core, you can connect to it:
[core]
mode = "remote"
rpc_url = "https://your-core.example/rpc"
token = "your-token"
Keyboard Shortcuts
| Shortcut | Function |
|---|---|
Cmd/Ctrl + Shift + O | Open OpenHuman |
Cmd/Ctrl + 1 | Switch to Chat |
Cmd/Ctrl + 2 | Switch to Memory Tree |
Cmd/Ctrl + K | Quick Commands |
Data Storage
| Data | Location |
|---|---|
| Memory Database | memory_tree/chunks.db |
| Obsidian Notes | wiki/ |
| Config File | ~/.openhuman/config.toml |
| Logs | ~/.openhuman/logs/ |
Next Steps
- Installation - Complete installation guide
- Keyboard Shortcuts - All keyboard shortcuts
- Privacy & Security - Data security details