{"name":"Foxel: Private Cloud Storage with AI-Powered Semantic Search","description":"Foxel is a highly extensible private cloud storage solution designed for both individuals and teams. It offers centralized file management across various storage backends and features powerful AI-powered semantic search. This allows users to easily find content within images, videos, and documents using natural language queries.","github":"https://github.com/DrizzleTime/Foxel","url":"https://osrepos.com/repo/drizzletime-foxel","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/drizzletime-foxel","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/drizzletime-foxel.md","json":"https://osrepos.com/repo/drizzletime-foxel.json","topics":["Foxel","cloud storage","private cloud","AI search","semantic search","Python","file management","photo gallery"],"keywords":["Foxel","cloud storage","private cloud","AI search","semantic search","Python","file management","photo gallery"],"stars":null,"summary":"Foxel is a highly extensible private cloud storage solution designed for both individuals and teams. It offers centralized file management across various storage backends and features powerful AI-powered semantic search. This allows users to easily find content within images, videos, and documents using natural language queries.","content":"## Introduction\n\nFoxel is a powerful and highly extensible private cloud storage solution designed for both individuals and teams. It aims to provide a unified platform for managing files distributed across various storage backends, enhancing accessibility and organization. Built with Python for its backend and React/TypeScript for a modern frontend, Foxel stands out with its innovative AI-powered semantic search capabilities.\n\nKey features include:\n*   **Unified File Management**: Centralize management of files from different storage locations.\n*   **Pluggable Storage Backends**: Easily integrate various storage types using an extensible adapter pattern.\n*   **Semantic Search**: Perform natural language searches for content within unstructured data, such as images, videos, and documents.\n*   **Built-in File Preview**: Directly preview a wide range of file types, including images, videos, PDFs, Office documents, text, and code.\n*   **Permissions and Sharing**: Create public or private sharing links for secure and easy file distribution.\n*   **Task Processing Center**: Handle asynchronous tasks like file indexing and data backups without impacting the main application's performance.\n\n## Installation\n\nGetting started with Foxel is straightforward, with Docker Compose being the recommended method for deployment.\n\n1.  **Create Data Directories**\n    First, create the necessary directories for persistent data:\n\n    bash\n    mkdir -p data/db\n    mkdir -p data/mount\n    chmod 777 data/db data/mount\n    \n\n2.  **Download Docker Compose File**\n    Download the `compose.yaml` file directly from the GitHub repository:\n\n    bash\n    curl -L -O https://github.com/DrizzleTime/Foxel/raw/main/compose.yaml\n    \n\n    It is **strongly recommended** to modify the environment variables in the `compose.yaml` file after downloading to ensure security. Specifically, replace the default `SECRET_KEY` and `TEMP_LINK_SECRET_KEY` with randomly generated strong keys.\n\n3.  **Start the Services**\n    Once the `compose.yaml` is configured, start the Foxel services:\n\n    bash\n    docker-compose up -d\n    \n\n4.  **Access the Application**\n    After the services are running, open the application in your web browser. On the first launch, you will be guided through the setup process to initialize the administrator account.\n\n## Examples\n\nExperience Foxel firsthand by exploring its online demo. This allows you to interact with the interface and test its features before deployment.\n\n*   **Online Demo**: [https://demo.foxel.cc](https://demo.foxel.cc){:target=\"_blank\"}\n    *   Account: `admin`\n    *   Password: `admin`\n\n## Why Use Foxel?\n\nFoxel offers a compelling solution for anyone seeking robust and intelligent private cloud storage. Its key advantages include:\n\n*   **Intelligent Data Discovery**: The AI-powered semantic search transforms how you find information, allowing natural language queries to sift through vast amounts of unstructured data.\n*   **Flexibility and Control**: With pluggable storage backends, you maintain full control over where your data resides and can easily expand your storage options.\n*   **Comprehensive File Management**: From unified dashboards to built-in previews and secure sharing, Foxel provides all the tools needed for efficient file organization and collaboration.\n*   **Scalability**: Designed to handle asynchronous tasks, Foxel ensures that operations like indexing and backups run smoothly without hindering user experience.\n*   **Privacy**: As a self-hosted solution, Foxel gives you complete ownership and privacy over your data, a critical advantage over public cloud services.\n\n## Links\n\n*   **GitHub Repository**: [https://github.com/DrizzleTime/Foxel](https://github.com/DrizzleTime/Foxel){:target=\"_blank\"}\n*   **Online Demo**: [https://demo.foxel.cc](https://demo.foxel.cc){:target=\"_blank\"}\n*   **Telegram Community**: [https://t.me/+thDsBfyqJxZkNTU1](https://t.me/+thDsBfyqJxZkNTU1){:target=\"_blank\"}\n*   **WeChat Community**: Add WeChat ID `drizzle2001` to join the group.","metrics":{"detailViews":1,"githubClicks":4},"dates":{"published":null,"modified":"2026-02-02T12:01:06.000Z"}}