Isomer is a desktop application that simplifies managing a local Bitcoin Regtest environment with full Alkanes metaprotocol support. Built with Tauri, React, and Rust.
| Feature | Description |
|---|---|
| 🚀 One-Click Launch | Start your entire Alkanes development stack with a single click |
| ⚡ JSON RPC Server | Prominent RPC endpoint display with copy-to-clipboard (Ganache-style) |
| 🔧 Service Management | Easily control Bitcoin Core, Metashrew, Esplora, Ord, and JSON RPC |
| 🔍 Espo Explorer | Built-in block explorer with Alkanes trace visualization |
| 💰 Faucet & Mining | Fund addresses and mine blocks directly from the UI |
| 📦 Binary Management | Automatically downloads and verifies required binaries for your platform |
| 📋 Integrated Logs | Real-time log streaming for all managed services |
Isomer orchestrates the following services with proper dependency ordering:
┌─────────────────────────────────────────────────────────────┐
│ Isomer Dashboard │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Bitcoin │ │ Metashrew │ │ JSON RPC │ │
│ │ Core │──│ (Indexer) │──│ (API Gateway) │ │
│ │ (Regtest) │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Esplora │ │ Ord │ │ Espo Explorer │ │
│ │ (Electrum) │ │ (Ordinals) │ │ (Block Explorer) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
curl -sSf https://raw.githubusercontent.com/jonatns/isomer/main/install.sh | bashDownload the latest .msi installer from Releases.
- Rust — Latest stable toolchain: rustup.rs
- Node.js — LTS version recommended
- pnpm — Package manager:
npm i -g pnpm
# Clone the repository
git clone https://github.com/jonatns/isomer.git
cd isomer
# Install dependencies
pnpm install
# Build the application
pnpm tauri buildThe built application will be available in src-tauri/target/release/bundle/.
For contributors who want to work on Isomer:
pnpm tauri devSee RELEASING.md for details on the two-stage release process (binaries and app).
isomer/
├── src/ # React frontend
│ ├── components/ # UI components
│ └── index.css # Global styles
├── src-tauri/ # Rust backend (Tauri)
│ ├── src/
│ │ ├── binary_manager.rs # Binary download & verification
│ │ ├── process_manager.rs # Service lifecycle management
│ │ └── commands.rs # Tauri command handlers
│ └── icons/ # Application icons
└── assets/ # Documentation assets
| Service | Port |
|---|---|
| Bitcoin RPC | 18443 |
| Metashrew RPC | 8080 |
| JSON RPC | 18888 |
| Esplora Electrum | 50001 |
| Esplora HTTP | 3002 |
| Espo Explorer | 8081 |
| Ord | 3001 |
If you find this project useful, you can support the developer by donating to:
bc1q3w72ctyxh5thnxmasaexh0yymga9pf8n9aaz2l
Built with ⚗️ for the Alkanes ecosystem