Foxel: Private Cloud Storage with AI-Powered Semantic Search

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

Foxel: Private Cloud Storage with AI-Powered Semantic Search

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.

Repository Information

Analyzed by OSRepos on February 2, 2026

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

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:
mkdir -p data/db
mkdir -p data/mount
chmod 777 data/db data/mount
  1. Download Docker Compose File
    Download the compose.yaml file directly from the GitHub repository:
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.

  1. Start the Services
    Once the compose.yaml is configured, start the Foxel services:
docker-compose up -d
  1. 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.

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

Source repository

Open the original repository on GitHub.

View on GitHub
OS
OSRepos

Analysis and discovery of open source repositories. Find interesting projects and follow their updates.

Monitor your website with YourWebsiteScore

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of third-party repository code is at your own risk. Always review source code, dependencies, licenses, and security implications before running anything.

© 2025 OSRepos. Built with Nuxt 3 and lots of ❤️