# Cecropia

Repository: [github.com/andrewcampi/cecropia](https://github.com/andrewcampi/cecropia). License: Apache-2.0.

## What it does

Cecropia is a self-hosted catalog for the GGUF models you decide are worth keeping. Paste a Hugging Face URL, pick quants, and it mirrors weights, model cards, organization metadata, and card images onto disks you control. The public UI resembles the Hugging Face Hub. The API speaks the same protocol the official `hf` CLI already uses.

When huggingface.co is up, you can keep adding mirrors. When it is not, the copies you already made still resolve from any machine on your network. A new inference box can pull a 30 GB quant from the machine in the rack instead of from the public internet.

No custom client is required. Tools that honor `HF_ENDPOINT` point at a host you run:

```bash
HF_ENDPOINT=http://your-cecropia-host:7860 HF_TOKEN=... hf download org/model
```

The token in that example is a placeholder. The README's intended deployment is a catalog on your own network, with a password if it should not be open on the LAN.

## Why it exists

Hugging Face is the default catalog for open models, and it is also a single point of failure. If huggingface.co is unreachable, every `hf download` that depends on it fails together. If a maintainer deletes a repo or replaces the weights behind the same name, the model an inference box was built around is gone. A laptop cache is not a backup, and a folder of GGUF files with no catalog is not a hub. Cecropia is a small on-prem hub for the handful of quants you actually run.

The name is a nod to Unsloth. The three-toed sloth is their logo, the cecropia is that sloth's favorite tree, and Unsloth is a common source of GGUF quants.

## What you can browse

The mirrored catalog is meant to be used the way the Hub is used: organization chips, a parameter slider, model cards with the README and files, and a "use this model" panel that shows the `hf download` command pointed at your host. Adding a mirror is a Hugging Face URL plus a choice of quants. The files, the card, and the images land on disks you control.

## Repository

Source, license, and the current UI screenshots live in [andrewcampi/cecropia](https://github.com/andrewcampi/cecropia). This page does not redistribute model weights.