MCPcopy
hub / github.com/xpf0000/FlyEnv

github.com/xpf0000/FlyEnv @v4.16.0 sqlite

repository ↗ · DeepWiki ↗ · release v4.16.0 ↗
4,881 symbols 17,234 edges 770 files 317 documented · 6%
README

FlyEnv

FlyEnv Logo

Install, Switch, and Run Local Dev Stacks Natively

<strong>FlyEnv is a desktop app for managing local development environments on Windows, macOS, and Linux.</strong>


Install and run PHP, Node.js, Python, Java, .NET, Flutter, web servers, databases, queues, AI tools, SSL, local domains, reverse proxies, and cron jobs from one UI.


Use native binaries, switch versions per project, and keep your system PATH clean—<strong>no Docker required</strong>.

Best for web, backend, mobile, and full-stack developers who want local services without container overhead.

<a href="https://github.com/xpf0000/FlyEnv/releases"><img src="https://img.shields.io/github/release/xpf0000/FlyEnv.svg" alt="GitHub release"></a>
<a href="https://github.com/xpf0000/FlyEnv/releases"><img src="https://img.shields.io/github/downloads/xpf0000/FlyEnv/total.svg" alt="Total Downloads"></a>
<a href="https://ko-fi.com/R5R2OJXTM"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi"></a>

What Can You Do With FlyEnv?

  • Install runtimes on demand: PHP, Node.js, Python, Java, .NET, Flutter, Go, Rust, Ruby, Bun, Deno, and more.
  • Run local services: Nginx, Apache, Caddy, MySQL, PostgreSQL, MongoDB, Redis, RabbitMQ, Elasticsearch, Minio/RustFS, and other common development dependencies.
  • Manage projects: Switch runtime versions per project, define start/stop commands, expose projects through local domains, reverse proxies, HTTPS, and Cloudflare Tunnel.
  • Handle daily dev tasks: Edit configs and logs, inspect ports, schedule cron jobs, manage Git, generate certificates, compare diffs, test WebSocket/SSE, and work with JWTs.

Your environment adapts to your project, not the other way around—versions switch automatically as you move between projects:

cd ~/projects/legacy-wordpress
php -v   # PHP 7.4 (auto-loaded)
cd ~/projects/modern-laravel
php -v   # PHP 8.3 (auto-switched)

Is FlyEnv For You?

Choose FlyEnv if you... It may not be the best fit if you...
Want XAMPP/MAMP/Herd-style convenience across many stacks Need exact Docker Compose or Kubernetes parity with production
Work with multiple runtime versions across projects Only use one runtime and are happy with your system package manager
Want databases, queues, search, storage, and AI tools without maintaining containers Prefer to manage every service manually from the terminal
Build local web, backend, mobile, or full-stack projects on Windows, macOS, or Linux Need a hosted platform or production deployment system

🚀 How FlyEnv Fits

Most local dev tools are either too heavy for everyday work (Docker Desktop) or too low-level for full-stack projects (NVM/Homebrew/package managers). FlyEnv sits in the middle: a native desktop manager for the tools and services you actually run while building software.

Capability FlyEnv Docker Desktop XAMPP/MAMP
How services run Native processes managed from a desktop UI Containers managed through images and compose files Native bundled web stack
Scope Runtimes, databases, web servers, project services, and developer tools Any containerized service or application Primarily PHP/web-server/database stacks
Project versions Built-in project runtime workflows Defined in container configuration Usually global or manual
Best suited for Native local development across many stacks Reproducible container-based environments Traditional local PHP development

Core Benefits

  • On-Demand Modules: Install only the runtimes and local services your projects need.
  • Native Processes: Run installed services directly on your operating system rather than inside Docker containers.
  • Project Workflows: Switch Node/PHP environments by project and define project service commands, ports, domains, and HTTPS.
  • Full-Stack Coverage: Enable databases, queues, search engines, object storage, AI tools, and scheduled tasks from one app.
  • Multilingual UI: Use FlyEnv in 30+ languages.

The real power is that everything works together. A version switcher, a web server manager, a tunnel tool—you can find each of these elsewhere. What you can't find elsewhere is all of them in one window, sharing the same projects, sites, and workflow: Install → Configure → Run → Reverse proxy → Tunnel → Debug → Ship. The time you save isn't any one feature being fast. It's never having to leave.


🎯 Tailored for Your Workflow

🐘 For PHP & Laravel Developers

The best Windows alternative to Laravel Herd.

  • Switch between PHP 5.6, 7.4, 8.x instantly.
  • Run Nginx/Apache, MySQL, Redis, and Mailpit out of the box.
  • Native composer performance (no file-sharing lag).
  • Download for Windows

🟢 For Node.js & Frontend Developers

Stop fighting with NVM.

  • Define Node versions per project (automatically detects package.json).
  • Instant access to Elasticsearch, PostgreSQL, or RabbitMQ without docker-compose.
  • Supports Bun, Deno, and PM2 management.

☕ For Java, Python, .NET, Flutter & Go Developers

  • Manage multiple JDKs (Maven/Gradle/SDKMAN), .NET SDKs, Flutter SDKs, and Python environments effortlessly.
  • Run Flutter diagnostics, Android device checks, and project build commands from one place.
  • Keep your global system PATH clean and organized.

📦 Supported Modules (On-Demand)

FlyEnv allows you to install only what you need from a vast library of supported software:

  • AI Integration: Hermes Agent, OpenClaw, n8n, Ollama, CliProxyAPI
  • Containers: Podman.
  • Network Tunnel: Cloudflared, Cloudflare Tunnel.
  • Web Servers: FrankenPHP, Apache, Nginx, Caddy, Tomcat.
  • Databases: MySQL, MariaDB, PostgreSQL, MongoDB, Qdrant.
  • Email Server: Mailpit.
  • Programming Languages & Runtime: .NET, Flutter, PHP (Composer, PHP-CLI, PHP-FPM, RoadRunner, Swoole Cli), Go, Node.js, Python, Java (Maven, Gradle, SDKMAN), Erlang, Ruby, Rust (Rustup), Bun, Deno, Zig.
  • Cache & Message Queue: Redis, Memcached, RabbitMQ.
  • Service Governance: Consul, Etcd, R-Nacos
  • Search Engine: Elasticsearch, Meilisearch, Typesense, ZincSearch
  • Object Storage: RustFS, Minio.
  • Automation & Scheduling: Cron Jobs.
  • Utilities: Git, MkCert, DNS Server, FTP Server, Static HTTP Server.
  • Custom modules: Users can add modules on their own, whether as services or commonly used commands. FlyEnv's custom module system ensures that user modules function just like system modules, delivering a seamless user experience.

All modules support multi-version co-existence.


🛠 Developer-Friendly Tools

  • Local Domains & SSL: Create local sites (myapp.test) with custom domains and one-click HTTPS backed by MkCert/local certificates.
  • Project Services & Reverse Proxy: Define custom start/stop commands, ports, reverse proxy rules, and HTTPS for projects in any language.
  • Cron Jobs: Schedule global or site-scoped commands with native crontab and Windows Task Scheduler integration.
  • Config & Logs: Edit php.ini or my.cnf directly in FlyEnv. View real-time error logs with highlighting.
  • Port Management: Visualize which apps are using which ports and kill processes instantly.
  • Toolbox: Compare text diffs, encode/decode JWTs, calculate cron schedules, and test WebSocket/SSE connections.

Watch Video Demo

screen3.jpeg


📥 Installation

Windows (Recommended)

Finally, a fast, native environment for Windows developers.

macOS

Linux

Supports Debian/Ubuntu (.deb) and RedHat/CentOS (.rpm).

Debian / Ubuntu

Red Hat / Fedora / SUSE / CentOS


📦 Build & Transparency

All FlyEnv installation packages are now built using GitHub Actions. You can verify the build process and download the artifacts directly from the following links:


📸 Interface Preview

Service Management Version Switching
Manage Services Version Switching
Manage Nginx/MySQL/Redis in one place Switch PHP/Node versions per project

Development & Contribution

We welcome contributions! FlyEnv is built with Node.js & web technologies (Electron/Vue).

git clone git@github.com:xpf0000/FlyEnv.git
cd FlyEnv
yarn install
yarn run dev

Check out our Development Guide to get started.

Community & Support

License: Open-source under the BSD 3-Clause License.

Extension points exported contracts — how you extend this code

TaskItem (Interface)
(no doc) [3 implementers]
src/fork/TaskQueue.ts
ToolDef (Interface)
工具定义:name + 描述 + JSON Schema(不依赖 zod,手写 inputSchema)
src/main/core/MCPServer.ts
SoftInstalled (Interface)
(no doc) [1 implementers]
src/render/store/brew.ts
ServerType (Interface)
(no doc)
src/global.d.ts
GlobalComponents (Interface)
(no doc)
src/shim.d.ts
NetworkInterfaceInfo (Interface)
(no doc)
src/shared/network.ts
PlatformSystemScheduler (Interface)
(no doc) [2 implementers]
src/fork/module/Cron/SystemScheduler.ts
StaticHttpServe (Interface)
(no doc)
src/main/type.d.ts

Core symbols most depended-on inside this repo

resolve
called by 1252
ide.config.js
push
called by 1139
src/main/core/MCPContextResolver.ts
log
called by 860
src/main/core/AppLog.ts
then
called by 709
src/render/components/YbBaseDialog/dialog.ts
I18nT
called by 694
src/lang/index.ts
catch
called by 592
src/shared/ForkPromise.ts
next
called by 388
src/render/components/AI/Task/BaseTask.ts
isWindows
called by 301
src/shared/utils.ts

Shape

Method 2,301
Function 1,908
Class 446
Interface 203
Struct 21
Enum 2

Languages

TypeScript96%
Go4%

Modules by API surface

src/main/core/IPCHandler.ts61 symbols
src/shared/WindowsHelperFallback.ts52 symbols
src/main/core/AppNodeFn.ts52 symbols
src/main/core/MCPTools.ts46 symbols
src/helper-go/utils/whitelist.go46 symbols
src/render/components/Hermes/setup.ts43 symbols
src/main/core/MCPContextResolver.ts41 symbols
src/fork/module/Image/ImageCompressTask.ts40 symbols
src/fork/module/Mariadb/index.ts39 symbols
src/fork/module/Hermes/index.ts37 symbols
src/render/components/ClaudeCode/setup.ts36 symbols
src/render/components/Codex/setup.ts33 symbols

Dependencies from manifests, versioned

github.com/Microsoft/go-winiov0.6.2 · 1×
golang.org/x/sysv0.10.0 · 1×
7zip-min-electron1.4.4 · 1×
@ayonli/jsext1.7.4 · 1×
@babel/core7.29.6 · 1×
@babel/eslint-parser7.27.5 · 1×
@babel/plugin-proposal-decorators7.27.1 · 1×
@babel/plugin-proposal-do-expressions7.27.1 · 1×
@babel/plugin-proposal-export-default-from7.27.1 · 1×
@babel/plugin-proposal-export-namespace-from7.18.9 · 1×
@babel/plugin-proposal-function-bind7.27.1 · 1×
@babel/plugin-proposal-function-sent7.27.1 · 1×

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add FlyEnv \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact