feat: add agentmemory docker setup

Author: aksOps

.github/workflows/publish-image.yml

@@ -0,0 +1,39 @@
+name: Publish image
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+env:
+  IMAGE_NAME: ghcr.io/${{ github.repository_owner }}/agentmemory-setup
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/metadata-action@v5
+        id: meta
+        with:
+          images: ${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=sha,prefix=
+            type=ref,event=tag
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.gitignore

@@ -0,0 +1,5 @@
+.env
+credentials.json
+agentmemory-home/
+docker-compose.yml
+iii-config.docker.yaml

Dockerfile

@@ -0,0 +1,20 @@
+FROM node:22-bookworm-slim
+
+ARG AGENTMEMORY_VERSION=0.9.27
+
+LABEL org.opencontainers.image.source="https://github.com/RandomCodeSpace/agentmemory-setup"
+LABEL org.opencontainers.image.description="AgentMemory worker for Rust iii-engine Docker setup"
+
+RUN npm install -g "@agentmemory/agentmemory@${AGENTMEMORY_VERSION}" \
+  && npm cache clean --force \
+  && printf '%s\n' \
+    '#!/bin/sh' \
+    'set -eu' \
+    'node -e "const base=(process.env.AGENTMEMORY_URL||\"http://127.0.0.1:3111\").replace(/\\/$/, \"\"); const wait=ms=>new Promise(r=>setTimeout(r,ms)); (async()=>{for(let i=0;i<120;i++){try{const r=await fetch(base+\"/\",{signal:AbortSignal.timeout(2000)}); if(r.status<500) process.exit(0)}catch{} await wait(1000)} console.error(\"iii-engine did not become ready at \"+base); process.exit(1)})()"' \
+    'exec agentmemory --no-engine' \
+    > /usr/local/bin/agentmemory-entrypoint \
+  && chmod +x /usr/local/bin/agentmemory-entrypoint
+
+ENV NODE_ENV=production
+
+CMD ["agentmemory-entrypoint"]

README.md

@@ -0,0 +1,58 @@
+# agentmemory-setup
+
+Docker setup for AgentMemory with Rust `iii-engine` (`iiidev/iii`), OpenAI-compatible LLM config, local embeddings, persistent storage, and CPU/RAM limits.
+
+## Quick Start
+
+```bash
+./setup.sh \
+  --base-url https://ollama.com \
+  --api-key "$OLLAMA_API_KEY" \
+  --model deepseek-v4-flash \
+  --domain agent-mem.randomcodespace.dev
+```
+
+Defaults:
+
+- AgentMemory worker: `2g`, `2` CPUs
+- Rust iii-engine: `512m`, `1` CPU
+- Persistent Rust iii-engine state: `/opt/agentmemory/iii-data`
+- Persistent AgentMemory home: `/opt/agentmemory/agentmemory-home`
+- Caddy auth username: `admin`
+- Caddy auth password path: `/opt/agentmemory/credentials.json`
+
+## Options
+
+```bash
+./setup.sh --help
+```
+
+Useful overrides:
+
+```bash
+./setup.sh \
+  --base-url https://ollama.com \
+  --api-key "$OLLAMA_API_KEY" \
+  --model deepseek-v4-flash \
+  --worker-memory 2g \
+  --engine-memory 512m \
+  --worker-cpus 2 \
+  --engine-cpus 1 \
+  --data-dir /srv/agentmemory/home \
+  --iii-data-dir /srv/agentmemory/iii
+```
+
+## Verify
+
+```bash
+docker compose -f /opt/agentmemory/docker-compose.yml ps
+curl http://127.0.0.1:3111/agentmemory/livez
+```
+
+With Caddy:
+
+```bash
+jq -r .password /opt/agentmemory/credentials.json
+```
+
+Then open the configured domain and sign in as `admin`.