A highly extensible private cloud storage solution designed for individuals and teams, Foxel offers unified file management across diverse storage backends and features AI-powered semantic search for intuitive content discovery. Its pluggable architecture and robust access control make it a flexible and secure option for managing distributed data.

How It Works

Foxel employs an extensible adapter pattern to integrate various storage protocols and cloud drives, presenting a single interface for file operations. Its core innovation lies in AI-powered semantic search, leveraging configurable embedding providers and vector databases like Milvus or Qdrant to enable natural language queries across file content, including images and documents. A manifest-based plugin system allows for runtime extension of both frontend and backend functionalities, enhancing customizability without modifying the core codebase.

Quick Start & Requirements

The recommended installation method is via Docker Compose.

• Primary install: Clone the repository, create persistent data directories (data/db, data/mount), download compose.yaml, modify SECRET_KEY and TEMP_LINK_SECRET_KEY in compose.yaml, and run docker-compose up -d.
• Prerequisites: Python 3.14+, React 19, Docker, curl.
• Links: Online Demo: https://demo.foxel.cc, Contribution Guide: CONTRIBUTING.md.

Highlighted Details

• AI-Powered Semantic Search: Enables searching by natural language descriptions within file content, powered by vector databases.
• Pluggable Storage Backends: Supports local, S3-compatible, WebDAV, SFTP, FTP, Google Drive, OneDrive, Dropbox, Telegram, and more.
• Extensible Plugin System: Allows runtime loading of custom React frontend components and backend routes.
• Role-Based Access Control (RBAC): Features built-in and custom roles with fine-grained, path-based permissions and audit logging.
• AI Agent: Integrated agent for VFS operations, web fetching, and file processing automation.

Maintenance & Community

Community discussions and support are available via Telegram and WeChat. Contribution guidelines are detailed in CONTRIBUTING.md.

Licensing & Compatibility

Foxel is licensed under the permissive MIT License, allowing for broad compatibility with commercial and closed-source projects.

Limitations & Caveats

The README does not explicitly detail known limitations, alpha status, or specific unsupported platforms. Users should consult the project's issue tracker for potential bugs or feature gaps.