dave-it-guy 0.2.11

Dave IT Guy — Deploy AI stacks with one command. OpenClaw, Ollama, Qdrant—fully containerized. Run locally or ship to the cloud. Same stack, anywhere.

Lucia The Orchestrator

Lucia The Orchestrator — deploy OpenClaw with one command, or one hand gesture and voice.

Docker Compose templates for OpenClaw, Ollama, Qdrant, and MasterClaw (spawns worker containers via the Docker socket). CLI: dave-it-guy. Optional extras: [voice] for speech-driven control; hand / hand_interaction for camera gesture workflows.

CLI	dave-it-guy (Typer)
Python	≥ 3.9
Full command reference	Commands.md

---

Quick start

python3 -m venv .venv
source .venv/bin/activate   # or use .venv/bin/dave-it-guy without activating
pip install -e ".[dev]"
dave-it-guy doctor
dave-it-guy deploy openclaw

• OpenClaw UI: http://localhost:18789 (gateway port overridable with --port)
• Secrets & config land under ~/.dave_it_guy/deployments/<stack>/ (see below)

Optional: run the CLI from Docker — docker-compose.cli.yml + root Dockerfile (mounts Docker socket + ~/.dave_it_guy).

Voice & hand extras: pip install -e ".[dev,voice,hand]" — [hand] needs Python 3.10+ (MediaPipe pulls packages such as JAX that are not bytecode-compatible on 3.9). [voice] can stay on 3.9 with brew install portaudio on macOS for PyAudio. If install failed mid-way, recreate the venv with python3.11 -m venv .venv (or 3.10/3.12), upgrade pip, then reinstall.

---

What runs where (stacks)

Stack	Role	Default host port	Main services
openclaw	Assistant + local LLM + vector DB + orchestrator	18789 (gateway), 6333 (Qdrant), 8090 (MasterClaw)	OpenClaw, Ollama, Qdrant, MasterClaw
ollama	Ollama + Open WebUI	3000 (WebUI), 11434 (Ollama API)	ollama, open-webui
rag	Embeddings + Qdrant + thin API	8080 (API), 6333 (Qdrant), 8081 (embeddings)	qdrant, embeddings, rag-api

• Ollama in the openclaw stack is not exposed on the host unless you pass --ollama-port (then host:11434 → container:11434).
• MasterClaw exposes 8090 by default (--masterclaw-port to change). It needs the Docker socket to run worker containers; treat that as high privilege.

Templates live under dave_it_guy/templates/; the registry is in dave_it_guy/templates/__init__.py.

---

Deployment directory (rendered output)

After deploy, each stack has a folder:

~/.dave_it_guy/deployments/<stack>/

Artifact	Purpose
docker-compose.yml	Rendered Compose (from Jinja templates)
.env	API keys and env (not for git — keep permissions tight)
config/	e.g. openclaw.json for OpenClaw
workspace/	OpenClaw workspace bind-mount (openclaw stack)

Edit files there and run docker compose up -d in that directory to apply changes.

---

CLI entrypoints

Command	Purpose
dave-it-guy list	List stack templates
dave-it-guy deploy <stack>	Render template and start stack (openclaw, ollama, rag)
dave-it-guy doctor	Docker / disk / port checks
dave-it-guy status [stack]	Container status
dave-it-guy logs <stack>	Logs (--follow, --service)
dave-it-guy stop <stack>	Stop (keeps volumes)
dave-it-guy destroy <stack>	Remove (--volumes, --yes)
dave-it-guy masterclaw-tui	TUI against MasterClaw API
dave-it-guy voice	Voice control (needs [voice] extra)
dave-it-guy sync-openclaw-scheduler	Sync scheduler script into deployed workspace

---