README and LICENSE for public release

README.md

@@ -0,0 +1,51 @@
+# clothing-upload-bot
+
+A FastAPI service for reuploading clothing assets to Roblox groups, used in *Filoxen Research Facilities*. This app fetches clothing from existing Roblox assets and reuploads them to a target group.
+
+## Prerequisites
+
+- Python 3.13+
+- `uv` (install from [astral.sh/uv](https://astral.sh/uv))
+- Valid Roblox `roblosecurity` cookie in your environment
+
+## Installation
+
+Clone the repository and install dependencies with `uv`:
+
+```bash
+uv sync
+```
+
+This will create a virtual environment and install all required packages.
+
+## Configuration
+
+Create a `.env` file in the project root with the following variables:
+
+```
+TARGET_ID=<group_id>           # The Roblox group ID to upload clothing to
+VALID_API_KEY=<your_api_key>   # API key for authorizing requests to this service
+ROBLOSECURITY=<cookie>         # Your Roblox roblosecurity cookie (only needed for authed APIs)
+```
+
+## ⚠️ Disclaimer
+
+This tool uses Roblox's APIs in a way that violates their Terms of Service. Roblox may moderate or ban accounts that use this. Use at your own risk.
+
+## Running
+
+Start the FastAPI server:
+
+```bash
+uv run fastapi dev src/main.py
+```
+
+The server will run on `http://localhost:8000` by default.
+
+## Usage
+
+Make authenticated requests using the `x-api-key` header:
+
+```bash
+curl -H "x-api-key: your_api_key" http://localhost:8000/asset/{asset_id}
+```