Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt

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

Prerequisites

  • Python 3.10+
  • uv package manager
  • Daytona credentials for sandbox execution
  • pnpm — only if you build the frontend from source

Install from PyPI

For most users, install the published package into a uv-managed project:
uv init           # skip if you already have a uv project
uv add fleet-rlm
Verify the installation:
uv run fleet --help
uv run fleet-rlm --help
Launch the Web UI:
uv run fleet web

Install from source

For contributors who need to modify fleet-rlm itself.

1. Clone and sync dependencies

git clone https://github.com/Qredence/fleet-rlm.git
cd fleet-rlm
uv sync --all-extras
--all-extras installs the dev, server, and full optional extras. uv sync also installs the default dev dependency group.

2. Configure environment

cp .env.example .env
Edit .env and set at minimum:
DSPY_LM_MODEL=openai/gpt-4o
DSPY_LLM_API_KEY=sk-...
DAYTONA_API_KEY=...
If you use MLflow locally, keep MLFLOW_TRACKING_URI=http://127.0.0.1:5001 aligned with the make mlflow-server target. In APP_ENV=local, the API server auto-starts that local MLflow target unless MLFLOW_AUTO_START=false.

3. Frontend setup (optional)

For frontend development, install dependencies in src/frontend/:
cd src/frontend
pnpm install --frozen-lockfile
Run the frontend gate:
pnpm run api:check
pnpm run type-check
pnpm run lint:robustness
pnpm run test:unit

4. Verify the source install

uv run fleet-rlm chat --trace-mode compact
uv run fleet web

Common Makefile targets

TargetWhat it does
make sync-alluv sync --all-extras
make test-fastRun tests excluding live_llm and benchmark
make quality-gateBackend lint/type/tests, metadata/docs, frontend gate
make release-checkQuality gate + security checks + UI build + packaging
make mlflow-serverStart local MLflow server on port 5001

Frontend dev commands

CommandDescription
pnpm run devStart the development server
pnpm run api:checkVerify frontend OpenAPI artifacts match openapi.yaml
pnpm run type-checkTypeScript type checks
pnpm run lint:robustnessLint lane used by repo validation
pnpm run test:unitUnit tests
pnpm run buildProduction build
pnpm run checkFull suite: type-check, lint, unit, build, e2e

Next steps

Configuration reference

Full environment variable reference.

Deployment guide

Run the API server in production.