Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
30 changes: 0 additions & 30 deletions .claude-plugin/marketplace.json

This file was deleted.

12 changes: 0 additions & 12 deletions .cursor/rules/engram-continuity.mdc

This file was deleted.

70 changes: 69 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -122,5 +122,73 @@ pip-delete-this-directory.txt
# Node (dashboard)
node_modules/

# Rust build artifacts (engram-accel)
# Rust build artifacts (dhee-accel)
target/

# ============================================================
# Excluded from public repo — internal/experimental only
# ============================================================

# Experimental engram sub-packages
engram-bridge/
engram-bus/
engram-enterprise/
engram-failure/
engram-heartbeat/
engram-identity/
engram-metamemory/
engram-policy/
engram-procedural/
engram-prospective/
engram-reconsolidation/
engram-resilience/
engram-router/
engram-spawn/
engram-warroom/
engram-working/

# Internal apps
dashboard/
landing/

# Models & training artifacts (large binaries)
models/
notebooks/
kaggle_upload/

# Benchmark runs & datasets
runs/
data/

# Internal scripts & docs
scripts/
deep-research-report.md
launch-article.md
pitch-deck.md
start-bridge.sh

# Agent-specific config (not needed publicly)
CLAUDE.md
CURSOR.md
.claude-plugin/
.cursor/

# Root-level node (dashboard/landing dependencies)
/package.json
/package-lock.json

# Root-level ad-hoc test files
/test_*.py

# Temp caches
.pycache_tmp/

# Extra venvs
.venv-dhee/

# Internal benchmark docs in docs/ (keep only the logo)
docs/engram_benchmark_blind_sota_program.md
docs/longmemeval_active_memory_orchestration_plan_2026-02-23.md
docs/capture_screenshots.py
docs/screenshots/
docs/pdf/
14 changes: 7 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
# Repository Guidelines

## Project Structure & Module Organization
- `engram/` is the main package. Core logic lives in `engram/core/` (decay, echo, fusion, conflict), while the user-facing API and orchestration live in `engram/memory/`.
- Integrations are split by concern: `engram/llms/` (Gemini/OpenAI mocks), `engram/embeddings/`, `engram/vector_stores/`, and `engram/db/`.
- Configuration and utilities live in `engram/configs/` and `engram/utils/`.
- Entry points/examples: `engram/mcp_server.py` (MCP server) and `engram/example_agent.py`.
- Tests are simple pytest files in the repo root and package, e.g. `test_echomem.py`, `engram/test_quick.py`, `engram/test_no_api.py`.
- `dhee/` is the main package. Core logic lives in `dhee/core/` (decay, echo, fusion, conflict), while the user-facing API and orchestration live in `dhee/memory/`.
- Integrations are split by concern: `dhee/llms/` (Gemini/OpenAI mocks), `dhee/embeddings/`, `dhee/vector_stores/`, and `dhee/db/`.
- Configuration and utilities live in `dhee/configs/` and `dhee/utils/`.
- Entry points/examples: `dhee/mcp_server.py` (MCP server) and `dhee/example_agent.py`.
- Tests are simple pytest files in the repo root and package, e.g. `test_echomem.py`, `dhee/test_quick.py`, `dhee/test_no_api.py`.

## Build, Test, and Development Commands
- `pip install -e ".[dev]"` installs dev extras (pytest, pytest-asyncio).
- `pip install -e ".[gemini,qdrant]"` installs optional runtime dependencies for Gemini + Qdrant.
- `pytest` runs all tests discovered under `test_*.py`.
- `python -m engram.mcp_server` or `engram-mcp` runs the MCP server entry point.
- `python -m dhee.mcp_server` or `engram-mcp` runs the MCP server entry point.

## Coding Style & Naming Conventions
- Python 3.9+ codebase; follow PEP 8 with 4-space indentation.
Expand All @@ -20,7 +20,7 @@

## Testing Guidelines
- Test framework: `pytest` with `pytest-asyncio` for async cases.
- Name new tests `test_*.py` and place them in the repo root or within `engram/` alongside related modules.
- Name new tests `test_*.py` and place them in the repo root or within `dhee/` alongside related modules.
- Keep tests isolated from external services unless explicitly marked or documented.

## Commit & Pull Request Guidelines
Expand Down
28 changes: 0 additions & 28 deletions CLAUDE.md

This file was deleted.

28 changes: 0 additions & 28 deletions CURSOR.md

This file was deleted.

30 changes: 25 additions & 5 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -1,9 +1,29 @@
FROM python:3.11-slim

WORKDIR /app

# Copy project files
COPY pyproject.toml README.md ./
COPY engram/ engram/
RUN pip install --no-cache-dir ".[api]"
EXPOSE 8100
ENV ENGRAM_DATA_DIR=/data
COPY dhee/ ./dhee/
COPY dhee/ ./dhee/

# Install package — slim by default (no llama.cpp, no local models)
# Use: docker build --build-arg EXTRAS="openai,mcp" .
ARG EXTRAS="openai,mcp"
RUN pip install --no-cache-dir -e ".[$EXTRAS]"

# Create data directory
RUN mkdir -p /data/dhee

# Environment
ENV DHEE_DATA_DIR=/data/dhee
ENV PYTHONUNBUFFERED=1

# Health check
HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
CMD python -c "from dhee.core.buddhi import Buddhi; Buddhi(); print('ok')" || exit 1

VOLUME /data
CMD ["engram-api", "--host", "0.0.0.0", "--port", "8100"]

# Default: MCP server (4 tools)
CMD ["dhee-mcp"]
Loading
Loading