Skip to main content
1

Install the package

pip install hexgate
Or, for a local checkout:
git clone https://github.com/HexamindOrganisation/hexgate.git
cd hexgate
pip install -e .
2

Set up environment variables

cp .env.sample .env
Fill in the three keys for the example flow:
OPENAI_API_KEY=sk-...
LINKUP_API_KEY=...
TAVILY_API_KEY=...
3

Run the chat REPL

hexgate chat --agent example_agent
The chat command sets HEXGATE_LOCAL_MODE=1 automatically, so audit stays on your machine. Denies and approval-required calls render as inline panels in the terminal.

​
Next steps

Pick a path

Should you use hexgate chat or hexgate serve? Decide here.

Wrap an existing agent

Got an OpenAI Agents / LangChain / Google ADK / Pydantic AI agent? Wrap it once.

Author a policy

YAML policy shape, constraints, role inheritance — the full spec.

User scope

Per-request user identity, role resolution, biscuit attenuation.