Houdry Fabric and Houdry Agent

FAQ

Fabric, Agent, air gap, models, and hardware.

What is Houdry, in one sentence?

Houdry Fabric runs open-weight models on your GPU workstations; Houdry Agent is the desktop app that talks to that fabric on the LAN.

Does any data leave our premises?

Not for model inference. Fabric runs on your GPU workstations. Agent talks to http://HOST:8080/v1 on the LAN. Documents in Knowledge stay on the desk machine. You can pull the WAN cable and keep working if Ollama and Fabric are up.

What do we install on a laptop vs a GPU workstation?

GPU / ops: Houdry Fabric (install.sh / install.ps1) plus Ollama, then houdry serve + houdry gpu register. Desk: Houdry Agent, pointed at the fabric URL. You do not put Fabric on every laptop.

Do we need Ollama?

Yes, on the GPU host. Fabric’s working runtime is Ollama. Install it, pull at least one chat model, and leave it running. See Installation.

Which models does it use?

Open-weight models you pull into Ollama on the GPU host: for example a small chat model to start, then DeepSeek R1 for reasoning and Qwen2.5-VL for drawings. model=auto lets Fabric score task vs catalog vs READY nodes. Pin a name to force one model.

Do we need the internet after install?

Only to download the installers, binaries, and model weights the first time. After that, serve, register, and Agent are local.

What hardware is enough?

One GPU workstation is enough to demonstrate. Larger models need more VRAM. Add machines with houdry gpu register on the same LAN. The Agent install does not change.

Why must the URL end with /v1?

The OpenAI-shaped API lives under /v1. http://HOST:8080 is the dashboard. http://HOST:8080/v1 is what Agent and SDKs call. Missing /v1 is a common connect failure.

Agent cannot find the fabric

Confirm houdry serve is listening on 0.0.0.0:8080, that you are on the same Wi‑Fi, and that guest isolation is off. Otherwise paste the URL. See Troubleshooting.

Is Houdry free?

Houdry Agent is open source (MIT). Fabric ships as GitHub Releases you run on your own hardware. No per-seat cloud licence. You supply GPUs and model weights.

Is this Agent Orchestrator / ao?

No. Houdry is Fabric + Agent. There is no ao CLI, no Claude Code harness catalog, and no cloud coding-agent board.