mirage

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

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 280 🐛 待处理 24 👀 关注 7

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3773

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队strukto-ai

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

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

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言TypeScript

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

GitHub 星标★ 3773

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

代码更新2026-11-07

仓库体积138.0 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3773

技术标签

agent-sandbox agent-tools ai-agents bash claude-code

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 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 快速开始页面按指引配置存储后端。