Sandbox
@xpf0000/FlyEnv

Local development environment with MCP and AI tools

FlyEnv is a native local development workspace for managing app runtimes, databases, web servers, local domains, HTTPS, and AI coding tools. It also exposes a built-in FlyEnv MCP Server so supported agents can inspect services, sites, configs, logs, versions, and lifecycle actions.

3,206 stars362 forksTypeScriptUpdated 6d ago
Who it's for

Builders who want a native desktop workspace for local services, project runtimes, and agent workflows.

What it delivers

You can run and switch your local stack in one app instead of managing each service separately.

What it does

Per-project runtime management

Switch PHP, Node.js, Python, and other runtimes by project.

Local sites and HTTPS

Create local domains like `myapp.test`, add certificates, and use reverse proxies.

Service and database management

Run and manage databases, web servers, caches, search tools, and other local services.

AI coding tool support

Manage Claude Code, Codex, Copilot CLI, and other supported AI clients from FlyEnv.

Built-in MCP server

Expose selected services, sites, configs, logs, versions, and lifecycle actions through FlyEnv MCP Server.

How to get it

  1. 1Run
    brew install flyenv

README

FlyEnv

FlyEnv Logo

Run Your Complete Local Development Stack Natively

FlyEnv is a native local development environment for Windows, macOS, and Linux.
A modern alternative to XAMPP, MAMP, Laragon, and Laravel Herd — built for more than PHP.

Manage PHP, Node.js, Python, Java, Go, databases, web servers, local sites, HTTPS, AI coding tools, and MCP from one desktop app.

GitHub release Total Downloads

Download · Demos · Quick Start · Website


Why FlyEnv?

FlyEnv brings the local development tools you normally manage separately into one native desktop workspace.

  • No container setup required for everyday local development — run installed services directly on your operating system.
  • One workspace for your stack — runtimes, databases, web servers, queues, search, storage, local sites, and developer tools.
  • Per-project runtime versions — switch PHP, Node.js, Python, and other environments by project.
  • Local domains and HTTPS — create local sites such as myapp.test with certificates and reverse proxies.
  • AI-ready local development — manage AI coding CLIs and expose selected local environment capabilities through the built-in FlyEnv MCP Server.
  • Cross-platform — Windows, macOS, and Linux.

If XAMPP, MAMP, Laragon, or Laravel Herd already make sense to you, FlyEnv solves a similar local-development problem — but across a broader stack.


Coming from XAMPP, MAMP, Laragon, or Laravel Herd?

If you are familiar with...FlyEnv may fit when you need...
XAMPP / MAMPMore runtimes, databases, web servers, project-level versions, and local development services
LaragonA cross-platform workflow across Windows, macOS, and Linux, plus broader runtime/service coverage and AI/MCP workflows
Laravel HerdA broader environment beyond PHP/Laravel, including Node.js, Python, Java, Go, databases, infrastructure services, and AI/MCP
Docker DesktopNative local services and a desktop workflow when you do not need container parity for the task

Docker and FlyEnv solve overlapping but different problems. Use Docker when containerized reproducibility or production parity is the goal; use FlyEnv when you want a native local development workspace with less setup overhead.


What Can You Run?

FlyEnv can manage complete local project stacks, not just one runtime.

  • Laravel — PHP, MySQL/PostgreSQL, Redis, Node.js, Nginx, HTTPS
  • Django / Python web apps — Python, PostgreSQL, Redis, Nginx, HTTPS
  • ERPNext — Python, MariaDB, Redis, Nginx
  • Gitea — Gitea, MySQL, Nginx, HTTPS
  • Local databases and services — PostgreSQL, MongoDB, Redis, RabbitMQ, Elasticsearch, ClickHouse, Neo4j, Qdrant, MinIO/RustFS
  • AI coding workflows — Claude Code, Codex, OpenCode, Kimi, GitHub Copilot CLI, and FlyEnv MCP Server

Browse FlyEnv demos →


Core Capabilities

Local stack management

  • Languages & runtimes: PHP, Node.js, Python, Java, Go, .NET, Flutter, Ruby, Rust, Erlang, Bun, Deno, Zig
  • Databases: MySQL, MariaDB, PostgreSQL, MongoDB, ClickHouse, Neo4j, Qdrant
  • Web & app servers: Nginx, Apache, Caddy, FrankenPHP, Tomcat
  • Cache & messaging: Redis, Memcached, RabbitMQ
  • Search & infrastructure: Elasticsearch, Meilisearch, Typesense, ZincSearch, Consul, Etcd, R-Nacos, Temporal
  • Object storage: MinIO, RustFS
  • AI & automation: FlyEnv MCP Server, Claude Code, Codex, OpenCode, Kimi, GitHub Copilot CLI, Ollama, n8n, Hermes Agent, CLIProxyAPI
  • Other tools: Cloudflare Tunnel, Mailpit, Cron Jobs, Git, MkCert, DNS Server, FTP Server, Static HTTP Server

Project workflows

  • Switch runtime versions per project
  • Define project start/stop commands and ports
  • Create local domains
  • Enable HTTPS
  • Configure reverse proxies
  • Open configs and logs
  • Group services and projects into reusable startup workflows

AI coding & MCP

  • Manage supported AI coding clients from FlyEnv
  • Register the built-in FlyEnv MCP Server
  • Let supported AI clients inspect selected services, sites, configs, logs, versions, and lifecycle actions
  • Keep AI workflows and local project infrastructure in the same workspace

FlyEnv MCP and AI CLI workflow


Installation

Windows

macOS

brew install flyenv

Linux

For the latest packages, see GitHub Releases.


Interface Preview

Service ManagementVersion Switching
FlyEnv service management interfaceFlyEnv project runtime version switching

Open Source & Build Transparency

FlyEnv is open source under the BSD 3-Clause License.

Installation packages are built through GitHub Actions.

Free Windows code signing is provided by SignPath.io, with the certificate provided by the SignPath Foundation.


Development & Contribution

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

See the Development Guide.


Community & Support

License: BSD 3-Clause

Files in the repo

Repository payload46 top-level entries
  • .codex
  • .github
  • .yarn
  • build
  • configs
  • docs
  • patches
  • public
  • scripts
  • src
  • static
  • tmp
  • .editorconfig
  • .flyenv
  • .gitattributes
  • .gitignore
  • AGENTS.md
  • app-update.yml
  • DEV.md
  • eslint.config.mjs
  • flyenv-mcp-screen.webp
  • flyenv-mcp.jpeg
  • flyenv-mcp.png
  • icns.sh
  • icons.linux.sh
  • ide.config.js
  • ISSUES_TRIAGE.md
  • latest-linux-arm64.yml
  • latest-linux.yml
  • latest-mac-arm64.yml
  • latest-mac.yml
  • latest.yml
  • LICENSE
  • Linux.md
  • package.json
  • postcss.config.mjs
  • prettier.config.mjs
  • README_ID.html
  • README.md
  • RELEASE_NOTES.md
  • screen1.jpeg
  • screen2.jpeg
  • screen3.jpeg
  • tailwind.config.ts
  • tsconfig.json
  • yarn.lock

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k