Hyvmind Uploader

Upload Obsidian folders to Hyvmind ICP app as source graphs.

Features

• Internet Identity Authentication - Secure login using delegation tokens with configurable expiry (1, 7, or 30 days)
• Folder Upload - Right-click any folder to upload to Hyvmind as a source graph
• Recursive Scanning - Includes all subfolders and markdown files
• Smart Mapping - Converts folder structure to Hyvmind's graph format:
  • Root folder → Curation
  • Level 1 subfolders → Swarm (tagged "obsidian-import")
  • Level 2+ subfolders → Location
  • Markdown files → Law Entity + Interpretation Entity (with full content)
• Batch Upload - Automatically splits large payloads (>2MB) into manageable batches
• Progress Tracking - Real-time upload progress with status modal

Installation

From Obsidian Community Plugins (Coming Soon)

1. Open Settings → Community Plugins
2. Turn off Safe Mode
3. Click Browse and search for "Hyvmind Uploader"
4. Click Install
5. Enable the plugin

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder VaultFolder/.obsidian/plugins/hyvmind-uploader/
3. Copy the files to this folder
4. Enable the plugin in Obsidian settings

Configuration

Settings

Open Settings → Hyvmind Uploader to configure:

• Canister ID - The Hyvmind backend canister (default provided)
• Identity Provider URL - Internet Identity URL:
  • Mainnet: https://id.ai
  • Local: http://id.ai.localhost:8000
• ICP Host - Network endpoint:
  • Mainnet: https://icp-api.io
  • Local: http://localhost:8000
• Display Name - Your name for the Hyvmind user profile

Use the Environment Presets buttons to quickly switch between mainnet and local configurations.

Authentication

This plugin uses delegation token authentication because Obsidian's embedded browser cannot directly sign in with Internet Identity.

How to Authenticate

1. Open https://hyvmind.app/obsidian-token in your browser (Chrome, Firefox, Safari, Edge — not inside Obsidian)

2. Sign in with your passkey, Apple, Google, or Microsoft account

3. Click "Copy" to copy your delegation token

4. In Obsidian, go to Settings → Hyvmind Uploader:

   • Paste the token into the Delegation token field
   • Click Import token

5. The token status will show "Valid" when authenticated

Token Expiry

Tokens are valid for 30 days. When yours expires, repeat the steps above to get a new one.

Deleting Your Token

Click Delete token in the settings to remove your authentication. You will need to re-authenticate to use the plugin again.

Usage

Upload a Folder

Method 1 - Right-click:

1. Right-click any folder in the file explorer
2. Select "Upload to Hyvmind"

Method 2 - Command:

1. Open any markdown file
2. Use command palette: "Hyvmind Uploader: Upload current folder"

Disconnect

Use command palette: "Hyvmind Uploader: Disconnect from ICP"

Status Bar

The status bar at the bottom shows:

• 🟢 Green - Connected (shows truncated principal)
• ⚪ Gray - Not connected

Requirements

• Obsidian v0.15.0 or higher
• Internet Identity for authentication (from https://id.ai)
• Connection to Internet Computer (mainnet or local)

Development

Local Development

1. Clone the repository:

   git clone https://github.com/anshuman-ecc-eth/hm-obsidian.git
   cd hm-obsidian
   

2. Install dependencies:

   npm install
   

3. Build the plugin:

   npm run build
   

4. For development with auto-rebuild:

   npm run dev
   

5. Copy main.js, manifest.json, and styles.css to your vault's plugin folder

Local Testing with ICP

1. Start local ICP network:

   icp network start -d
   

2. Deploy Hyvmind canister locally

3. Configure plugin to use local URLs:

   • Identity Provider: http://id.ai.localhost:8000
   • ICP Host: http://localhost:8000

Architecture

src/
├── main.ts              # Plugin entry point
├── settings.ts          # Settings UI
├── icp/
│   ├── auth.ts         # Internet Identity auth (token-based)
│   ├── agent.ts        # ICP agent/actor
│   └── uploader.ts     # Folder-to-graph conversion
├── ui/
│   ├── status-bar.ts   # Connection indicator
│   └── token-modal.ts  # Token import instructions
└── types/
    └── canister.ts     # Candid types

Tech Stack

• Obsidian API - Plugin framework
• TypeScript - Type-safe development
• @icp-sdk/auth - Internet Identity authentication
• @icp-sdk/core - ICP agent and actor
• esbuild - Build tooling

License

MIT License - See LICENSE for details

Support

• Website: hyvmind.app
• Repository: github.com/anshuman-ecc-eth/hm-obsidian

Acknowledgments

Built for Hyvmind - Sanctuary tech for legal researchers