Zephyr

Secure by Design · Light by Nature · Beautiful by Choice

A Mihomo GUI.

English | 简体中文

Quick Start

5 minutes to get started:

1. Download — Get the latest release from GitHub Releases
2. Install — Run the installer (or extract Portable version)
3. Import — Add your subscription via URL or file
4. Select — Choose a proxy node from the list
5. Enable — Toggle System Proxy or TUN Mode

That's it. Your traffic is now routed through the selected proxy.

Transparency Notice: All content in this project is AI-generated (including this text). Security measures are implemented—see Security Design—but should not be assumed to be fully verified. Please assess risks before use. Security issue reports are welcome.

Screenshots

More Screenshots

Dark Mode	Settings

Why Zephyr?

Zephyr was born from frustration. Every Mihomo GUI I found looked like a temporary tool. So I vibe coded one.

Visual Experience. Frosted glass cards. Gradient icons. Dark mode. Animation details. Typography that breathes. A proxy client that feels designed, not assembled.

Security Boundaries. Explicit constraints on subscriptions, configs, scripts, files, updates, and deep links. Defense in depth.

Rule Capabilities. Prism Engine brings declarative rule patches, smart node selection, and script sandbox. More power, less complexity.

See FEATURES.md for the complete feature list.

Growing Community

Zephyr is gaining attention from developers and users.

<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=Juwan-Hwang/Zephyr&type=timeline&legend=top-left" width="450" />

Features

Core Capabilities

• Mihomo Core Management — Start, stop, restart the proxy core
• Multi-Config Management — Create, edit, switch YAML configurations
• Subscription Management — URL, file, drag-and-drop import, Base64 auto-decoding
• Proxy Mode Switching — Rule, Global, Direct modes
• System Proxy — Native system proxy management for Windows / macOS / Linux
• TUN Mode — System-level proxy
• Connections & Traffic — Real-time connection list, connection termination, up/down speeds, historical trends

Prism Engine

Zephyr includes a rule engine based on clash-prism-* crates to enhance Mihomo configuration:

Security Design

Zephyr implements defense-in-depth security measures:

System Integration

• System tray status icon and quick menu
• Global hotkeys: Window show, system proxy, TUN, proxy mode switching
• clash:// deep link subscription import
• Windows UWP loopback exemption
• Mihomo core, GeoIP/GeoSite data, and Zephyr client updates
• Auto-start on boot, system notifications, config directory access

Network Optimization

• Three-layer optimization: Mihomo config defaults (tcp-concurrent, keep-alive, fake-ip persistence) + OS TCP tuning (Fast Open, ECN, buffer) + DNS optimization
• Standalone UI: manual Apply / Revert / Status view
• Linux persistence to /etc/sysctl.d/

Lightweight Mode

• Destroys WebView on window close to free memory, keeps only system tray
• Settings entry: Settings → General → Lightweight Mode

UI / UX

• Transparent frameless window with custom title bar
• UI Scaling: 1x - 1.5x interface scaling for different resolutions
• Virtual scrolling logs with level filtering and regex search
• CodeMirror 6 editor with Prism DSL highlighting and completion
• Proxy node card 3D interaction effects
• Theme system: preset themes and custom colors
• i18n: English baseline, complete Chinese translation, Japanese/Korean partial (fallback to English)
• Frontend event bus, centralized state, and caching layer

Tech Stack

Installation

System Requirements

Hardware: ~300MB RAM, ~50MB disk space (Full version)

Download

Get the appropriate package from GitHub Releases.

Portable Version Usage

1. Download Zephyr-windows-portable.zip or Zephyr-linux-portable.tar.gz
2. Extract to any directory
3. Create an empty file named .portable in the directory (or it will be auto-created on first run)
4. Run the executable

Portable Limitations: No auto-start on boot or in-client updates. See PORTABLE.md for details.

Running from Source

Prerequisites

• Rust 1.92 or higher
• Node.js 18 or higher
• pnpm 10 or higher
• Platform-specific Tauri system dependencies

Development Mode

pnpm install
pnpm run dev

Build

pnpm run build

Verification Commands

pnpm run typecheck
pnpm run test
pnpm run lint
pnpm run check:i18n

Desktop package commands:

pnpm --filter @zephyr/desktop typecheck
pnpm --filter @zephyr/desktop test
pnpm --filter @zephyr/desktop lint
pnpm --filter @zephyr/desktop build:css

Rust-side verification:

cd apps/desktop/src-tauri
cargo check
cargo test
cargo clippy --all-targets --all-features

Project Structure

.
├── apps/
│   └── desktop/                 # Tauri desktop application
│       ├── src/                 # Native JS frontend, styles, UI modules
│       └── src-tauri/           # Rust backend, IPC, system integration, Prism capabilities
├── packages/
│   ├── shared/                  # Frontend shared code
│   └── scripts/                 # Project scripts, e.g., i18n check
├── FEATURES.md                  # Current feature list
├── package.json                 # Workspace root scripts
└── pnpm-workspace.yaml          # pnpm workspace configuration

FAQ

Is it safe to use?

Zephyr implements defense-in-depth security: SSRF protection, script sandboxing, update integrity verification, and more. The codebase is scanned by CodeQL and Semgrep in CI. See Security Design for details.

However, all content is AI-generated. Security, stability, and performance should not be assumed to be fully verified—please assess risks before use. If you discover security issues, please refer to SECURITY.md.

Will my PR be merged?

This project serves personal use cases first. PRs are not guaranteed to be merged. If you have different needs, forking and modifying directly is usually faster.

What's the difference between Full and Lite?

Full includes Mihomo core and GeoIP/GeoSite data—ready for first-time install or offline use. Lite is smaller but requires existing local core resources.

Community

• GitHub Issues — Bug reports & feature requests
• GitHub Releases — Changelog & download

Note: This project serves personal use cases first. PRs are not guaranteed to be merged. For specific needs, forking is often faster.

Contributing

Welcome contributions:

• Reproducible bug reports
• Security issue feedback
• Clear, well-scoped small fixes
• Quality improvements that don't change project direction

License

This project uses MIT License.

Acknowledgments

• Mihomo — the core
• Tauri — the framework
• Tailwind CSS — the style
• CodeMirror — the editor
• clash-prism-* — the rules

Conjured by Juwan

Back to Top

Features

Core Capabilities

• Mihomo Core Management — Start, stop, restart the proxy core
• **Multi-Con