Skip to content

v0.0.1 — first public release

Choose a tag to compare

View all tags
@zechengz zechengz released this 06 May 18:44
· 753 commits to main since this release
v0.0.1
8b99fb9

The first public release of Mirage — a unified virtual filesystem for AI agents.

Mount S3, Google Drive, Slack, Gmail, GitHub, Linear, Notion, Postgres, MongoDB, SSH, and more behind one filesystem so agents read, write, and pipe across services with familiar shell commands.

What's included

  • Python SDK — mirage-ai on PyPI
  • TypeScript SDKs — @struktoai/mirage-{core,node,browser,agents,cli,server} (npm publish forthcoming)
  • CLI + daemon — uvx mirage-ai or uv tool install mirage-ai
  • FUSE mounts — expose any workspace as a real filesystem (macOS / Linux)
  • Agent integrations — OpenAI Agents SDK, Vercel AI SDK, LangChain (deepagents), Pydantic AI, CAMEL, OpenHands, Mastra, Pi Coding Agent
  • CLI agent integrations — Claude Code and Codex via FUSE
  • Documentation — https://docs.mirage.strukto.ai

Install

# Python (library + CLI)
uv add mirage-ai

# Or run the CLI directly
uvx mirage-ai

Quickstart

from mirage import MountMode, Workspace
from mirage.resource.ram import RAMResource

ws = Workspace({"/data": RAMResource()}, mode=MountMode.WRITE)
await ws.execute('echo "hello mirage" | tee /data/hello.txt')

See docs.mirage.strukto.ai for the full guide.

License

Apache 2.0. See LICENSE.

Notes

This is an early release. Expect bugs and breaking changes through the 0.0.x line. Report issues at github.com/strukto-ai/mirage/issues or report security concerns per SECURITY.md.

Assets 2
Loading