# Análise do Repositório: strukto-ai/mirage

## Problema
O repositório **Mirage** resolve o problema de fragmentação de acesso a dados e serviços por parte de agentes de IA. Antes, cada serviço (S3, Google Drive, Slack, Gmail, Redis, GitHub, etc.) exigia um SDK e um modelo de dados próprios, dificultando a composição de fluxos de trabalho e aumentando a curva de aprendizado para modelos de linguagem. Mirage unifica todos esses serviços em uma árvore de diretório única, permitindo que agentes usem as mesmas ferramentas bash/Unix para interagir com qualquer backend.

## Tema Principal
**A Unified Virtual Filesystem For AI Agents**: um sistema de arquivos virtual que monta serviços e fontes de dados variadas (S3, Google Drive, Slack, Gmail, Redis, GitHub, MongoDB etc.) lado a lado sob uma única raiz, acessível por comandos shell familiares (cat, grep, ls, cp, find, wc).

## Razão do Hype
- **Abstração simples e universal:** age como tradutor universal entre LLMs e serviços externos via semântica de sistema de arquivos.
- **Multi-framework:** compatível com OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, OpenHands, Mastra.
- **Multi-linguagem:** SDKs em Python e TypeScript, mais CLI global.
- **Cache plugável:** duas camadas de cache (índice e arquivo) com backends em RAM ou Redis para reduzir chamadas de rede.
- **Portabilidade:** snapshots e clones do workspace permitem reproduzir/mover ambientes entre máquinas sem reconfiguração.
- **Habilidade para rodar em múltiplos runtimes:** Node.js, browser, Python/async, FastAPI, Express.

## Tecnologias
- **Linguagens:** TypeScript (node, browser, core, agents, cli, server) e Python (mirage-ai)
- **Runtime:** Node.js ≥ 20, Python ≥ 3.12
- **Camada de integração/bindings:** aiofiles, redis.asyncio / aioboto3, aiosqlite, PyArrow, DuckDB, httpx/HTTP, fsspec-like
- **Armazenamento alternativa local:** RAM, Disk, Redis, SQLite, DuckDB
- **Serviços suportados:** S3/R2/OCI/Supabase/GCS, Gmail/GDrive/GDocs/GSheets/GSlides, GitHub/Linear/Notion/Trello, Slack/Discord/Telegram/Email, MongoDB, SSH, entre outros
- **CLI + Daemon:** permite uso direto por coding agents como Claude Code e Codex
- **Gerenciamento de dependências Python:** uv

---
*Análise feita em 30/05/2026, a partir do clone do repositório https://github.com/strukto-ai/mirage.*