spacedrive README

The project's README from github.com/spacedriveapp/spacedrive. As one markdown file: README.md.

Spacedrive

Spacedrive

One file manager for all your devices and clouds.
Powered by a Virtual Distributed File System, complete with apps for macOS, Windows, Linux, iOS and Android

v2.spacedrive.com • Discord • Getting Started

What is Spacedrive?

Spacedrive is a cross-device data platform. Index files, emails, notes, and external sources. Search everything. Sync via P2P. Keep AI agents safe with built-in screening.

Is this a replacement for Finder or Explorer?

No. Spacedrive sits above your OS file manager and adds capabilities Finder/Explorer lack:

You still use your OS for low-level file interactions. Spacedrive adds the cross-platform, cross-device, cloud-aware, and automation-friendly layer on top.

Data Archival

Spacedrive indexes external data sources via script-based adapters: Gmail, Apple Notes, Chrome bookmarks, Obsidian, Slack, GitHub, calendar events, contacts. Each source becomes a searchable repository alongside your files.

Adapters are a folder with an adapter.toml manifest and a sync script in any language. If it reads stdin and prints lines, it works.

Shipped adapters: Gmail, Apple Notes, Chrome Bookmarks, Chrome History, Safari History, Obsidian, OpenCode, Slack, macOS Contacts, macOS Calendar, GitHub.

Spacebot

Spacedrive integrates with Spacebot, an open source AI agent runtime. Spacebot runs as an optional separate process. Spacedrive provides the data, permission, and execution layer. Spacebot provides the intelligence.

Each Spacebot instance pairs with one Spacedrive node as its home device. That node authenticates the agent, maintains the device graph, resolves permissions, and forwards operations to peer devices. Every device in your library can reach Spacebot through the paired node over P2P (Iroh/QUIC) without direct network access. One agent runtime serves your entire device fleet.

When Spacebot spawns a worker, that worker can target any device in the library. File reads, shell commands, and operations proxy through Spacedrive to the target device. Talk to the agent from your phone while work executes on a server. Read files from a NAS, run commands on a workstation, report to a laptop — all in one task.

Every operation passes through Spacedrive's permission system: which devices the agent can access, which paths are readable or writable, which operations are allowed, and which require human confirmation. The paired node resolves effective policy before forwarding. One security model, one audit surface across all devices and clouds.

File System Intelligence

Spacedrive adds intelligence to your filesystem by combining three layers:

When an agent navigates through Spacedrive, it receives the file listing, subtree context, effective permissions, and summaries. Users can explain how they organize their system. Agents can add attributed notes. Jobs generate summaries from structure and activity. The intelligence stays attached to the filesystem, not buried in temporary session memory.

Safety Screening

When enabled, every record passes through a safety pipeline before becoming searchable:

No other local data tool screens indexed content before exposing it to AI.

Architecture

The core is built on four principles:

  1. Virtual Distributed Filesystem (VDFS) — files and folders become first-class objects with rich metadata, independent of physical location. Every file gets a universal address (SdPath) that works across devices.

  2. Content Identity System — adaptive hashing (BLAKE3 with strategic sampling for large files) creates a unique fingerprint for every piece of content. Enables deduplication, redundancy tracking, and content-based operations.

  3. Transactional Actions — every file operation can be previewed before execution. See space savings, conflicts, and estimated time, then approve or cancel. Operations become durable jobs that survive network interruptions and device restarts.

  4. Leaderless Sync — peer-to-peer synchronization without central coordinators. Device-specific data uses state replication. Shared metadata uses an HLC-ordered log with deterministic conflict resolution.

The implementation is a single Rust crate with CQRS/DDD architecture. Every operation (file copy, tag create, search query) is a registered action or query with type-safe input/output that auto-generates TypeScript types for the frontend.

Component Technology
Language Rust
Async runtime Tokio
Database SQLite (SeaORM + sqlx)
P2P Iroh (QUIC, hole-punching, local discovery)
Content hashing BLAKE3
Vector search LanceDB + FastEmbed
Cloud storage OpenDAL
Cryptography Ed25519, X25519, ChaCha20-Poly1305, AES-GCM
Media FFmpeg, libheif, Pdfium, Whisper
Desktop Tauri 2
Mobile React Native + Expo
Frontend React 19, Vite, TanStack Query, Tailwind CSS v4
Design system SpaceUI (shared component library)
Type generation Specta 
spacedrive/
├── core/                  # Rust engine (CQRS/DDD)
├── apps/
│   ├── tauri/             # Desktop app (macOS, Windows, Linux)
│   ├── mobile/            # React Native (iOS, Android)
│   ├── cli/               # CLI and daemon
│   ├── server/            # Headless server
│   └── web/               # Browser client
├── packages/
│   ├── interface/         # Shared React UI
│   ├── ts-client/         # Auto-generated TypeScript client
│   ├── ui/                # Component library
│   └── assets/            # Icons, images, SVGs
├── crates/                # Standalone Rust crates (ffmpeg, crypto, etc.)
├── adapters/              # Script-based data source adapters
└── schemas/               # TOML data type schemas

Getting Started

Requires Rust 1.81+, Bun 1.3+, just, and Python 3.9+ (for adapters).

git clone https://github.com/spacedriveapp/spacedrive
cd spacedrive

just setup        # bun install + native deps + cargo config
just dev-desktop  # launch the desktop app (auto-starts daemon)
just test         # run all workspace tests

Privacy & Security

Spacedrive is local-first. Your data stays on your devices.

Optional cloud integration is available for backup and remote access, but it's never required. The cloud service runs unmodified Spacedrive core as a standard P2P device—no special privileges.

Contributing

License

FSL-1.1-ALv2 — Functional Source License, converting to Apache 2.0 after two years.

spacedrive (spacedriveapp/spacedrive)

Searching Database…

39.2K ·GitHub
Spacedrive
Что это такое?Spacedrive — это кроссплатформенный файловый менеджер и платформа для работы с данными на разных устройствах. Она индексирует файлы, письма, заметки и другие источники, позволяет искать по всему сразу в одном месте и синхронизирует данные между устройствами через прямые соединения по сети P2P.
Это заменит Finder или Проводник в моей ОС?Нет. Spacedrive работает поверх файлового менеджера операционной системы и добавляет поиск между устройствами, идентификацию содержимого, синхронизацию и доступ, безопасный для ИИ-агентов, но не заменяет низкоуровневые файловые операции.
Как собрать и запустить Spacedrive?В README не описан готовый установщик; проект нужно собирать из исходного кода. Для этого потребуются Rust 1.81+, Bun 1.3+, just и Python 3.9+ (для адаптеров).
Spacedrive сейчас полностью открытый проект?В традиционном смысле — пока нет: каждый релиз распространяется по лицензии FSL-1.1-ALv2 (Functional Source License), которая автоматически переходит в Apache 2.0 только через два года.
Какие устройства и операционные системы поддерживаются?Есть нативные приложения для macOS, Windows, Linux, iOS и Android; все они синхронизируются через одну общую сеть P2P.
Куда уходят мои данные и отслеживается ли что-нибудь?Spacedrive работает по принципу local-first: данные остаются на ваших устройствах, пока вы сами не решите их синхронизировать, телеметрии нет, а собственные серверы-ретрансляторы (relay) можно развернуть самостоятельно.
Что такое Spacebot?Spacebot — это необязательная отдельная среда выполнения ИИ-агентов, которая работает в паре с узлом Spacedrive: Spacedrive отвечает за данные, права доступа и маршрутизацию между устройствами, а Spacebot обеспечивает собственно интеллект агента.
Как Spacedrive не даёт ИИ-агентам доступ к небезопасному содержимому?Необязательный конвейер безопасности запускает локальный классификатор Prompt Guard 2 на проиндексированном содержимом, применяет более строгую проверку к недоверенным источникам, таким как письма, и помещает помеченные записи в карантин, исключая их из запросов ИИ-агентов.
Что такое функция Data Archival?Она позволяет индексировать внешние источники, такие как Gmail, Apple Notes, закладки Chrome, Slack и GitHub, через адаптеры на основе скриптов, превращая каждый источник в доступный для поиска репозиторий рядом с вашими файлами.
Как Spacedrive избегает дубликатов файлов на разных устройствах?Каждому файлу присваивается хеш BLAKE3 по содержимому, поэтому один и тот же файл на двух разных устройствах получает одинаковый хеш. Это позволяет Spacedrive отслеживать избыточность и дедупликацию по всему парку ваших устройств.
What are similar projects?Telegram-Drive, EnvoyMesh, siyuan, obsidian-livesync, karakeep, happy, laya, p2wlan
Which topics is it in?cloud-storage, distributed, filesystem, file-manager, sync, p2p, storage, vector-database, tauri, semantic-search, react-native, ocr
Creator
spacedriveapp
Size
275.1 MB
Stars
39.2K
Updated
CommitOct 13Release0.4.3Mar 24
Age
5y
Commits · 90 Days