getbased-agent-stack 0.2.0__py3-none-any.whl

getbased_agent_stack/__init__.py

@@ -0,0 +1,8 @@
+"""getbased-agent-stack — meta-package binding getbased-mcp + getbased-rag.
+
+This package contains no tools of its own; it's a convenience installer
+plus a small CLI that proxies to the real binaries. Everything
+interesting lives in the sibling repos.
+"""
+
+__version__ = "0.1.0"

getbased_agent_stack/cli.py

@@ -0,0 +1,72 @@
+"""Thin CLI wrapper that proxies to getbased-rag's `lens` and getbased-mcp's
+runner. Kept minimal so users can still call `lens` / `getbased-mcp`
+directly — this exists only for discoverability ("what commands do I have
+after `pipx install getbased-agent-stack`?")."""
+from __future__ import annotations
+
+import sys
+
+
+HELP = """\
+getbased-stack — thin wrapper over the two binaries installed by this package.
+
+Real commands (use directly, they're also on your PATH):
+  lens                      — getbased-rag CLI (serve, ingest, stats, ...)
+  getbased-mcp              — getbased-mcp stdio server (spawned by agents)
+
+This wrapper only exists for discoverability:
+  getbased-stack serve      → lens serve
+  getbased-stack info       → lens info
+  getbased-stack version    → print the installed package versions
+
+Quick start:
+  1. `getbased-stack serve &`           start the RAG server
+  2. `lens ingest /path/to/papers`      index your docs
+  3. configure your MCP agent (Claude Code, Hermes) — see the README
+"""
+
+
+def main() -> int:
+    import getbased_agent_stack
+
+    argv = sys.argv[1:]
+    if not argv or argv[0] in ("-h", "--help", "help"):
+        print(HELP)
+        return 0
+
+    cmd, rest = argv[0], argv[1:]
+    if cmd == "version":
+        try:
+            import getbased_mcp  # noqa: F401
+            import lens  # noqa: F401
+            import importlib.metadata as md
+            print(f"getbased-agent-stack {getbased_agent_stack.__version__}")
+            try:
+                print(f"  getbased-mcp {md.version('getbased-mcp')}")
+            except md.PackageNotFoundError:
+                print("  getbased-mcp (not installed)")
+            try:
+                print(f"  getbased-rag {md.version('getbased-rag')}")
+            except md.PackageNotFoundError:
+                print("  getbased-rag (not installed)")
+            return 0
+        except ImportError as e:
+            print(f"Missing dependency: {e}", file=sys.stderr)
+            return 1
+
+    # Delegate to the lens CLI for everything else.
+    try:
+        from lens.cli import app as lens_app
+
+        sys.argv = ["lens"] + argv
+        lens_app()
+        return 0
+    except SystemExit as e:
+        return int(e.code or 0)
+    except ImportError:
+        print("getbased-rag not installed — install with `pipx install getbased-agent-stack[full]`", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

getbased_agent_stack-0.2.0.dist-info/METADATA

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: getbased-agent-stack
+Version: 0.2.0
+Summary: One-command install of the full getbased agent stack — getbased-mcp + getbased-rag + getbased-dashboard
+License-Expression: GPL-3.0-only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: getbased-mcp>=0.2.2
+Requires-Dist: getbased-rag>=0.6.1
+Requires-Dist: getbased-dashboard>=0.5.0
+Provides-Extra: full
+Requires-Dist: getbased-rag[full]>=0.6.1; extra == "full"
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: httpx>=0.27; extra == "test"
+Requires-Dist: pytest-timeout>=2.3; extra == "test"
+Dynamic: license-file
+
+# getbased-agent-stack
+
+Meta-package bundling the full [getbased](https://getbased.health) agent stack into one install: the MCP adapter, the RAG engine, the browser dashboard, a thin discovery CLI, a hardened systemd unit, and example configs for Claude Code + Hermes.
+
+Part of the [getbased-agents monorepo](https://github.com/elkimek/getbased-agents).
+
+## Install
+
+```bash
+pipx install "getbased-agent-stack[full]"
+```
+
+Pulls:
+
+- [`getbased-mcp`](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) — stdio MCP server that Claude Code / Hermes / OpenClaw spawn
+- [`getbased-rag`](https://github.com/elkimek/getbased-agents/tree/main/packages/rag) — local RAG knowledge server (FastAPI + Qdrant + MiniLM/BGE)
+- [`getbased-dashboard`](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard) — web UI for library management, MCP config generation, and agent-activity inspection
+- The `getbased-stack` discovery CLI
+- `[full]` extra: PDF/DOCX parsers + ONNX runtime for hardware-accelerated embeddings
+
+Total install: ~500 MB (the ML deps dominate). Smaller installs available — `pipx install getbased-mcp` (10 MB, agent only), `pipx install "getbased-rag[full]"` (RAG only), `pipx install getbased-dashboard` (UI + MCP; pulls rag if you want the Knowledge tab working).
+
+## Quickstart
+
+```bash
+# 1. Start the RAG server — local Qdrant DB + MiniLM embedder
+lens serve                               # blocks; serves on 127.0.0.1:8322
+lens key                                 # prints the bearer token
+
+# 2. Start the dashboard in another terminal
+getbased-dashboard serve                 # serves on 127.0.0.1:8323
+
+# 3. Open http://127.0.0.1:8323 in your browser, paste the lens key
+#    Create libraries, drag-drop files to ingest (live chunks/sec pill),
+#    run the MCP Test button to verify your agent path
+
+# 4. Wire the MCP into your AI client
+#    The dashboard's MCP tab generates paste-ready config blocks for
+#    Claude Desktop, Claude Code, Cursor, Cline, and Hermes.
+```
+
+Both the RAG server and the getbased PWA talk to the same `lens` instance — point the PWA at `http://127.0.0.1:8322` under **Settings → AI → Knowledge Base → External server** and the same corpus feeds the browser chat, the dashboard, and any MCP-connected agent.
+
+## Running as a systemd service
+
+```bash
+cp systemd/getbased-rag.service ~/.config/systemd/user/
+systemctl --user daemon-reload
+systemctl --user enable --now getbased-rag
+```
+
+The unit is hardened (`ProtectSystem=strict`, `NoNewPrivileges`, `RestrictAddressFamilies`, etc.); run `systemd-analyze security getbased-rag` to see the score.
+
+## Architecture
+
+```
+Claude Code / Hermes / OpenClaw          Browser
+        │ MCP (stdio)                       │ HTTP
+        ▼                                   ▼
+  getbased-mcp                       getbased-dashboard   (localhost:8323)
+   │        │                          │             │
+   │ HTTP   │ HTTP                     │ proxies     │ spawns stdio for Test
+   ▼        ▼                          ▼             ▼
+sync GW   getbased-rag  ◀──────────────┘       getbased-mcp
+          (localhost:8322)
+```
+
+The MCP holds no persistent state; it's a thin translator between MCP tool calls and two HTTP backends:
+
+- `sync.getbased.health/api/context` — read-only lab summary pushed by your PWA session (via Agent Access token)
+- `localhost:8322` (getbased-rag) — your local research library
+
+The dashboard is likewise stateless — it proxies rag for Knowledge operations, imports `getbased_mcp` to introspect env/config, and spawns the MCP binary on demand to verify it works.
+
+## Version compatibility
+
+| Stack | mcp | rag | dashboard | Protocol |
+|---|---|---|---|---|
+| 0.1.x | ≥0.2.0 | ≥0.1.0 | — | v1 (multi-library) |
+| 0.2.x | ≥0.2.2 | ≥0.6.0 | ≥0.5.0 | v1 (+ streaming ingest, per-library models) |
+
+Bump the meta's major when sibling protocols break; bump siblings freely for normal features.
+
+## Development
+
+This package is the meta — the interesting code lives in sibling packages. See the [monorepo root README](https://github.com/elkimek/getbased-agents#development) for workspace setup.
+
+The integration test (`tests/test_integration.py`) spins up `lens serve` in a subprocess, ingests a fixture, and exercises every MCP tool round-trip. Catches drift between the siblings the way the v1.21 catch-up drift would have been caught if the test existed then. The dashboard has its own test suite (`cd packages/dashboard && uv run pytest`) covering the proxy, modal logic, stdio probe, and activity-log handling.
+
+## Related docs
+
+- [packages/stack/CONTRIBUTING.md](CONTRIBUTING.md) — when to bump the meta vs a sibling
+- [packages/stack/SECURITY.md](SECURITY.md) — threat model, scope, sibling pointers
+
+## Licence
+
+GPL-3.0-only, matching the siblings.

getbased_agent_stack-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+getbased_agent_stack/__init__.py,sha256=LSo9NAptb9YiMiamzJLzIZTali0QS0bT8JU_975ddv4,281
+getbased_agent_stack/cli.py,sha256=IASj51V3gl0v9eebjuDwXfjZplqCBYlMWGCQwdGlNn4,2445
+getbased_agent_stack-0.2.0.dist-info/licenses/LICENSE,sha256=K-IjLWkez1gJQMrlqA5zgyw8vh19mDzk4hKM9Dslmts,1024
+getbased_agent_stack-0.2.0.dist-info/METADATA,sha256=4JFkTXngtk0Yhymmb6ZlUkzhQYzUzTFfVBxq9zhHBbo,5572
+getbased_agent_stack-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+getbased_agent_stack-0.2.0.dist-info/entry_points.txt,sha256=oIyVEEt9t6HuGncV_3y_6d0fjkY2PDOVQ2OEpyq2Q04,65
+getbased_agent_stack-0.2.0.dist-info/top_level.txt,sha256=NH7AGQBXKHxl7hzWSYDXOaIXCg_9GV3hIQbj8YR8XZQ,21
+getbased_agent_stack-0.2.0.dist-info/RECORD,,

getbased_agent_stack-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

getbased_agent_stack-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+getbased-stack = getbased_agent_stack.cli:main

getbased_agent_stack-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  For the full license text, see <https://www.gnu.org/licenses/gpl-3.0.txt>

getbased_agent_stack-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+getbased_agent_stack