remembra 0.1.0__tar.gz

remembra-0.1.0/.gitignore

@@ -0,0 +1,61 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+
+# Type checking
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Docker volumes (local dev)
+.qdrant_data/
+.postgres_data/
+
+# Logs
+*.log
+logs/
+
+# Distribution
+*.tar.gz
+*.whl

remembra-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DolphyTech
+
+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.

remembra-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: remembra
+Version: 0.1.0
+Summary: Universal memory layer for AI applications. Self-host in 5 minutes.
+Project-URL: Homepage, https://github.com/AskDolphy/remembra
+Project-URL: Documentation, https://github.com/AskDolphy/remembra#readme
+Project-URL: Repository, https://github.com/AskDolphy/remembra.git
+Project-URL: Issues, https://github.com/AskDolphy/remembra/issues
+Project-URL: Changelog, https://github.com/AskDolphy/remembra/blob/main/CHANGELOG.md
+Author-email: DolphyTech <admin@dolphytech.com>
+Maintainer-email: Damany Williams <admin@dolphytech.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,chatbot,embeddings,langchain,llm,memory,openai,rag,vector-search
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: all
+Requires-Dist: aiosqlite>=0.20.0; extra == 'all'
+Requires-Dist: fastapi>=0.115.0; extra == 'all'
+Requires-Dist: openai>=1.0.0; extra == 'all'
+Requires-Dist: pydantic-settings>=2.6.0; extra == 'all'
+Requires-Dist: pydantic>=2.9.0; extra == 'all'
+Requires-Dist: python-ulid>=3.0.0; extra == 'all'
+Requires-Dist: qdrant-client<2.0.0,>=1.12.0; extra == 'all'
+Requires-Dist: structlog>=24.4.0; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: aiosqlite>=0.20.0; extra == 'server'
+Requires-Dist: fastapi>=0.115.0; extra == 'server'
+Requires-Dist: openai>=1.0.0; extra == 'server'
+Requires-Dist: pydantic-settings>=2.6.0; extra == 'server'
+Requires-Dist: pydantic>=2.9.0; extra == 'server'
+Requires-Dist: python-ulid>=3.0.0; extra == 'server'
+Requires-Dist: qdrant-client<2.0.0,>=1.12.0; extra == 'server'
+Requires-Dist: structlog>=24.4.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# Remembra - AI Memory Layer
+
+> Persistent memory for AI applications. Self-host in 5 minutes.
+
+## What Is This?
+
+Remembra is a universal memory layer for LLMs. It solves the fundamental problem that every AI forgets everything between sessions.
+
+```python
+from remembra import Memory
+
+memory = Memory(user_id="user_123")
+
+# Store memories
+memory.store("User prefers dark mode and works at Acme Corp")
+
+# Recall with context
+context = memory.recall("What are user's preferences?")
+# Returns: "User prefers dark mode. Works at Acme Corp."
+```
+
+## Why We're Building This
+
+### The Problem
+Every AI app needs memory. Developers hack together solutions using vector databases, embeddings, and custom retrieval logic. It's complex, fragmented, and everyone rebuilds the same thing.
+
+### Current Solutions Suck
+- **Mem0**: $24M raised, but self-hosting docs are trash, pricing jumps from $19 to $249
+- **Zep**: Academic, complex to deploy
+- **Letta**: Not production-ready
+- **LangChain Memory**: Too basic, no persistence
+
+### Our Approach
+- **Self-host in 5 minutes**: One Docker command, everything bundled
+- **Fair pricing**: $0 → $29 → $99 (not $19 → $249)
+- **Open source core**: MIT license, own your data
+- **Actually works**: Built because we need it ourselves (Clawdbot)
+
+## Core Features
+
+### 1. Simple Memory Operations
+- `store()` - Save memories with automatic extraction
+- `recall()` - Semantic search with context
+- `update()` - Intelligent merging
+- `forget()` - GDPR-compliant deletion
+
+### 2. Entity Resolution (Our Killer Feature)
+Knows that "Adam", "Adam Smith", "Mr. Smith", and "my husband" are the same person.
+
+### 3. Temporal Awareness
+Memories have time context. TTL support. Historical queries.
+
+### 4. Hybrid Storage
+Vector (semantic) + Graph (relationships) + Relational (metadata) in one system.
+
+### 5. Observability Dashboard
+See what's stored, debug retrievals, visualize entity graphs.
+
+## Quick Start
+
+### Self-Hosted (Recommended)
+```bash
+docker run -d -p 8787:8787 remembra/remembra
+```
+
+### Python SDK
+```bash
+pip install remembra
+```
+
+```python
+from remembra import Memory
+
+# Connect to local instance
+memory = Memory(
+    base_url="http://localhost:8787",
+    user_id="user_123",
+    project="my_app"
+)
+
+# Store
+memory.store("User's name is John. He's a software engineer at Google.")
+
+# Recall
+context = memory.recall("Who is the user?")
+print(context)
+# "John is a software engineer at Google."
+```
+
+## Documentation
+
+- [Product Spec](./PRODUCT-SPEC.md) - Full product specification
+- [Build Plan](./BUILD-PLAN.md) - Week-by-week development plan
+- [Architecture](./ARCHITECTURE.md) - Technical architecture details
+- [API Reference](./API.md) - API documentation
+
+## Project Status
+
+🚧 **In Development** - MVP target: 12 weeks
+
+## License
+
+MIT License - Use it however you want.
+
+---
+
+Built by [DolphyTech](https://dolphytech.com)

remembra-0.1.0/README.md

@@ -0,0 +1,107 @@
+# Remembra - AI Memory Layer
+
+> Persistent memory for AI applications. Self-host in 5 minutes.
+
+## What Is This?
+
+Remembra is a universal memory layer for LLMs. It solves the fundamental problem that every AI forgets everything between sessions.
+
+```python
+from remembra import Memory
+
+memory = Memory(user_id="user_123")
+
+# Store memories
+memory.store("User prefers dark mode and works at Acme Corp")
+
+# Recall with context
+context = memory.recall("What are user's preferences?")
+# Returns: "User prefers dark mode. Works at Acme Corp."
+```
+
+## Why We're Building This
+
+### The Problem
+Every AI app needs memory. Developers hack together solutions using vector databases, embeddings, and custom retrieval logic. It's complex, fragmented, and everyone rebuilds the same thing.
+
+### Current Solutions Suck
+- **Mem0**: $24M raised, but self-hosting docs are trash, pricing jumps from $19 to $249
+- **Zep**: Academic, complex to deploy
+- **Letta**: Not production-ready
+- **LangChain Memory**: Too basic, no persistence
+
+### Our Approach
+- **Self-host in 5 minutes**: One Docker command, everything bundled
+- **Fair pricing**: $0 → $29 → $99 (not $19 → $249)
+- **Open source core**: MIT license, own your data
+- **Actually works**: Built because we need it ourselves (Clawdbot)
+
+## Core Features
+
+### 1. Simple Memory Operations
+- `store()` - Save memories with automatic extraction
+- `recall()` - Semantic search with context
+- `update()` - Intelligent merging
+- `forget()` - GDPR-compliant deletion
+
+### 2. Entity Resolution (Our Killer Feature)
+Knows that "Adam", "Adam Smith", "Mr. Smith", and "my husband" are the same person.
+
+### 3. Temporal Awareness
+Memories have time context. TTL support. Historical queries.
+
+### 4. Hybrid Storage
+Vector (semantic) + Graph (relationships) + Relational (metadata) in one system.
+
+### 5. Observability Dashboard
+See what's stored, debug retrievals, visualize entity graphs.
+
+## Quick Start
+
+### Self-Hosted (Recommended)
+```bash
+docker run -d -p 8787:8787 remembra/remembra
+```
+
+### Python SDK
+```bash
+pip install remembra
+```
+
+```python
+from remembra import Memory
+
+# Connect to local instance
+memory = Memory(
+    base_url="http://localhost:8787",
+    user_id="user_123",
+    project="my_app"
+)
+
+# Store
+memory.store("User's name is John. He's a software engineer at Google.")
+
+# Recall
+context = memory.recall("Who is the user?")
+print(context)
+# "John is a software engineer at Google."
+```
+
+## Documentation
+
+- [Product Spec](./PRODUCT-SPEC.md) - Full product specification
+- [Build Plan](./BUILD-PLAN.md) - Week-by-week development plan
+- [Architecture](./ARCHITECTURE.md) - Technical architecture details
+- [API Reference](./API.md) - API documentation
+
+## Project Status
+
+🚧 **In Development** - MVP target: 12 weeks
+
+## License
+
+MIT License - Use it however you want.
+
+---
+
+Built by [DolphyTech](https://dolphytech.com)

remembra-0.1.0/pyproject.toml

@@ -0,0 +1,142 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "remembra"
+version = "0.1.0"
+description = "Universal memory layer for AI applications. Self-host in 5 minutes."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "DolphyTech", email = "admin@dolphytech.com" },
+]
+maintainers = [
+    { name = "Damany Williams", email = "admin@dolphytech.com" },
+]
+keywords = [
+    "ai",
+    "memory",
+    "llm",
+    "rag",
+    "vector-search",
+    "embeddings",
+    "chatbot",
+    "agent",
+    "langchain",
+    "openai",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+# Core SDK only needs httpx
+dependencies = [
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+# Full server dependencies
+server = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "pydantic>=2.9.0",
+    "pydantic-settings>=2.6.0",
+    "qdrant-client>=1.12.0,<2.0.0",
+    "python-ulid>=3.0.0",
+    "structlog>=24.4.0",
+    "aiosqlite>=0.20.0",
+    "openai>=1.0.0",
+]
+
+# Development dependencies
+dev = [
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.8.0",
+    "mypy>=1.13.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
+# All dependencies (SDK + Server)
+all = [
+    "remembra[server]",
+]
+
+[project.urls]
+Homepage = "https://github.com/AskDolphy/remembra"
+Documentation = "https://github.com/AskDolphy/remembra#readme"
+Repository = "https://github.com/AskDolphy/remembra.git"
+Issues = "https://github.com/AskDolphy/remembra/issues"
+Changelog = "https://github.com/AskDolphy/remembra/blob/main/CHANGELOG.md"
+
+[project.scripts]
+remembra = "remembra.main:run"
+remembra-server = "remembra.main:run"
+
+# ---------------------------------------------------------------------------
+# Hatch build config
+# ---------------------------------------------------------------------------
+[tool.hatch.build.targets.wheel]
+packages = ["src/remembra"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]
+
+# ---------------------------------------------------------------------------
+# Ruff
+# ---------------------------------------------------------------------------
+[tool.ruff]
+src = ["src"]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "ANN"]
+ignore = ["ANN101", "ANN102", "ANN401"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["remembra"]
+
+# ---------------------------------------------------------------------------
+# Mypy
+# ---------------------------------------------------------------------------
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src/remembra"]
+plugins = ["pydantic.mypy"]
+
+[[tool.mypy.overrides]]
+module = ["qdrant_client.*", "structlog.*"]
+ignore_missing_imports = true
+
+# ---------------------------------------------------------------------------
+# Pytest
+# ---------------------------------------------------------------------------
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = ["--cov=remembra", "--cov-report=term-missing", "--cov-report=xml"]
+
+[tool.coverage.run]
+source = ["src/remembra"]
+omit = ["*/tests/*"]

remembra-0.1.0/src/remembra/__init__.py

@@ -0,0 +1,44 @@
+"""
+Remembra – Universal memory layer for AI applications.
+
+Quick Start:
+    from remembra import Memory
+    
+    memory = Memory(
+        base_url="http://localhost:8787",
+        user_id="user_123"
+    )
+    
+    # Store
+    memory.store("John works at Acme Corp as CTO")
+    
+    # Recall
+    result = memory.recall("Where does John work?")
+    print(result.context)  # "John works at Acme Corp as CTO."
+"""
+
+__version__ = "0.1.0"
+
+# SDK exports (client-side)
+from remembra.client.memory import Memory, MemoryError
+from remembra.client.types import (
+    EntityItem,
+    ForgetResult,
+    MemoryItem,
+    RecallResult,
+    StoreResult,
+)
+
+__all__ = [
+    # Core
+    "Memory",
+    "MemoryError",
+    # Types
+    "StoreResult",
+    "RecallResult",
+    "ForgetResult",
+    "MemoryItem",
+    "EntityItem",
+    # Metadata
+    "__version__",
+]

remembra-0.1.0/src/remembra/api/__init__.py

@@ -0,0 +1 @@
+"""API layer – versioned routers."""

remembra-0.1.0/src/remembra/api/router.py

@@ -0,0 +1,8 @@
+"""Aggregate all versioned routers."""
+
+from fastapi import APIRouter
+
+from remembra.api.v1 import memories
+
+api_router = APIRouter(prefix="/api")
+api_router.include_router(memories.router, prefix="/v1")

remembra-0.1.0/src/remembra/api/v1/__init__.py

@@ -0,0 +1 @@
+"""API v1 routers."""