Documentation

LoRADock is an open adapter registry. The core service — metadata, weights, fine-tune queue, and the API — can run entirely on your own hardware or via our managed hosting. No adapter data or user credentials are shared with third parties.

Optional cloud-adjacent components are available for teams that need them but are never required:

• Artifact CDN — a pull-through cache fronting /download/* for geographically distributed teams. Your instance remains the source of truth; the CDN holds no originals.
• SMS verification — the default auth flow uses a configurable SMS provider (or can be replaced with TOTP). The core registry works without phone verification if you disable it in config.py.
• Enterprise tier — dedicated support SLA and a managed hosting option for organisations that cannot self-host. The software and API are identical to the community edition.

Install the CLI

curl -fsSL https://loradock.dev/install.sh | sh
dock login https://your-instance.example

The CLI stores credentials in ~/.config/loradock/credentials.json. Pass --token to override for scripted use.

Pull an adapter

Downloads the adapter weights and verifies the sha256 checksum before writing to the local cache.

dock pull llama31-8b-testcase-author
# resolves latest version, verifies sha256, writes to ~/.cache/loradock/

dock pull llama31-8b-testcase-author --version 1.4.0   # pin a specific version
dock pull qwen32b-analytics-sql --format gguf          # prefer GGUF if available

Interrupted downloads resume automatically via HTTP Range requests. You can also pull a specific base-model revision alongside the adapter:

dock pull kiln-sdxl-ceramic-catalog --with-base

Serve locally

dock serve llama31-8b-testcase-author --base meta-llama/Meta-Llama-3.1-8B-Instruct
# starts an OpenAI-compatible HTTP endpoint on localhost:11434

dock serve qwen7b-ticket-triage --port 9000 --workers 2

The serve command loads the base model, attaches the adapter, and exposes a /v1/completions (text) or /v1/images/generations (image) endpoint compatible with standard clients.

Fine-tune with LoRA

Upload a JSONL dataset, choose a base model and rank, and queue a run. Progress streams over server-sent events; the resulting adapter lands in your private registry automatically.

dock finetune \
  --base Qwen/Qwen2.5-7B-Instruct \
  --data ./train.jsonl \
  --rank 16 --alpha 32 \
  --epochs 3 --seed 42

Dataset format — one JSON object per line:

{"prompt": "Summarise this ticket:", "completion": "User reports login error on Safari 17."}
{"prompt": "Summarise this ticket:", "completion": "Payment declined after promo code applied."}

Training runs are isolated per-job. You can monitor live loss curves in the UI or stream them via the API:

curl -N -H "Authorization: Bearer $LORADOCK_TOKEN" \
  https://your-instance.example/events/<job_id>

Formats & precision

The registry stores the format and precision in adapter metadata. dock pull downloads the correct file automatically. To request a specific format:

dock pull qwen32b-analytics-sql --format gguf --precision q5_k_m

Authentication

Public adapters can be pulled without credentials. Members-only adapters and all write operations require a valid session token.

Generate a long-lived API token under Account → API tokens. Tokens are scoped:

export LORADOCK_TOKEN=ldk_live_xxxxxxxxxxxxxxxxxxxx
dock pull datum-sdxl-architectural-sections   # workspace release, uses token from env

Python SDK

Install alongside the CLI or standalone. The SDK is distributed via the CLI installer and also available as a wheel in each GitHub release:

pip install dock/loradock_sdk-*.whl   # from a downloaded release

from loradock import Client

client = Client("https://your-instance.example", token="ldk_live_xxx")

# List all public adapters
for adapter in client.adapters.list(public=True):
    print(adapter.slug, adapter.version)

# Pull and load with PEFT
adapter_path = client.adapters.pull("qwen7b-ticket-triage")

from transformers import AutoModelForCausalLM
from peft import PeftModel

base = AutoModelForCausalLM.from_pretrained("Qwen/Qwen2.5-7B-Instruct")
model = PeftModel.from_pretrained(base, adapter_path)

Configuration

All settings are controlled via environment variables. No config file required.

Rate limits

Default limits apply per IP address (requires LORADOCK_TRUST_XFF=true when behind a reverse proxy):

Exceeding a limit returns 429 Too Many Requests. Limits reset on a rolling 60-second window.