whatisgithub

What is cloudfay?

kirilliti1/cloudfay — explained in plain English

Analysis updated 2026-07-26

2PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A self-hosted file storage server that lets you store files on your own computer and access them from other devices through a web browser or API. Runs on Windows with Python.

Mindmap

mindmap
  root((repo))
    What it does
      Upload and download files
      Manage folders and files
      Temporary public share links
    Features
      Chunked large file handling
      Trash bin with restore
      Thumbnails for files
    Security
      Bearer token auth
      Path traversal protection
      Env file configuration
    Access
      Web browser interface
      REST API for scripts
      Tailscale for remote access
    Requirements
      Windows operating system
      Python 3.12
      PolyForm Noncommercial License

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Store files on your own computer and access them from other devices via a web browser.

USE CASE 2

Share files with others using temporary public links.

USE CASE 3

Automate file uploads and downloads using the REST API from scripts or other apps.

USE CASE 4

Run a personal cloud storage solution without relying on third-party services.

What is it built with?

PythonREST API

How does it compare?

kirilliti1/cloudfay0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Windows and Python 3.12, install deps with pip, configure a .env file, and run python server.py.

Free for personal use only, commercial use is not permitted under the PolyForm Noncommercial License.

So what is it?

CloudFay is a self-hosted file storage server. It lets you store files on your own computer and access them from other devices through a web browser. The project was built as a personal cloud storage solution, and the developer plans to add multi-user support in a future version. The core feature set covers what you would expect from a file manager. You can upload and download files, create folders, rename items, and move them around. Large files are handled carefully: instead of loading an entire file into memory, the server writes it to disk in chunks. The developer tested this with a file of about 8.15 GB. There is also a trash bin for deleted items, so you can restore files or remove them permanently. Search and sorting are included, and the server can generate thumbnails for supported file types. You can create temporary public links to share files with others. Security is handled through bearer tokens for the API, and the server protects against path traversal attacks that try to escape the storage folder. Access to files and operations is checked on every request. Configuration is done through a .env file where you set your username, password, and a secret token. The project also exposes a REST API, which lets external programs log in, list files, upload, download, rename, move, delete, restore, create folders, and generate temporary links. This means other apps or scripts can interact with CloudFay directly, not just through the web interface. Running it requires Windows and Python 3.12. You install dependencies with pip, configure your .env file, and start the server with python server.py. Once running, you access it at http://127.0.0.1:8000 on your own machine. To reach it from other devices, the README recommends using Tailscale and connecting to your Tailscale IP address. The project uses the PolyForm Noncommercial License, which means it is free for personal use but not for commercial purposes.

Copy-paste prompts

Prompt 1
Help me set up CloudFay on my Windows machine. I have Python 3.12 installed, walk me through configuring the .env file and starting the server.
Prompt 2
Write a Python script that uses CloudFay's REST API to log in, upload a file, and generate a temporary public share link.
Prompt 3
I want to access CloudFay from my phone using Tailscale. Guide me through connecting my device to the Tailscale network and reaching the server.
Prompt 4
Help me configure CloudFay's .env file with a secure username, password, and secret token for my personal storage server.

Frequently asked questions

What is cloudfay?

A self-hosted file storage server that lets you store files on your own computer and access them from other devices through a web browser or API. Runs on Windows with Python.

What language is cloudfay written in?

Mainly Python. The stack also includes Python, REST API.

What license does cloudfay use?

Free for personal use only, commercial use is not permitted under the PolyForm Noncommercial License.

How hard is cloudfay to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cloudfay for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.