---
tags:
- ml-intern
---
# MUSE Alpha — Creative Browser

Tauri v2 + Rust + SolidJS · Phase 0–4 implementation.

> *The browser that understands that getting the work done matters more than any single feature.*

## Download

**Latest project:** [`artifacts/musealpha-production.zip`](artifacts/musealpha-production.zip)

## Run

```bash
deno install
deno task tauri dev
```

## Architecture

- **Shell:** SolidJS in main WebView (titlebar, sidebar, URL bar, library, board, study mode)
- **Browser tabs:** Tauri child WebViews via `window.add_child()` (unstable feature)
- **Ad-block:** `adblock-rust 0.12` + JS injection scripts (Layer 0-3)
- **Privacy:** WebRTC protection, canvas fingerprint noise, cookie consent auto-deny
- **Data:** SQLite (via tauri-plugin-sql) + JSON persistence + Stronghold vault
- **Design:** 8 production-polished theme presets, tokenized design system

## Implemented Phases

### Phase 0 — Foundation ✓
Custom titlebar, 8-theme system, onboarding, settings persistence, SQLite migrations.

### Phase 1 — Browser ✓
Multi-tab via child WebViews, vertical tab sidebar, URL navigation, back/forward/reload/zoom.

### Phase 2 — Ad-Block & Privacy ✓
adblock-rust engine, bundled filter lists, daily updater, JS injection scripts, cosmetic filtering, navigation blocking, per-domain shield controls, HTTPS-first, Stronghold vault.

### Phase 3 — Library & Board ✓
Library (add by URL, Blake3 hash, dimensions, palette extraction, grid, detail, search), Board (infinite canvas, pan/zoom, image/note/palette cards, drag from library), hover overlay, downloads, sessions.

### Phase 4 — Artist Features ✓
Quick Study Mode (timer, opacity, flip, notes), Command Palette (Ctrl+K), Session Manager, Color Export (HEX/CSS/GPL/ASE/Procreate), color search by hue.

## Design System

- **Tokens:** `src/styles/tokens.css` — spacing, radius, motion, z-index, per-theme colors
- **Primitives:** `src/styles/primitives.css` — buttons, inputs, cards, badges, dividers
- **Themes:** Dusk, Parchment, Midnight, Studio, Moss, Rose, Obsidian, Linen
- **State:** `src/store/appStore.ts` — centralized SolidJS store

## Keyboard Shortcuts

| Shortcut | Action |
|---|---|
| `Ctrl+K` | Command Palette |
| `Ctrl+Shift+Y` | Quick Study Mode |
| `Escape` | Close palette/study |

## Docs

- [`docs/MUSE_SRS_v3.md`](docs/MUSE_SRS_v3.md) — Product requirements
- [`docs/MUSE_SRS_v4.md`](docs/MUSE_SRS_v4.md) — Implementation guide

## Known Limitations

- Library/Board use JSON persistence, not full SQLite FTS5 yet
- Password manager UI not implemented (vault backend ready)
- Board annotations/overlays/export not implemented
- Remote hover overlay IPC requires broad capabilities
- No test suite

---

Generated by [ML Intern](https://github.com/huggingface/ml-intern).

<!-- ml-intern-provenance -->
## Generated by ML Intern

This model repository was generated by [ML Intern](https://github.com/huggingface/ml-intern), an agent for machine learning research and development on the Hugging Face Hub.

- Try ML Intern: https://smolagents-ml-intern.hf.space
- Source code: https://github.com/huggingface/ml-intern

## Usage

```python
from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = 'asdf98/musealpha'
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id)
```

For non-causal architectures, replace `AutoModelForCausalLM` with the appropriate `AutoModel` class.