llmops-agent
Reference Python agent for the LLMOps.Pro sovereign-AI substrate. Consumes the five MCP servers (nwc-mcp, nostr-ops-mcp, marketplace-mcp, albyhub-admin-mcp, paywall-mcp) and demonstrates the agent-pays-paid-MCP loop end-to-end.
Ollama-first, API-pluggable. Built on pydantic-ai — no LangChain. MIT.
v0.1 operational. All six CLI commands wired. Agent layer enforces a budget-and-audit safety pipeline on top of every MCP server's own safety stack. Self-paying research workflow runs end-to-end given a working LLM backend (Ollama / Anthropic / OpenAI). Full design at
../03-python-reference-agent-design.md.
Status
| Layer | State |
|---|---|
| Design doc | ✅ Done — ../03-python-reference-agent-design.md |
Package scaffold (uv init, pyproject.toml, ruff/mypy/pytest config) |
✅ Done |
config.py — env-driven Pydantic Settings |
✅ Done |
budget.py — persistent rolling-window tracker |
✅ Done |
audit.py — NDJSON writer |
✅ Done |
mcp_servers.py — MCPServerStdio launch + doctor probe |
✅ Done |
agent.py — Pydantic AI agent + process_tool_call middleware |
✅ Done |
workflows/research.py — self-paying research workflow |
✅ Done |
cli.py — typer entry-point with ask / doctor / budget / audit / config-print / version |
✅ Done |
| Live LLM smoke test against Ollama / Anthropic | ⏳ User-driven (needs the LLM backend running) |
Usage
# from this directory, with uv-installed venv
uv run llmops-agent --help
uv run llmops-agent version
uv run llmops-agent budget # snapshot, no LLM needed
uv run llmops-agent config-print # effective config, secrets masked
uv run llmops-agent doctor # ping each configured MCP server
uv run llmops-agent ask "What time is it?" # the main demo loop
uv run llmops-agent audit --tail 20 # recent audit entries
ask requires a working LLM backend. Default is Ollama at localhost:11434/v1 with model qwen3:8b. Override via LLMOPS_MODEL env var (e.g. anthropic:claude-haiku-4-5-20251001).
Dev loop
uv sync # install deps + dev deps into .venv
uv run ruff check # lint
uv run mypy # type check
uv run pytest # tests
Build wheel for distribution:
uv build
License
MIT — see LICENSE.
Contact
Built by LLMOps.Pro.
- NOSTR:
npub1hdg932jvwc3jdvkqywgqv0ue4nn60exrf92asy8mtazt3hjg7d2s2yw0nw - Lightning Address:
sovereigncitizens@getalby.com - Shopstr: shopstr.store/marketplace/SOVEREIGN_CITIZENS
1 maintainer
Release files for llmops-agent 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| llmops_agent-0.1.0.tar.gz | 19.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| llmops_agent-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:43.8 kB
Release files / llmops_agent-0.1.0.tar.gz
| Download URL | llmops_agent-0.1.0.tar.gz |
|---|---|
| Size | 19.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ca00458b0eed922493f11450aa6dc7e2337c4c080fb65a48ba5bb8ffecaaf36
|
|
BLAKE2b-256 checksum How to use checksums |
0e7a34c83ff744780bbd93c4bb0ce8fa542d0d4909d62e33a36780f257925449
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Kali GNU/Linux","version":"2026.2","id":"kali-rolling","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / llmops_agent-0.1.0-py3-none-any.whl
| Download URL | llmops_agent-0.1.0-py3-none-any.whl |
|---|---|
| Size | 24.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f03936baf31bd266078d12538f276bb7cb670a477a3303efc3a137b21fa31f52
|
|
BLAKE2b-256 checksum How to use checksums |
23112b4174dd00817f9dd470d4a4eb1aece149337e26f1a3ab15e9425dc7c9be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Kali GNU/Linux","version":"2026.2","id":"kali-rolling","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
