Houdry Agent is what operators open (houdry-genomex/houdry-agent). It does not serve models and it does not replace houdry. It sends prompts to Houdry Fabric at https://HOST:8080/v1.
If chat is empty or errors, open Settings and confirm Houdry server URL is https://HOST:8080/v1 (HTTPS, and note /v1). See Installation.
First-run
- Choose Houdry server URL (recommended). Do not leave a public OpenAI / Azure endpoint selected if you want on-prem models.
- Accept the discovered fabric, or paste
https://HOST:8080/v1. - Model:
auto. - Optional token:
houdry(required if Fabric was started with--token). - Connect.
Same machine as Fabric: https://127.0.0.1:8080/v1.
Equivalent files if you skip the UI:
# ~/.houdry-agent/config.yaml
model:
provider: custom
base_url: https://127.0.0.1:8080/v1
default: auto
# ~/.houdry-agent/.env
OPENAI_API_KEY=houdry
OPENAI_API_KEY here is only the token Fabric expects. It does not send traffic to OpenAI.
Sessions
The left rail is Sessions.
- New session for each distinct job (one inspection, one calculation, one drawing pack).
- Pin a session you will reuse.
- Earlier sessions stay on this computer under the Agent data directory.
Mixing unrelated jobs in one transcript makes it harder to check that answers came from the right SOP.
Knowledge base
Knowledge base is the local library the agent is allowed to read:
- PDFs, SOPs, previous approval notes, equipment specs.
- Files stay on this machine. They are not uploaded to a public model host.
- Each item can carry standing rules (always-on instructions: cite the SOP, do not invent procedures, stay on this network).
Use Add files, Add note, or Open folder from that screen. Point Agent at the plant’s real document tree rather than pasting manuals into chat.
Chat
Describe the outcome, not the stack:
Read the E-204 inspection report and the equipment SOP.
Draft an approval note as a Word file.
Quote every measured value from the report.
The fabric picks a local model. Vision work (P&IDs, scans) goes to a vision-capable model when one is loaded on a READY node.
If the reply sounds like a public chatbot, Agent is not on Fabric. Reconnect using Connect Agent to Fabric.
What stays local
| On the desk (Agent) | On the GPU workstation (Fabric) |
|---|---|
| UI, sessions, knowledge files, tools | Model weights, GPU, houdry serve / register |
~/.houdry-agent or %LOCALAPPDATA%\houdry-agent | ~/.houdry |