uh-harness 0.6.0__tar.gz

uh_harness-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Leroyer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

uh_harness-0.6.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: uh-harness
+Version: 0.6.0
+Summary: Universal Harness: a provider-agnostic agent harness with a local-first CLI, tool use and an optional web UI
+Author: Thomas Leroyer
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Antoine-Thomas/UH-Universal-Harness
+Project-URL: Source, https://github.com/Antoine-Thomas/UH-Universal-Harness
+Project-URL: Issues, https://github.com/Antoine-Thomas/UH-Universal-Harness/issues
+Project-URL: Documentation, https://github.com/Antoine-Thomas/UH-Universal-Harness/tree/main/docs
+Project-URL: Changelog, https://github.com/Antoine-Thomas/UH-Universal-Harness/releases
+Keywords: agent,harness,llm,ollama,cli,local-first
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: tomli>=2; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: fastapi>=0.110; extra == "dev"
+Requires-Dist: uvicorn>=0.29; extra == "dev"
+Provides-Extra: ui
+Requires-Dist: rich>=13; extra == "ui"
+Provides-Extra: web
+Requires-Dist: fastapi>=0.110; extra == "web"
+Requires-Dist: uvicorn>=0.29; extra == "web"
+Dynamic: license-file
+
+# UH — Universal Harness
+
+A provider-agnostic agent harness in Python. UH merges the ideas that worked in
+four prior projects:
+
+| Source | What UH takes from it |
+| --- | --- |
+| Harness Maxxing | web UX, organised sessions |
+| OpenClaw | the harness contract (toolsets, fail-closed modes) |
+| Hermes Agent | the synchronous agent loop (`run_turn`) |
+| UHB | deterministic routing, fail-closed modes |
+
+**The CLI is universal.** UH makes no assumption about a specific vendor: it
+must drive any local or free provider (Ollama on `127.0.0.1:11434`, a local
+free router such as OmniRouter/Nemotron) and must never require an API key on
+first launch. A paid provider is an opt-in, never a prerequisite.
+
+The web UI will be **copied and adapted from Harness Maxxing**, not written from
+scratch and not vendored as a dependency.
+
+- Requires Python ≥ 3.10 (`tomli` is installed automatically on 3.10)
+- Single runtime dependency: `httpx`
+- Installable on its own: no dependency on `hermes-home-vision` or `uhb`
+
+## Install (development)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate      # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+uh --version
+uh doctor
+```
+
+## Roadmap — five milestones
+
+- [x] **Jalon 0 — Skeleton.** PyPI-installable package (`uh-harness`), `uh` CLI
+      surface, `uh --version`, `uh doctor` (python / httpx / git / ollama probe),
+      README, MIT license. No agent loop, no storage, no UI.
+- [x] **Jalon 1 — Agent core.** Synchronous `run_turn` loop, toolsets
+      (`file`, `terminal`, `memory`), in-memory message history, `uh chat`.
+      No persistence yet: a session lives only as long as the process.
+- [x] **Jalon 2 — Local model layer.** Streamed chat (`--no-stream` to disable),
+      real `uh model pull` with progress, provider registry (`ollama`,
+      `omnirouter`), traced fallback chain, `uh providers list`.
+- [x] **Jalon 3 — Sessions and configuration.** Persisted sessions backed by a
+      SQLite FTS5 store (`uh sessions list|show|search|delete|resume`), layered
+      configuration with `uh config show|get|set|path`, `uh memory migrate|show`,
+      extended `uh doctor`.
+- [x] **Jalon 4 — Console experience.** `uh` with no argument opens a chat
+      console: banner, status bar, slash commands (`docs/SLASH_COMMANDS.md`),
+      zero-configuration onboarding (local model, offer to pull one sized to the
+      RAM, local router, or a guided free key), `uh providers add|remove` with
+      keys in `$UH_HOME/keys.toml` (0600), UTF-8 stdio on Windows, CI matrix.
+- [x] **Jalon 5 — Web UI.** `uh web` serves a local interface (sessions column,
+      streaming chat, collapsible tool cards, context gauge, per-session model,
+      full-text search, command palette, stop button, light/dark themes) from
+      three static files with no build step and no third-party JavaScript.
+
+Jalons 0 to 5 are done. The interface is an **original design**: it borrows the
+feature list of Harness Maxxing (public README) and none of its code, which is
+under a Fair Source Licence. UH stays MIT.
+
+## CLI surface (Jalon 4)
+
+```
+uh                      # interactive console (piped: help, unchanged)
+uh --version            # print the version
+uh doctor               # environment report (python, httpx, git, ollama, store, disk, config, keys)
+uh model list           # list models served by Ollama, exit 1 if Ollama is down
+uh model pull <name>    # download a model with progress on stderr
+uh chat [prompt]        # agent loop with file/terminal/memory tools (streamed, saved)
+uh sessions list        # recent sessions (id, date, provider, messages, title)
+uh sessions show <id>   # one session and its messages
+uh sessions search <q>  # full-text search across every message
+uh sessions resume <id> # continue a session (--fork copies it into a new one)
+uh config show|get|set  # layered configuration
+uh memory migrate|show  # one-shot import of the flat memory file
+uh providers list       # registered providers and their state
+uh providers add <name> # store an OpenAI-compatible provider (key never printed)
+uh providers remove <name>
+```
+
+`uh chat` reads stdin or takes a prompt argument; `--once` (or any non-TTY
+stdin) answers one line and exits. Answers stream by default, `--no-stream`
+waits for the whole message. Conversations are persisted unless `--no-save`;
+`--session <id>` resumes (full id, unique prefix, or the short form shown by
+`uh sessions list`). Tool activity goes to stderr, the answer to stdout.
+
+## Web interface (optional)
+
+```
+pip install "uh-harness[web]"
+uh web                      # http://127.0.0.1:8765/?token=...
+uh web --port 9000 --no-open
+uh web --allow-terminal     # enable the shell toolset in the browser (off by default)
+```
+
+`uh web` without the extra prints the exact install command and exits 1. The
+core package stays on `httpx`; `fastapi`/`uvicorn` only exist in `[web]`.
+
+Security, because a local server is still a server:
+
+- binds `127.0.0.1`; any other `--host` prints a warning before starting;
+- a 43-character token is generated at startup, accepted once as `?token=` and
+  then kept in an `HttpOnly; SameSite=Strict` cookie; every `/api` route answers
+  401 without it (curl: `Authorization: Bearer <token>`);
+- `Host` and `Origin` are checked (DNS-rebinding / CSRF), no CORS is enabled;
+- strict CSP without `unsafe-inline`, so no inline script or style exists in the
+  HTML; `X-Frame-Options: DENY`;
+- the **terminal toolset is disabled** unless `--allow-terminal`; file tools stay
+  inside `--workspace`;
+- no provider key is ever returned by the API.
+
+Design notes and the feature-by-feature rationale live in
+[docs/WEB_DESIGN.md](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/docs/WEB_DESIGN.md).
+
+## Console and slash commands
+
+`uh` on a terminal starts the console; piped, it still prints help (scriptable
+unchanged). The status bar shows `provider · model · session · messages ·
+context estimate`. `/help` lists everything; the full inventory and the reason
+each Hermes command was kept or dropped lives in
+[docs/SLASH_COMMANDS.md](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/docs/SLASH_COMMANDS.md).
+
+`/help`, `/model`, `/provider`, `/tools`, `/clear`, `/new`, `/sessions`,
+`/resume`, `/history`, `/retry`, `/title`, `/status`, `/config`, `/doctor`,
+`/memory`, `/version`, `/exit` (aliases `/h`, `/?`, `/reset`, `/quit`, `/q`,
+`/v`). An unknown command is never sent to the model: it is refused with the
+closest match suggested.
+
+First run with nothing configured, in order: an installed Ollama model, else an
+offer to pull a small model sized to the detected RAM (size shown, never
+downloaded without a yes), else a local OmniRouter gateway, else a provider you
+already added, else a guided setup that explains where to get a free key and
+stores it in `$UH_HOME/keys.toml` (0600). UH ships **no key**: a published key
+is a stolen key.
+
+The console can use [rich](https://rich.readthedocs.io/) when installed
+(`pip install "uh-harness[ui]"`); without it, or off a TTY, everything falls
+back to plain text with the same output contract.
+
+```bash
+echo "list the python files here" | uh chat --once --model qwen3:8b --workspace .
+uh chat --session 1829-9474 "et ensuite ?"           # resume
+uh sessions search clavier                            # FTS5 across all messages
+uh memory migrate                                     # MEMORY.md -> one session, once
+```
+
+## Sessions, store and configuration
+
+- Store: `$UH_HOME/uh.db` (`~/.uh/uh.db`), schema v1, WAL, foreign keys ON.
+  Deleting a session cascades to its messages and to the FTS index.
+- Two tables (`sessions`, `messages`) plus an external-content FTS5 index kept
+  in sync by triggers; `search` returns a snippet and a `bm25` rank.
+- A database written by a newer build is refused (`StoreError`), never
+  downgraded silently. No FTS5 in the SQLite build means no store at all.
+- Configuration, lowest to highest: defaults, `~/.uh/config.toml`, `./uh.toml`,
+  `UH_*` environment, CLI flags. `uh config show` prints the source of every
+  value. Unknown keys warn and are ignored; the writer handles flat keys only
+  (booleans, integers, strings) and refuses anything else.
+- `uh memory migrate` copies `MEMORY.md` into a `kind=memory` session after
+  writing a timestamped `.bak`; it is idempotent and leaves the flat file in
+  place (the memory toolset still reads and writes it).
+
+## Providers and fallback
+
+| Provider | Transport | Endpoint | Streaming |
+| --- | --- | --- | --- |
+| `ollama` | httpx, NDJSON | `POST /api/chat`, `GET /api/tags`, `POST /api/pull` | yes |
+| `omnirouter` | httpx, SSE | `POST /v1/chat/completions` (OpenAI-compatible) | yes |
+
+Without `--provider`, `uh chat` builds the chain `ollama` then `omnirouter`
+(when configured). Every switch is printed on stderr, never silent:
+
+```
+fallback: ollama -> omnirouter (reason: cannot reach Ollama at ...)
+```
+
+`--provider <kind>` disables the fallback: one provider, its errors surface as
+they are. Model namespaces are not shared, so the backup uses
+`UH_OMNIROUTER_MODEL` (default `auto/best-free`) rather than the Ollama tag.
+
+## OmniRouter discovery (measured, not guessed)
+
+`uh doctor` and `uh providers list` find a local OmniRoute gateway from these
+sources, first hit wins:
+
+1. `UH_OMNIROUTER_URL` (explicit)
+2. `OMNIROUTE_BASE_URL` (the OmniRoute CLI's own variable)
+3. `BASE_URL=` in `~/.omniroute/.env`
+4. `http://{HOST}:{PORT}` from that dotenv (`PORT` defaults to 20128)
+5. otherwise: "not configured" - nothing is invented
+
+API key: `UH_OMNIROUTER_API_KEY`, then `OMNIROUTE_API_KEY`, then the same
+dotenv. The key is only ever sent as an `Authorization` header, never printed.
+
+What the installed gateway actually looks like (OmniRoute 3.8.52):
+
+- data dir `~/.omniroute`, configuration is a dotenv file plus a SQLite
+  database - **no YAML/TOML**, so UH needs no parser dependency;
+- server on `http://127.0.0.1:20128`, `GET /v1/models` and
+  `POST /v1/chat/completions` answer with a `Bearer` key (1632 model ids on the
+  machine this was measured on, including `auto/*` combos);
+- streaming is SSE (`data: {...}` chunks, `data: [DONE]` terminator).
+
+## License
+
+MIT — see [LICENSE](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/LICENSE).

uh_harness-0.6.0/README.md

@@ -0,0 +1,209 @@
+# UH — Universal Harness
+
+A provider-agnostic agent harness in Python. UH merges the ideas that worked in
+four prior projects:
+
+| Source | What UH takes from it |
+| --- | --- |
+| Harness Maxxing | web UX, organised sessions |
+| OpenClaw | the harness contract (toolsets, fail-closed modes) |
+| Hermes Agent | the synchronous agent loop (`run_turn`) |
+| UHB | deterministic routing, fail-closed modes |
+
+**The CLI is universal.** UH makes no assumption about a specific vendor: it
+must drive any local or free provider (Ollama on `127.0.0.1:11434`, a local
+free router such as OmniRouter/Nemotron) and must never require an API key on
+first launch. A paid provider is an opt-in, never a prerequisite.
+
+The web UI will be **copied and adapted from Harness Maxxing**, not written from
+scratch and not vendored as a dependency.
+
+- Requires Python ≥ 3.10 (`tomli` is installed automatically on 3.10)
+- Single runtime dependency: `httpx`
+- Installable on its own: no dependency on `hermes-home-vision` or `uhb`
+
+## Install (development)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate      # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+uh --version
+uh doctor
+```
+
+## Roadmap — five milestones
+
+- [x] **Jalon 0 — Skeleton.** PyPI-installable package (`uh-harness`), `uh` CLI
+      surface, `uh --version`, `uh doctor` (python / httpx / git / ollama probe),
+      README, MIT license. No agent loop, no storage, no UI.
+- [x] **Jalon 1 — Agent core.** Synchronous `run_turn` loop, toolsets
+      (`file`, `terminal`, `memory`), in-memory message history, `uh chat`.
+      No persistence yet: a session lives only as long as the process.
+- [x] **Jalon 2 — Local model layer.** Streamed chat (`--no-stream` to disable),
+      real `uh model pull` with progress, provider registry (`ollama`,
+      `omnirouter`), traced fallback chain, `uh providers list`.
+- [x] **Jalon 3 — Sessions and configuration.** Persisted sessions backed by a
+      SQLite FTS5 store (`uh sessions list|show|search|delete|resume`), layered
+      configuration with `uh config show|get|set|path`, `uh memory migrate|show`,
+      extended `uh doctor`.
+- [x] **Jalon 4 — Console experience.** `uh` with no argument opens a chat
+      console: banner, status bar, slash commands (`docs/SLASH_COMMANDS.md`),
+      zero-configuration onboarding (local model, offer to pull one sized to the
+      RAM, local router, or a guided free key), `uh providers add|remove` with
+      keys in `$UH_HOME/keys.toml` (0600), UTF-8 stdio on Windows, CI matrix.
+- [x] **Jalon 5 — Web UI.** `uh web` serves a local interface (sessions column,
+      streaming chat, collapsible tool cards, context gauge, per-session model,
+      full-text search, command palette, stop button, light/dark themes) from
+      three static files with no build step and no third-party JavaScript.
+
+Jalons 0 to 5 are done. The interface is an **original design**: it borrows the
+feature list of Harness Maxxing (public README) and none of its code, which is
+under a Fair Source Licence. UH stays MIT.
+
+## CLI surface (Jalon 4)
+
+```
+uh                      # interactive console (piped: help, unchanged)
+uh --version            # print the version
+uh doctor               # environment report (python, httpx, git, ollama, store, disk, config, keys)
+uh model list           # list models served by Ollama, exit 1 if Ollama is down
+uh model pull <name>    # download a model with progress on stderr
+uh chat [prompt]        # agent loop with file/terminal/memory tools (streamed, saved)
+uh sessions list        # recent sessions (id, date, provider, messages, title)
+uh sessions show <id>   # one session and its messages
+uh sessions search <q>  # full-text search across every message
+uh sessions resume <id> # continue a session (--fork copies it into a new one)
+uh config show|get|set  # layered configuration
+uh memory migrate|show  # one-shot import of the flat memory file
+uh providers list       # registered providers and their state
+uh providers add <name> # store an OpenAI-compatible provider (key never printed)
+uh providers remove <name>
+```
+
+`uh chat` reads stdin or takes a prompt argument; `--once` (or any non-TTY
+stdin) answers one line and exits. Answers stream by default, `--no-stream`
+waits for the whole message. Conversations are persisted unless `--no-save`;
+`--session <id>` resumes (full id, unique prefix, or the short form shown by
+`uh sessions list`). Tool activity goes to stderr, the answer to stdout.
+
+## Web interface (optional)
+
+```
+pip install "uh-harness[web]"
+uh web                      # http://127.0.0.1:8765/?token=...
+uh web --port 9000 --no-open
+uh web --allow-terminal     # enable the shell toolset in the browser (off by default)
+```
+
+`uh web` without the extra prints the exact install command and exits 1. The
+core package stays on `httpx`; `fastapi`/`uvicorn` only exist in `[web]`.
+
+Security, because a local server is still a server:
+
+- binds `127.0.0.1`; any other `--host` prints a warning before starting;
+- a 43-character token is generated at startup, accepted once as `?token=` and
+  then kept in an `HttpOnly; SameSite=Strict` cookie; every `/api` route answers
+  401 without it (curl: `Authorization: Bearer <token>`);
+- `Host` and `Origin` are checked (DNS-rebinding / CSRF), no CORS is enabled;
+- strict CSP without `unsafe-inline`, so no inline script or style exists in the
+  HTML; `X-Frame-Options: DENY`;
+- the **terminal toolset is disabled** unless `--allow-terminal`; file tools stay
+  inside `--workspace`;
+- no provider key is ever returned by the API.
+
+Design notes and the feature-by-feature rationale live in
+[docs/WEB_DESIGN.md](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/docs/WEB_DESIGN.md).
+
+## Console and slash commands
+
+`uh` on a terminal starts the console; piped, it still prints help (scriptable
+unchanged). The status bar shows `provider · model · session · messages ·
+context estimate`. `/help` lists everything; the full inventory and the reason
+each Hermes command was kept or dropped lives in
+[docs/SLASH_COMMANDS.md](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/docs/SLASH_COMMANDS.md).
+
+`/help`, `/model`, `/provider`, `/tools`, `/clear`, `/new`, `/sessions`,
+`/resume`, `/history`, `/retry`, `/title`, `/status`, `/config`, `/doctor`,
+`/memory`, `/version`, `/exit` (aliases `/h`, `/?`, `/reset`, `/quit`, `/q`,
+`/v`). An unknown command is never sent to the model: it is refused with the
+closest match suggested.
+
+First run with nothing configured, in order: an installed Ollama model, else an
+offer to pull a small model sized to the detected RAM (size shown, never
+downloaded without a yes), else a local OmniRouter gateway, else a provider you
+already added, else a guided setup that explains where to get a free key and
+stores it in `$UH_HOME/keys.toml` (0600). UH ships **no key**: a published key
+is a stolen key.
+
+The console can use [rich](https://rich.readthedocs.io/) when installed
+(`pip install "uh-harness[ui]"`); without it, or off a TTY, everything falls
+back to plain text with the same output contract.
+
+```bash
+echo "list the python files here" | uh chat --once --model qwen3:8b --workspace .
+uh chat --session 1829-9474 "et ensuite ?"           # resume
+uh sessions search clavier                            # FTS5 across all messages
+uh memory migrate                                     # MEMORY.md -> one session, once
+```
+
+## Sessions, store and configuration
+
+- Store: `$UH_HOME/uh.db` (`~/.uh/uh.db`), schema v1, WAL, foreign keys ON.
+  Deleting a session cascades to its messages and to the FTS index.
+- Two tables (`sessions`, `messages`) plus an external-content FTS5 index kept
+  in sync by triggers; `search` returns a snippet and a `bm25` rank.
+- A database written by a newer build is refused (`StoreError`), never
+  downgraded silently. No FTS5 in the SQLite build means no store at all.
+- Configuration, lowest to highest: defaults, `~/.uh/config.toml`, `./uh.toml`,
+  `UH_*` environment, CLI flags. `uh config show` prints the source of every
+  value. Unknown keys warn and are ignored; the writer handles flat keys only
+  (booleans, integers, strings) and refuses anything else.
+- `uh memory migrate` copies `MEMORY.md` into a `kind=memory` session after
+  writing a timestamped `.bak`; it is idempotent and leaves the flat file in
+  place (the memory toolset still reads and writes it).
+
+## Providers and fallback
+
+| Provider | Transport | Endpoint | Streaming |
+| --- | --- | --- | --- |
+| `ollama` | httpx, NDJSON | `POST /api/chat`, `GET /api/tags`, `POST /api/pull` | yes |
+| `omnirouter` | httpx, SSE | `POST /v1/chat/completions` (OpenAI-compatible) | yes |
+
+Without `--provider`, `uh chat` builds the chain `ollama` then `omnirouter`
+(when configured). Every switch is printed on stderr, never silent:
+
+```
+fallback: ollama -> omnirouter (reason: cannot reach Ollama at ...)
+```
+
+`--provider <kind>` disables the fallback: one provider, its errors surface as
+they are. Model namespaces are not shared, so the backup uses
+`UH_OMNIROUTER_MODEL` (default `auto/best-free`) rather than the Ollama tag.
+
+## OmniRouter discovery (measured, not guessed)
+
+`uh doctor` and `uh providers list` find a local OmniRoute gateway from these
+sources, first hit wins:
+
+1. `UH_OMNIROUTER_URL` (explicit)
+2. `OMNIROUTE_BASE_URL` (the OmniRoute CLI's own variable)
+3. `BASE_URL=` in `~/.omniroute/.env`
+4. `http://{HOST}:{PORT}` from that dotenv (`PORT` defaults to 20128)
+5. otherwise: "not configured" - nothing is invented
+
+API key: `UH_OMNIROUTER_API_KEY`, then `OMNIROUTE_API_KEY`, then the same
+dotenv. The key is only ever sent as an `Authorization` header, never printed.
+
+What the installed gateway actually looks like (OmniRoute 3.8.52):
+
+- data dir `~/.omniroute`, configuration is a dotenv file plus a SQLite
+  database - **no YAML/TOML**, so UH needs no parser dependency;
+- server on `http://127.0.0.1:20128`, `GET /v1/models` and
+  `POST /v1/chat/completions` answer with a `Bearer` key (1632 model ids on the
+  machine this was measured on, including `auto/*` combos);
+- streaming is SSE (`data: {...}` chunks, `data: [DONE]` terminator).
+
+## License
+
+MIT — see [LICENSE](https://github.com/Antoine-Thomas/UH-Universal-Harness/blob/main/LICENSE).

uh_harness-0.6.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "uh-harness"
+version = "0.6.0"
+description = "Universal Harness: a provider-agnostic agent harness with a local-first CLI, tool use and an optional web UI"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Thomas Leroyer" }]
+keywords = ["agent", "harness", "llm", "ollama", "cli", "local-first"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "httpx>=0.27",
+    # tomllib is stdlib from 3.11; on 3.10 the backport is pulled automatically.
+    'tomli>=2; python_version < "3.11"',
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "build>=1", "fastapi>=0.110", "uvicorn>=0.29"]
+ui = ["rich>=13"]
+web = ["fastapi>=0.110", "uvicorn>=0.29"]
+
+[project.scripts]
+uh = "uh.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Antoine-Thomas/UH-Universal-Harness"
+Source = "https://github.com/Antoine-Thomas/UH-Universal-Harness"
+Issues = "https://github.com/Antoine-Thomas/UH-Universal-Harness/issues"
+Documentation = "https://github.com/Antoine-Thomas/UH-Universal-Harness/tree/main/docs"
+Changelog = "https://github.com/Antoine-Thomas/UH-Universal-Harness/releases"
+
+[tool.setuptools.packages.find]
+include = ["uh*"]
+
+[tool.setuptools.package-data]
+"uh.web" = ["static/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

uh_harness-0.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+