Skip to main content

lf start

Launch the local development stack (API server + RAG worker) and open an interactive chat UI with live config watching.

Synopsis​

lf start [flags]

Flags​

FlagDescription
--ollama-hostOverride the Ollama endpoint (default http://localhost:11434).
Global flags--server-url, --debug, --cwd, etc.

Environment variables:

  • OLLAMA_HOST – fallback if the flag is not provided.

Behaviour​

  • Ensures the server and RAG worker containers are running (via the container orchestrator/Nx).
  • Starts a config watcher so edits to llamafarm.yaml refresh automatically.
  • Launches a text UI for chatting with the current project; use Ctrl+C to exit.
  • Shows health diagnostics for server, storage, Ollama/vLLM, Celery, rag-service, and project state.
  • Starts the Designer web UI at http://localhost:8000 for visual project management.

Example​

lf start --ollama-host http://localhost:11434

Typical health banner

⚠️  Server is degraded
Summary: server=healthy, storage=healthy, ollama=healthy, celery=degraded, rag-service=healthy, project=healthy
  ⚠️ celery  degraded   No workers replied to ping (latency: 533ms)

Investigate degraded components before shipping to production—Celery workers might be offline or overloaded.

See Also​