From 4f6080ff800da00fcb48cad5b24ae23783d05ec3 Mon Sep 17 00:00:00 2001 From: filoxenace Date: Sun, 21 Dec 2025 18:49:45 -0500 Subject: [PATCH] Update readme to add some more info --- .env.example | 3 +++ README.md | 29 +++++++++++++++++++---------- pyproject.toml | 2 ++ 3 files changed, 24 insertions(+), 10 deletions(-) create mode 100644 .env.example diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..a6b1ccf --- /dev/null +++ b/.env.example @@ -0,0 +1,3 @@ +TARGET_ID= +VALID_API_KEY= +ROBLOSECURITY_TOKEN= diff --git a/README.md b/README.md index e1aa28c..b347c4f 100644 --- a/README.md +++ b/README.md @@ -23,9 +23,9 @@ This will create a virtual environment and install all required packages. Create a `.env` file in the project root with the following variables: ``` -TARGET_ID= # The Roblox group ID to upload clothing to -VALID_API_KEY= # API key for authorizing requests to this service -ROBLOSECURITY= # Your Roblox roblosecurity cookie (only needed for authed APIs) +TARGET_ID= # The Roblox group ID to upload clothing to +VALID_API_KEY= # API key for authorizing requests to this service +ROBLOSECURITY_TOKEN= # Your Roblox roblosecurity cookie (used only for Roblox API calls) ``` ## ⚠️ Disclaimer @@ -34,18 +34,27 @@ This tool uses Roblox's APIs in a way that violates their Terms of Service. Robl ## Running -Start the FastAPI server: +### Development Server +Start the development server with hot-reload (listens on `127.0.0.1` only): ```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: +### Production Server +Start the production server (listens on `0.0.0.0`: ```bash -curl -H "x-api-key: your_api_key" http://localhost:8000/asset/{asset_id} +uv run fastapi run src/main.py +``` + +The server will run on port 8000 by default. + +## Project Structure + +``` +src/ +├── main.py # FastAPI application and endpoints +├── models.py # Data models for Roblox assets and creators +└── utils/ # Utility modules for Roblox API interactions ``` diff --git a/pyproject.toml b/pyproject.toml index 63c4ec9..14bedaa 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -9,3 +9,5 @@ dependencies = [ "python-dotenv>=1.2.1", "httpx>=0.25.0", ] + +