Authorization notice. Agent Workflow Platform is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Who it is forA developer who has a local model running and wants a real desktop chat interface with streaming, history, and session resume around it.
The problemA bare model endpoint gives no desktop UI, streaming pipeline, or persisted conversation state for a product prototype.
The outcomeA streamed model reply appears in the Electron app, and the model-native session can resume after a restart.
What you need first
- Docker Engine or Docker Desktop with Compose, and Python 3.12, for the local round trip
- Node.js 22.12 or newer, for the desktop workbench
- A compatible Agent CLI or model endpoint, such as a local Ollama-compatible endpoint, for real model responses
- Python 3.10 or newer, for the standalone workflow runtime
Steps
- Install desktop dependencies with
npm --prefix apps/desktop ci. - On macOS or Linux, launch with
AWP_AGENT_MODEL=llama3.2 npm --prefix apps/desktop run openai-compatible:electron. - On Windows PowerShell, set
$env:AWP_AGENT_MODEL='llama3.2'and then runnpm --prefix apps/desktop run openai-compatible:electron. - Send a message in the desktop window and confirm the streamed reply renders.
- Restart the app and confirm the session resumes.
Prompt for your agent
In the agent-workflow-platform repository, install the desktop app dependencies and launch the OpenAI-compatible Electron path with AWP_AGENT_MODEL set to the model name served by my local endpoint. Report whether a streamed reply appears in the window, and confirm that the conversation is still there after a restart.
Caveat. The README says the reference adapter needs an OpenAI-compatible Chat Completions endpoint, and the example model name llama3.2 is only an example you must replace with a model your endpoint actually serves.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for primorLee/agent-workflow-platform and "Chat with a local model in the AWP desktop app"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer