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.
