Official Obsidian Plugin for BrainHub SaaS Platform
Enterprise AI-Powered Knowledge Assistant for Obsidian with Cloud Integration.
- π€ AI Chat Interface - Chat with BrainHub AI directly in Obsidian
- π Semantic Search - Search across your vault with AI-powered understanding
- π Vault Statistics - Real-time vault analytics and usage tracking
- π‘ Knowledge Graph - Visualize connections between your notes
- π Auto-Linking - Intelligent note linking suggestions
- βοΈ Cloud Sync - Sync with BrainHub cloud platform
- π API Key Authentication - Secure connection to BrainHub services
- Download the latest release from Releases
- Extract the files to your Obsidian vault:
.obsidian/plugins/brainhub/ - Enable the plugin in Obsidian Settings β Community Plugins
- Go to Settings β Community Plugins β Browse
- Search for "BrainHub"
- Click Install
- Sign up at brainhub.website
- Get your API Key from the Dashboard
- In plugin settings:
- API URL:
https://brainhub.website/api - API Key: Your API key from dashboard
- Mode: Cloud
- API URL:
- Run BrainHub server locally:
docker-compose up -d
- In plugin settings:
- API URL:
http://localhost:3000 - Mode: Self-Hosted
- API URL:
- Open Command Palette (
Ctrl/Cmd + P) - Run: "BrainHub: Index Vault"
- Wait for indexing to complete
- Open Command Palette
- Run: "BrainHub: Search Notes"
- Type your query
- Browse results with scores
- Open BrainHub Sidebar (click π§ icon)
- Type your question
- Get AI responses with context from your vault
- Open Command Palette
- Run: "BrainHub: View Statistics"
- See vault metrics and usage
- Node.js >= 20
- pnpm >= 9
# Install dependencies
pnpm install
# Development mode (watch)
pnpm dev
# Production build
pnpm buildbrainhub-obsidian-plugin/
βββ src/
β βββ main.ts # Plugin entry point
β βββ api-client.ts # Cloud API client
β βββ config/ # Configuration
β βββ services/ # Core services
β βββ views/ # UI components
β βββ utils/ # Utilities
βββ manifest.json # Plugin metadata
βββ styles.css # Plugin styles
βββ esbuild.config.mjs # Build configuration
βββ package.json # Dependencies
The plugin connects to BrainHub Cloud API:
POST /api/v1/index- Index a notePOST /api/v1/batch-index- Index multiple notesPOST /api/v1/search- Semantic searchPOST /api/v1/chat- AI chat with RAGGET /api/v1/stats- Vault statisticsDELETE /api/v1/index- Delete indexed noteGET /api/v1/collections- List collections
- API keys are stored locally in Obsidian settings
- All communications use HTTPS
- API keys have scopes (read, write, chat)
- Rate limiting enforced server-side
| Feature | Free | Pro | Enterprise |
|---|---|---|---|
| Notes | 100 | Unlimited | Unlimited |
| Search | Basic | Advanced | Advanced |
| Chat | 5/day | Unlimited | Unlimited |
| API Access | β | β | β |
- Check your API URL is correct
- Verify your API key is valid
- Check internet connection (for cloud mode)
- Ensure server is running (for self-hosted)
- Go to brainhub.website
- Generate a new API key
- Update plugin settings
- Check vault path in settings
- Ensure you have write permissions
- Check server logs for errors
We welcome contributions! Please see our Contributing Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.
For security concerns, please see our Security Policy.
- Documentation: docs.brainhub.website
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: support@brainhub.website
Support this project by becoming a sponsor! β€οΈ
Built with β€οΈ by the BrainHub Team
Special thanks to:
- Obsidian for the amazing note-taking platform
- Qdrant for the vector database
- All our contributors and users
Made with β€οΈ by the BrainHub Team
MIT License - see LICENSE file
Contributions welcome! Please read CONTRIBUTING.md
- Documentation: docs.brainhub.website
- Issues: GitHub Issues
Built with β€οΈ by the BrainHub Team
Version: 3.2.0
Last Updated: 2026-01-14