# Foxel: Private Cloud Storage with AI-Powered Semantic Search

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/drizzletime-foxel
Generated for open source discovery and AI-assisted research.

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
OSRepos URL: https://osrepos.com/repo/drizzletime-foxel

## 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.

## Topics

- Foxel
- cloud storage
- private cloud
- AI search
- semantic search
- Python
- file management
- photo gallery

## Repository Information

Last analyzed by OSRepos: Mon Feb 02 2026 12:01:06 GMT+0000 (Western European Standard Time)
Detail views: 1
GitHub clicks: 4

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Foxel 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.

Key features include:
*   **Unified File Management**: Centralize management of files from different storage locations.
*   **Pluggable Storage Backends**: Easily integrate various storage types using an extensible adapter pattern.
*   **Semantic Search**: Perform natural language searches for content within unstructured data, such as images, videos, and documents.
*   **Built-in File Preview**: Directly preview a wide range of file types, including images, videos, PDFs, Office documents, text, and code.
*   **Permissions and Sharing**: Create public or private sharing links for secure and easy file distribution.
*   **Task Processing Center**: Handle asynchronous tasks like file indexing and data backups without impacting the main application's performance.

## Installation

Getting started with Foxel is straightforward, with Docker Compose being the recommended method for deployment.

1.  **Create Data Directories**
    First, create the necessary directories for persistent data:

    bash
    mkdir -p data/db
    mkdir -p data/mount
    chmod 777 data/db data/mount
    

2.  **Download Docker Compose File**
    Download the `compose.yaml` file directly from the GitHub repository:

    bash
    curl -L -O https://github.com/DrizzleTime/Foxel/raw/main/compose.yaml
    

    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.

3.  **Start the Services**
    Once the `compose.yaml` is configured, start the Foxel services:

    bash
    docker-compose up -d
    

4.  **Access the Application**
    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.

## Examples

Experience Foxel firsthand by exploring its online demo. This allows you to interact with the interface and test its features before deployment.

*   **Online Demo**: [https://demo.foxel.cc](https://demo.foxel.cc){:target="_blank"}
    *   Account: `admin`
    *   Password: `admin`

## Why Use Foxel?

Foxel offers a compelling solution for anyone seeking robust and intelligent private cloud storage. Its key advantages include:

*   **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.
*   **Flexibility and Control**: With pluggable storage backends, you maintain full control over where your data resides and can easily expand your storage options.
*   **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.
*   **Scalability**: Designed to handle asynchronous tasks, Foxel ensures that operations like indexing and backups run smoothly without hindering user experience.
*   **Privacy**: As a self-hosted solution, Foxel gives you complete ownership and privacy over your data, a critical advantage over public cloud services.

## Links

*   **GitHub Repository**: [https://github.com/DrizzleTime/Foxel](https://github.com/DrizzleTime/Foxel){:target="_blank"}
*   **Online Demo**: [https://demo.foxel.cc](https://demo.foxel.cc){:target="_blank"}
*   **Telegram Community**: [https://t.me/+thDsBfyqJxZkNTU1](https://t.me/+thDsBfyqJxZkNTU1){:target="_blank"}
*   **WeChat Community**: Add WeChat ID `drizzle2001` to join the group.