hipp0-memory 0.1.0__tar.gz

hipp0_memory-0.1.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: hipp0-memory
+Version: 0.1.0
+Summary: Official Python SDK for the Hipp0 multi-agent memory and decision platform.
+Author: Perlantir
+License: MIT
+Project-URL: Homepage, https://github.com/perlantir/Hipp0
+Project-URL: Documentation, https://github.com/perlantir/Hipp0
+Project-URL: Repository, https://github.com/perlantir/Hipp0
+Keywords: hipp0,multi-agent,memory,decisions,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+
+# hipp0-sdk
+
+Official Python SDK for the [Hipp0](https://github.com/perlantir/Hipp0) multi-agent memory and decision platform.
+
+## Installation
+
+```bash
+pip install hipp0-sdk
+```
+
+Or for local development:
+
+```bash
+cd python-sdk
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from hipp0_sdk import Hipp0Client
+
+client = Hipp0Client(base_url="http://localhost:3100", api_key="my-key")
+
+# Create a project
+project = client.create_project("My Project", "A demonstration project")
+
+# Register an agent
+agent = client.create_agent(
+    project_id=project["id"],
+    name="architect-agent",
+    role="architect",
+    capabilities=["design", "review"],
+)
+
+# Record a decision
+decision = client.create_decision(
+    project_id=project["id"],
+    title="Use PostgreSQL",
+    description="All persistent data will be stored in PostgreSQL.",
+    reasoning="Team expertise and strong JSONB support.",
+    made_by="architect-agent",
+    tags=["database", "infrastructure"],
+)
+
+# Compile context for another agent
+context = client.compile_context(
+    project_id=project["id"],
+    agent_name="coder-agent",
+    task_description="Implement user authentication service.",
+    max_tokens=4096,
+)
+print(context["compiled_text"])
+
+# Send a conversation to the distillery
+result = client.distill(
+    project_id=project["id"],
+    conversation_text="...<full chat log>...",
+    agent_name="coder-agent",
+)
+print(f"Extracted {len(result['decisions_created'])} decisions")
+```
+
+## API Reference
+
+See the inline docstrings in `hipp0_sdk/client.py` for the full API surface.

hipp0_memory-0.1.0/README.md

@@ -0,0 +1,66 @@
+# hipp0-sdk
+
+Official Python SDK for the [Hipp0](https://github.com/perlantir/Hipp0) multi-agent memory and decision platform.
+
+## Installation
+
+```bash
+pip install hipp0-sdk
+```
+
+Or for local development:
+
+```bash
+cd python-sdk
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from hipp0_sdk import Hipp0Client
+
+client = Hipp0Client(base_url="http://localhost:3100", api_key="my-key")
+
+# Create a project
+project = client.create_project("My Project", "A demonstration project")
+
+# Register an agent
+agent = client.create_agent(
+    project_id=project["id"],
+    name="architect-agent",
+    role="architect",
+    capabilities=["design", "review"],
+)
+
+# Record a decision
+decision = client.create_decision(
+    project_id=project["id"],
+    title="Use PostgreSQL",
+    description="All persistent data will be stored in PostgreSQL.",
+    reasoning="Team expertise and strong JSONB support.",
+    made_by="architect-agent",
+    tags=["database", "infrastructure"],
+)
+
+# Compile context for another agent
+context = client.compile_context(
+    project_id=project["id"],
+    agent_name="coder-agent",
+    task_description="Implement user authentication service.",
+    max_tokens=4096,
+)
+print(context["compiled_text"])
+
+# Send a conversation to the distillery
+result = client.distill(
+    project_id=project["id"],
+    conversation_text="...<full chat log>...",
+    agent_name="coder-agent",
+)
+print(f"Extracted {len(result['decisions_created'])} decisions")
+```
+
+## API Reference
+
+See the inline docstrings in `hipp0_sdk/client.py` for the full API surface.

hipp0_memory-0.1.0/hipp0_memory/__init__.py

@@ -0,0 +1,23 @@
+"""Hipp0 Memory — zero-config decision memory for multi-agent teams."""
+
+from hipp0_sdk.client import Hipp0Client
+from .server import Hipp0Server
+
+_server = None
+
+def init(db_path="./hipp0.db", port=3100):
+    """Start Hipp0 with zero config. One line."""
+    global _server
+    _server = Hipp0Server(db_path=db_path, port=port)
+    _server.start()
+    return Hipp0Client(
+        base_url=f"http://localhost:{port}",
+        api_key=_server.api_key
+    )
+
+def stop():
+    """Stop the running Hipp0 server."""
+    global _server
+    if _server:
+        _server.stop()
+        _server = None

hipp0_memory-0.1.0/hipp0_memory/cli.py

@@ -0,0 +1,41 @@
+"""CLI entry point for hipp0-memory."""
+
+import argparse
+import sys
+
+def main():
+    parser = argparse.ArgumentParser(prog="hipp0-memory", description="Hipp0 decision memory server")
+    subparsers = parser.add_subparsers(dest="command")
+    
+    init_parser = subparsers.add_parser("init", help="Initialize a new Hipp0 project")
+    init_parser.add_argument("name", nargs="?", default=".", help="Project directory name")
+    init_parser.add_argument("--port", type=int, default=3100, help="Server port")
+    
+    subparsers.add_parser("start", help="Start the Hipp0 server")
+    subparsers.add_parser("stop", help="Stop the Hipp0 server")
+    
+    args = parser.parse_args()
+    
+    if args.command == "init":
+        from .server import Hipp0Server
+        server = Hipp0Server(port=args.port)
+        print(f"Starting Hipp0 in {args.name}...")
+        server.start()
+        print(f"Hipp0 is running on http://localhost:{args.port}")
+        print(f"API Key: {server.api_key}")
+        try:
+            server._process.wait()
+        except KeyboardInterrupt:
+            server.stop()
+    elif args.command == "start":
+        from .server import Hipp0Server
+        server = Hipp0Server()
+        server.start()
+        print(f"Hipp0 started on http://localhost:{server.port}")
+    elif args.command == "stop":
+        print("Stop not implemented — use Ctrl+C on the running process")
+    else:
+        parser.print_help()
+
+if __name__ == "__main__":
+    main()

hipp0_memory-0.1.0/hipp0_memory/server.py

@@ -0,0 +1,93 @@
+"""Manages the Hipp0 Node.js server process."""
+
+import subprocess
+import platform
+import time
+import os
+import secrets
+from pathlib import Path
+
+class Hipp0Server:
+    def __init__(self, db_path="./hipp0.db", port=3100):
+        self.db_path = str(Path(db_path).resolve())
+        self.port = port
+        self.api_key = os.environ.get("DECIGRAPH_API_KEY", f"nx_{secrets.token_hex(20)}")
+        self._process = None
+
+    def start(self):
+        binary = self._get_binary_path()
+        if not binary:
+            raise RuntimeError(
+                "Hipp0 server binary not found. "
+                "Install Node.js and run: npx @hipp0/cli start"
+            )
+        env = {
+            **os.environ,
+            "DECIGRAPH_DB_PATH": self.db_path,
+            "PORT": str(self.port),
+            "DECIGRAPH_API_KEY": self.api_key,
+        }
+        self._process = subprocess.Popen(
+            [str(binary), "start"],
+            env=env,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+        )
+        self._wait_for_health()
+        return self
+
+    def stop(self):
+        if self._process:
+            self._process.terminate()
+            try:
+                self._process.wait(timeout=10)
+            except subprocess.TimeoutExpired:
+                self._process.kill()
+            self._process = None
+
+    def _get_binary_path(self):
+        system = platform.system().lower()
+        machine = platform.machine().lower()
+        if "arm" in machine or "aarch64" in machine:
+            arch = "arm64"
+        else:
+            arch = "x64"
+        
+        name = f"hipp0-{system}-{arch}"
+        if system == "windows":
+            name += ".exe"
+        
+        # Check bundled binaries
+        bin_dir = Path(__file__).parent / "bin"
+        binary = bin_dir / name
+        if binary.exists():
+            return binary
+        
+        # Fall back to npx
+        import shutil
+        npx = shutil.which("npx")
+        if npx:
+            return None  # Caller should use npx @hipp0/cli start instead
+        
+        return None
+
+    def _wait_for_health(self, timeout=30):
+        import urllib.request
+        start = time.time()
+        while time.time() - start < timeout:
+            try:
+                req = urllib.request.urlopen(
+                    f"http://localhost:{self.port}/api/health"
+                )
+                if req.status == 200:
+                    return
+            except Exception:
+                time.sleep(0.5)
+        raise TimeoutError("Hipp0 server did not start within timeout")
+    
+    def __enter__(self):
+        self.start()
+        return self
+    
+    def __exit__(self, *args):
+        self.stop()

hipp0_memory-0.1.0/hipp0_memory.egg-info/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: hipp0-memory
+Version: 0.1.0
+Summary: Official Python SDK for the Hipp0 multi-agent memory and decision platform.
+Author: Perlantir
+License: MIT
+Project-URL: Homepage, https://github.com/perlantir/Hipp0
+Project-URL: Documentation, https://github.com/perlantir/Hipp0
+Project-URL: Repository, https://github.com/perlantir/Hipp0
+Keywords: hipp0,multi-agent,memory,decisions,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+
+# hipp0-sdk
+
+Official Python SDK for the [Hipp0](https://github.com/perlantir/Hipp0) multi-agent memory and decision platform.
+
+## Installation
+
+```bash
+pip install hipp0-sdk
+```
+
+Or for local development:
+
+```bash
+cd python-sdk
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from hipp0_sdk import Hipp0Client
+
+client = Hipp0Client(base_url="http://localhost:3100", api_key="my-key")
+
+# Create a project
+project = client.create_project("My Project", "A demonstration project")
+
+# Register an agent
+agent = client.create_agent(
+    project_id=project["id"],
+    name="architect-agent",
+    role="architect",
+    capabilities=["design", "review"],
+)
+
+# Record a decision
+decision = client.create_decision(
+    project_id=project["id"],
+    title="Use PostgreSQL",
+    description="All persistent data will be stored in PostgreSQL.",
+    reasoning="Team expertise and strong JSONB support.",
+    made_by="architect-agent",
+    tags=["database", "infrastructure"],
+)
+
+# Compile context for another agent
+context = client.compile_context(
+    project_id=project["id"],
+    agent_name="coder-agent",
+    task_description="Implement user authentication service.",
+    max_tokens=4096,
+)
+print(context["compiled_text"])
+
+# Send a conversation to the distillery
+result = client.distill(
+    project_id=project["id"],
+    conversation_text="...<full chat log>...",
+    agent_name="coder-agent",
+)
+print(f"Extracted {len(result['decisions_created'])} decisions")
+```
+
+## API Reference
+
+See the inline docstrings in `hipp0_sdk/client.py` for the full API surface.

hipp0_memory-0.1.0/hipp0_memory.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+setup.py
+hipp0_memory/__init__.py
+hipp0_memory/cli.py
+hipp0_memory/server.py
+hipp0_memory.egg-info/PKG-INFO
+hipp0_memory.egg-info/SOURCES.txt
+hipp0_memory.egg-info/dependency_links.txt
+hipp0_memory.egg-info/entry_points.txt
+hipp0_memory.egg-info/requires.txt
+hipp0_memory.egg-info/top_level.txt
+hipp0_sdk/__init__.py
+hipp0_sdk/client.py
+hipp0_sdk/exceptions.py
+hipp0_sdk/types.py

hipp0_memory-0.1.0/hipp0_memory.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hipp0_memory-0.1.0/hipp0_memory.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hipp0-memory = hipp0_memory.cli:main

hipp0_memory-0.1.0/hipp0_memory.egg-info/requires.txt

@@ -0,0 +1,8 @@
+requests>=2.28.0
+
+[dev]
+pytest>=7.0
+pytest-cov
+responses>=0.23
+mypy>=1.0
+ruff>=0.4

hipp0_memory-0.1.0/hipp0_memory.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+hipp0_memory
+hipp0_sdk

hipp0_memory-0.1.0/hipp0_sdk/__init__.py

@@ -0,0 +1,80 @@
+"""
+hipp0-sdk
+=========
+Official Python SDK for the Hipp0 multi-agent memory and decision platform.
+
+Quick start::
+
+    from hipp0_sdk import Hipp0Client
+
+    client = Hipp0Client(base_url="http://localhost:3100", api_key="my-key")
+
+    project = client.create_project("My Project")
+    decision = client.create_decision(
+        project_id=project["id"],
+        title="Use PostgreSQL",
+        description="Primary data store will be PostgreSQL.",
+        reasoning="Team expertise and excellent JSONB support.",
+        made_by="architect-agent",
+    )
+    context = client.compile_context(
+        project_id=project["id"],
+        agent_name="coder-agent",
+        task_description="Implement the user authentication service.",
+    )
+"""
+
+from .client import Hipp0Client
+from .exceptions import (
+    Hipp0ApiError,
+    Hipp0AuthError,
+    Hipp0ConnectionError,
+    Hipp0Error,
+    Hipp0NotFoundError,
+    Hipp0ValidationError,
+)
+from .types import (
+    Agent,
+    Artifact,
+    ContextPackage,
+    Contradiction,
+    Decision,
+    DecisionEdge,
+    DistilleryResult,
+    FeedbackRecord,
+    GraphResult,
+    ImpactAnalysis,
+    Notification,
+    Project,
+    SessionSummary,
+    Subscription,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Client
+    "Hipp0Client",
+    # Exceptions
+    "Hipp0Error",
+    "Hipp0ApiError",
+    "Hipp0NotFoundError",
+    "Hipp0AuthError",
+    "Hipp0ValidationError",
+    "Hipp0ConnectionError",
+    # Types
+    "Project",
+    "Agent",
+    "Decision",
+    "DecisionEdge",
+    "GraphResult",
+    "Artifact",
+    "SessionSummary",
+    "Notification",
+    "Subscription",
+    "Contradiction",
+    "ContextPackage",
+    "DistilleryResult",
+    "ImpactAnalysis",
+    "FeedbackRecord",
+]