# Mirage: un sistema de archivos virtual para agentes

> Conecta fuentes de datos bajo rutas comunes para que tu agente las explore con operaciones de archivos. Define qué puede ver, leer o modificar antes de ampliar sus accesos.

Verificado el 26 oct 2026.

## Qué es

Mirage es una terminal virtual para agentes con un sistema de archivos que monta servicios bajo un mismo árbol. Incluye bibliotecas para Python y TypeScript, una CLI y adaptadores para frameworks de agentes.

## Para qué te sirve

- Cuando un agente necesita cruzar un CSV de almacenamiento de objetos con otros documentos.
- Cuando quieres consultar varias fuentes con rutas y comandos conocidos.
- Cuando necesitas controlar qué carpetas aparecen ante el agente, además de sus permisos de lectura.

## Cómo funciona

Workspace, la clase que representa el espacio de trabajo, agrupa montajes virtuales: memoria RAM, almacenamiento de objetos y conectores a servicios. Su shell interpreta comandos sobre esas rutas. Puedes registrar CLI y entornos de ejecución; perfiles y políticas regulan operaciones y visibilidad. Las instantáneas permiten guardar y restaurar el espacio de trabajo, según las funciones de cada montaje.

## Antes de empezar

La ruta Python descrita necesita Python ≥3.12 y uv, según el [pyproject.toml oficial](https://github.com/strukto-ai/mirage/blob/main/python/pyproject.toml). Elige el paquete del entorno de ejecución que utilices. La prueba en RAM no necesita credenciales externas; conectar S3 o servicios empresariales sí requiere su configuración y permisos. Los proveedores conectados y el modelo pueden tener coste. El repositorio marca el estado como versión preliminar.

## Límites y alternativas

No es un Bash del sistema con todos sus programas: es una terminal virtual con sus propias implementaciones y adaptadores. Una ruta común no uniforma todos los permisos ni las condiciones de los servicios. Empieza con un montaje y añade otros cuando hayas comprobado lectura y escritura. Usar herramientas específicas de cada servicio sigue siendo una alternativa más directa para integraciones pequeñas.

## Recursos

- [Repo en GitHub](https://github.com/strukto-ai/mirage) - 3738 estrellas, licencia Apache-2.0.
- [README consultado](https://github.com/strukto-ai/mirage/blob/95412628046ce315e359c700bb9b51f5cc87a98c/README.md) - instalación, alcance y ejemplos.
- [Licencia declarada](https://github.com/strukto-ai/mirage/blob/95412628046ce315e359c700bb9b51f5cc87a98c/LICENSE) - condiciones del código.
- [Último commit consultado](https://github.com/strukto-ai/mirage/commit/95412628046ce315e359c700bb9b51f5cc87a98c) - 2026-10-26.