This release is a pre-release and may not be stable for production use.
mh-local
A self-contained local Agent assistant powered by minimal-harness. It bundles a FastAPI backend with a built-in Vue 3 SPA frontend — no database, no external service dependencies.
Latest version: 0.1.0a1
Features
- No cloud required — runs entirely on localhost, single-user
- Built-in web UI — chat interface with agent, scene, tool, and LLM provider management
- No database — file-based sessions and registries under
~/.config/mh-local/ - Auto-discovery — automatically creates a workspace scene from the current directory
Quick start
uv add mh-local
uv run mh-local
Your browser will open automatically to http://127.0.0.1:<port>.
On first run, you'll be prompted to configure an LLM provider (API key, base URL) via the web UI's Provider management page.
Usage
After starting, mh-local serves a full-featured chat UI at the local URL with:
- Chat — converse with AI agents with streaming responses
- Manage Agents — view and configure built-in agents (General Assistant, Code Reviewer, Writer)
- Manage Tools — inspect available tools (bash, handoff, discover_agents, and more)
- Manage Scenes — workspace management for different projects
- Manage Providers — configure LLM providers (OpenAI, Anthropic, etc.)
How it works
mh-local
├── FastAPI app (mh_gateway-based) — serves API + static files
├── Vue 3 SPA — chat UI served at /
├── File-based stores:
│ ├── sessions/ — conversation history
│ ├── providers.json — LLM provider config
│ └── registry.json — agents, tools, scenes
└── Local auth — auto-grants admin access
Configuration
All configuration is done through the web UI. Persistent data lives at:
| Path | Contents |
|---|---|
~/.config/mh-local/providers.json |
LLM provider credentials |
~/.config/mh-local/registry.json |
Agent/tool/scene registrations |
~/.config/mh-local/sessions/ |
Chat session files |
~/.config/mh-local/logs/ |
Runtime logs |
Development
# Build frontend (SPA + component UMD bundles)
powershell scripts/build-mh-local-frontend.ps1 # Windows
bash scripts/build-mh-local-frontend.sh # Linux/macOS
# Run
uv run mh-local
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mh_local-0.1.0a5.tar.gz.
File metadata
- Download URL: mh_local-0.1.0a5.tar.gz
- Upload date:
- Size: 186.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a574653b135e6ba4f6e1c72a2b7f07f030d73a1b122d1246903e9b8edb33eacd
|
|
| MD5 |
993ab1b77859c607452077e53ec8f2cb
|
|
| BLAKE2b-256 |
0f380251241714e9bf287f8747fd074322ffd212b854554adec49a9295281008
|
File details
Details for the file mh_local-0.1.0a5-py3-none-any.whl.
File metadata
- Download URL: mh_local-0.1.0a5-py3-none-any.whl
- Upload date:
- Size: 199.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
369d2f4e94e97b4445b8e69fe01c1267113b0b4a9f1d895aece9a6527a397878
|
|
| MD5 |
892b8200107c8c14eb2d362b2ab2093f
|
|
| BLAKE2b-256 |
11c7b028a0ce50ee7c8f059bb86aba324d508e10eb94b51453e8671a7b4ced89
|
