mirage

让 AI 智能体像操作本地文件一样访问所有数据

Mirage 是全球首个为 AI 智能体设计的统一虚拟文件系统（VFS），旨在解决智能体在访问和操作本地文件、远程存储及云服务时面临的碎片化问题。它通过 FUSE（用户空间文件系统）技术，将多种底层存储（如本地磁盘、S3、Dropbox 等）抽象为一个统一的文件系统视图，让智能体可以用标准的文件操作接口（如读写、列目录）无缝访问所有数据。核心能力包括：提供 POSIX 兼容的文件 API，支持多种存储后端，内置沙箱机制确保安全，以及与主流智能体框架（如 LangChain、OpenAI Agents、Claude Code）的深度集成。Mirage 简化了智能体的数据访问逻辑，使开发者无需为每种存储单独编写适配器，从而大幅提升开发效率和智能体的可扩展性。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3653

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队strukto-ai

所属国家

官网地址https://www.strukto.ai

GitHubhttps://github.com/strukto-ai/mirage

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent-sandbox,agent-tools,ai-agents,bash,claude-code,dsh,dsh-plugin,fuse,llm-agents,openai-agents,python,typescript,vfs,virtual-filesystem,virtual-terminal

GitHub 星标★ 3653

30天Star增速

HF 下载量

上线时间2026-05-06 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python ≥ 3.11（用于 mirage-ai 包和 mirage 命令行工具）
Node.js ≥ 20（用于 TypeScript SDK）
可访问 PyPI 与 npm 源（下载 mirage-ai、@struktoai/mirage-node）

安装与启动步骤

1检查 Python 版本

打开终端执行命令，确认版本不低于 3.11，否则 mirage-ai 包与 mirage CLI 无法安装运行。
```
python3 --version
```
2检查 Node.js 版本

确认 Node.js 版本不低于 20，这是 TypeScript SDK 的运行前提。
```
node --version
```
3安装 Python 包与 CLI

通过 PyPI 安装 README 中标注的 mirage-ai 包，其中包含 mirage 命令行工具。
```
pip install mirage-ai
```
4安装 TypeScript SDK

如需在 Node.js 项目中使用，安装 README 中标注的 npm 包 @struktoai/mirage-node。
```
npm install @struktoai/mirage-node
```
5查看官方快速开始

README 未给出完整启动示例，请前往官方文档的 Python/TypeScript 快速开始页面按指引配置存储后端。

如何确认成功

README 未提供启动验证命令，建议按官方文档快速开始页面执行首个文件操作示例确认可用。

常见问题

Q：本机 Python 版本低于 3.11 怎么办？

A：README 要求 Python ≥ 3.11，请先升级 Python（如使用 pyenv、conda 或系统包管理器），再安装 mirage-ai。

Q：只用 TypeScript，还需要装 Python 吗？

A：不需要。Python ≥ 3.11 仅针对 mirage-ai 包和 mirage CLI，TypeScript 侧只需 Node.js ≥ 20 并安装 @struktoai/mirage-node。

Q：安装后怎么开始用？

A：README 的 Quickstart 部分未展开，请访问 docs.mirage.strukto.ai 的 Python 或 TypeScript quickstart 页面，按其示例配置存储后端。

注意事项

本教程的命令依据 README 中给出的包名与版本要求推导，具体安装方式请以官方文档为准。
README 节选未提供端口、配置文件路径、API Key 等参数，请勿自行假设。
Python 与 Node.js 两套 SDK 按需选择安装，不必同时使用。

核心亮点

统一抽象多种存储后端，智能体只需一套文件 API，开发效率高
基于 FUSE 实现，性能接近本地文件系统，兼容 POSIX 标准
内置沙箱隔离，保障智能体操作文件时的安全性

不足之处

FUSE 依赖在 macOS 和 Windows 上需要额外安装驱动，跨平台体验不统一
项目处于早期，文档和社区生态尚待完善

适用场景

智能体需要访问本地和云存储的混合场景
构建多智能体系统时统一数据访问层
需要安全沙箱环境让智能体操作文件

替代项目

AgentFS、FUSE-based virtual filesystems、e2b

项目介绍

mirage 是智能体领域的开源项目，由 strukto-ai 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,653）位列前 30%，在智能体分类的 2,499 个项目里位列前 12%。

近 45 天，它的 GitHub 星标从 3,395 增加到 3,653，净增 258。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：智能体需要访问本地和云存储的混合场景。同类可对比的替代方案包括 AgentFS、FUSE-based virtual filesystems、e2b。

上一篇：lanhu-mcp

下一篇：suede-creator-skills