Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/WyattBrashear/CLIF/llms.txt

Use this file to discover all available pages before exploring further.

CLIF gets you from installation to storing files in under five minutes. This guide walks you through installing the package, starting a server, creating an account, and running your first file upload.
CLIF requires Python 3.10 or higher. Run python3 --version to confirm before installing.
1

Install CLIF

Install both the client and server from PyPI:
pip install clifilestor
This installs the clif CLI client. To also install the server dependencies (Flask), use:
pip install "clifilestor[server]"
2

Start the server

In a terminal window, start the CLIF server:
clif-server
By default, it listens on 127.0.0.1:8000. You’ll see:
CLIF (CLIFilestor) v 1.10 Created by Wyatt Brashear
To customize the port, host, or storage limits, create a CLIF.json file before starting the server. See Server Configuration for details.
3

Create an account

In a new terminal, run:
clif signup
You’ll be prompted for:
  • Server address — e.g., http://127.0.0.1:8000
  • Username — your chosen username
  • Password — hashed with SHA-256 before being sent
On success, CLIF saves your credentials to .clif/authdata in the current directory.
The .clif/authdata file is directory-specific. If you move to a different directory, run clif login to re-authenticate there.
4

Upload your first file

Upload any file to your server:
clif upload myfile.txt
To confirm the upload succeeded, list your files:
clif list

Files currently owned by yourname:
myfile.txt
To download it back:
clif download myfile.txt
See the full CLI command reference for all available commands including clif delete, clif info, and clif logout.

Build docs developers (and LLMs) love

Get started for freeTalk to us